1. 導入
Go言語で開発を行う際、社内サーバーやプライベートリポジトリにあるモジュールをインポートしようとして、Goコマンドがパブリックなプロキシ（proxy.golang.org）にアクセスし、404エラーで失敗した経験はありませんか？GOPRIVATE環境変数を適切に設定することで、特定のドメインへのアクセスをプロキシ経由ではなく直接通信させることが可能です。本稿では、複数のプライベートドメインを効率的に管理する方法を解説します。
2. 基礎知識
Goはデフォルトで、モジュールのダウンロードにGoプロキシを利用します。しかし、社内専用のライブラリや認証が必要なプライベートリポジトリは、パブリックなプロキシからアクセスできません。ここで登場するのがGOPRIVATEです。この変数を設定することで、Goコマンドに対して「このドメイン以下のモジュールはプロキシを通さず、直接取得せよ」という指示を出すことができます。これにより、認証のトラブルや社外秘コードの流出リスクを回避します。
3. 実装/解決策
GOPRIVATEには、単一のドメインだけでなく、カンマ区切りで複数のパスを指定することができます。また、globパターン（ワイルドカード）を利用することで、特定の組織内の全リポジトリを一括で対象に含めることが可能です。
設定は環境変数で行います。シェルの設定ファイル（.bashrcや.zshrcなど）に以下を追記してください。
4. サンプルプログラム
以下は、GOPRIVATEを設定した状態で、モジュール解決の挙動を確認するための概念的なコード例です。
// 実行環境で GOPRIVATE=”github.com/my-corp/,gitlab.internal.com” のように設定します。
// これにより、以下のインポートパスはプロキシをバイパスします。
package main
import (
“fmt”
// 社内GitLabのプライベートライブラリを直接参照
“gitlab.internal.com/team/auth”
// 社内GitHub組織のライブラリを直接参照
“github.com/my-corp/utils”
)
func main() {
// 正常にパッケージが解決されていれば、以下のように利用可能です
fmt.Println(“社内モジュールが正常に読み込まれました”)
// サンプルとしての呼び出し
// auth.Login()
// utils.FormatDate()
}
5. 応用・注意点
注意点1：GONOPROXYとGONOSUMDBとの関係性
GOPRIVATEを設定すると、自動的にGONOPROXYとGONOSUMDBにも同じ値が適用されます。個別に制御したい場合は、これらの変数を個別に上書きしてください。
注意点2：認証設定
GOPRIVATEを設定しても、リポジトリへのアクセス権限がないと取得は失敗します。Gitの認証設定（.gitconfigでのurl.insteadOf設定や、SSH鍵の設定）と組み合わせて利用することが現場での基本となります。
注意点3：CI/CD環境での設定
開発者のローカル環境だけでなく、GitHub ActionsやJenkinsなどのCI/CDパイプライン上でも同様のGOPRIVATE設定を忘れないようにしましょう。これを怠ると、ビルド時にのみプライベートモジュールが取得できないというトラブルが発生しやすくなります。
コメント