GoコードをGitHubに依存させない
Don't couple your Go code to GitHub (iain.rocks)
要約
Go言語のデフォルトのインポートパスは、コードのホスティング場所と結びついているため、GitHubのような特定のプロバイダーにコードが強く依存してしまう問題があります。この依存関係は、ホスティングサービスを変更する際の大きな障害となり、コスト増加にもつながりかねません。解決策として、カスタムドメインを使用することで、ホスティングプロバイダーの変更に柔軟に対応できるようになります。
全文翻訳
GitHubにGoコードを依存させない
Iain Cambridge
2026年9月27日
Goの優れた機能の一つに、コードを取得する場所でコードの名前空間を定義できる点があります。これは、Goコードをhttp://github.com/thetrueares/bonecloneでホストしている場合、import “github.com/thetrueares/boneclone”という行になり、Goはgitを使用してそれを取得します。これにより、オープンソースライブラリのバグ報告先を簡単に特定でき、中央集権的なパッケージ管理システムなしでGoライブラリを取得・配布するのが非常に容易になります。多くの人にとって、これは文字通りgitホスティングの場所そのものですが、これにはいくつかの欠点があり、独自のカスタムドメインを使用すべきだと私は説明します。
問題
gitホスティングの場所を直接使用する主な問題は、コードがホスティングプロバイダーに結合されてしまうことです。つまり、gitホスティングをGitLabに移行する場合、コードを変更しなければなりません!さもなければ、古いバージョンを取得してしまうことになります。これにより、切り替えのオーバーヘッドの大きさから、gitホスティングプロバイダーを変更できなくなる可能性があります。結果として、コードは文字通りGitHubに結合されてしまいます。これはまったく馬鹿げているように聞こえますが、Goコミュニティでは事実上の標準となっています。
私はこの問題が、GitLab、GitHub、Azure DevOpsを同時に使用していたある企業にとって、非常に大きな問題になったのを見てきました。コードの場所を変更する作業は彼らにとって非常に大きなタスクであり、「時間がなかった」ため、3つのプラットフォームで運用する方が簡単でした。だからこそ、私はBonecloneを構築し、複数のgitホスティングプラットフォーム間でスケルトンコードのレプリケーションを同時に処理できるようにしました。この問題は、企業に同時に3つのホスティングサービスに料金を支払わせるという形で、文字通りコストを発生させました。
解決策
解決策は、go.iain.rocks、go.uber.org、go.mongodb.orgなどのカスタムドメインを使用することです。これにより、これらのドメインが指す場所を変更するだけで済みます。例えば、go.iain.rocks/bonecloneはgithub.com/thetrueares/bonecloneを指すようになり、もし私がGitLabに移行しても、エンドユーザーにとっては何も変わらず、インストールコマンドも同じです。
私の意見では、Goを使用するすべての商用ソフトウェア開発チームは、内部ライブラリやパッケージの名前空間にカスタムドメインを使用すべきです。これは、無駄な依存関係を回避する簡単な方法です。
以下に、私の設定のコピーを示します。これにより、あなたも自分のプロジェクトで設定できます。
Nginx.conf
server {
server_name go.iain.rocks;
root /var/www/go.iain.rocks;
index index.html;
location / {
# クエリ文字列に 'go-get=1' が含まれていないかチェックします。
# '~' は大文字小文字を区別するマッチングを意味します。
if ($args !~ go-get=1) {
# これは人間訪問者です。GitHubへの恒久的なリダイレクトを発行します。
# $request_uri はパスになります。例: /boneclone
return 301 https://github.com/that-guy-iain$request_uri;
}
# Goツール(?go-get=1付き)の場合は、以前と同様にHTMLファイルを配信します。
try_files $uri $uri/ =404;
}
# --- CertbotからのSSL設定はここに残しておいてください ---
listen 443 ssl;
listen [::]:443 ssl;
ssl_certificate /etc/letsencrypt/live/go.iain.rocks/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/go.iain.rocks/privkey.pem;
include /etc/letsencrypt/options-ssl-nginx.conf;
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
}
# HTTPからHTTPSへのリダイレクトブロックも残しておいてください。
server {
listen 80;
listen [::]:80;
server_name go.iain.rocks;
return 301 https://$host$request_uri;
}
index.html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="go-import" content="go.iain.rocks/boneclone git https://github.com/that-guy-iain/boneclone">
<meta name="go-source" content="go.iain.rocks/boneclone https://github.com/that-guy-iain/boneclone https://github.com/that-guy-iain/boneclone/tree/master{/dir} https://github.com/that-guy-iain/boneclone/blob/master{/dir}/{file}#L{line}">
</head>
<body>
</body>
</html>