こんにちは。大規模開発の現場で、一度は「Docker Hubのレート制限（Pull Limit）」に泣かされた経験はありませんか？
CI/CDパイプラインを回そうとした瞬間、エラーで停止。「またか！」と頭を抱えるあの時間は、エンジニアにとって最も生産性の低い瞬間ですよね。今日は、GitLabの知る人ぞ知る強力な機能「Dependency Proxy」を使って、その悪夢から永久に解放される方法を伝授します。
これは単なる「設定の手順」ではありません。あなたのチームのCI/CDを、より堅牢でプロフェッショナルなものへと進化させるための「守りの要」の作り方です。
—
なぜ今、「Dependency Proxy」なのか？
Docker Hubは非常に便利なプラットフォームですが、無制限に無料で利用できるわけではありません。特にCI/CDで頻繁にイメージをプルしていると、あっという間に制限に達してしまいます。
GitLabの Dependency Proxy は、一言で言えば「Dockerイメージ専用のインテリジェントなキャッシュサーバー」です。
1. レート制限の回避: GitLab経由でプルすることで、Docker Hubへの直接アクセスを最小限に抑えます。
2. ビルドの高速化: GitLabの内部ネットワーク内にキャッシュされるため、プル速度が劇的に向上します。
3. 可用性の向上: Docker Hubが一時的に不安定でも、キャッシュがあればビルドは止まりません。
—
ステップ1：Dependency Proxyを有効化する
まずは「箱」を用意しましょう。設定は驚くほど簡単ですが、ここが全ての起点です。
1. GitLabの左サイドバーから [設定 (Settings)] > [パッケージとレジストリ (Packages & Registries)] を開きます。
2. [Dependency Proxy] の項目を展開し、[有効 (Enable)] にチェックを入れます。
これだけで、あなたのGitLabインスタンス内に「専用のプロキシエンドポイント」が誕生しました。
—
ステップ2：CI/CDパイプラインでの実践的実装
さあ、ここからが本番です。` .gitlab-ci.yml` を書き換えて、Docker Hubのイメージをプロキシ経由で取得するように設定します。
.gitlab-ci.yml
variables:
# CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX はGitLabが自動提供する環境変数
# 例: gitlab.example.com:443/グループ名/dependency_proxy/containers/
DOCKER_IMAGE: ${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/library/alpine:latest
stages:
- build
build_job:
stage: build
image: docker:24.0.5
services:
- docker:24.0.5-dind
script:
# ログインすることで、プロキシ機能経由でDocker Hubからプルされる
- echo “$CI_DEPENDENCY_PROXY_PASSWORD” | docker login $CI_DEPENDENCY_PROXY_SERVER -u $CI_DEPENDENCY_PROXY_USER –password-stdin
# プロキシ経由でイメージをプル
- docker pull $DOCKER_IMAGE
# あとは通常通りビルドするだけ
- docker tag $DOCKER_IMAGE my-app:latest
- docker build -t my-app:latest .
ここで重要な「ハック」
上記の `${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}` は魔法の変数です。`library/alpine` と指定することで、GitLabは自動的に「Docker Hubの公式イメージ」を探しに行き、初回はプルしてキャッシュ、次回からはキャッシュから配信します。
—
ステップ3：動作確認（Hello World的アプローチ）
本当にキャッシュされているのか不安ですよね？以下のコマンドをCI上で実行してみると、その真価がわかります。
キャッシュの挙動を確認する簡単なスクリプト
- echo “イメージのプルを開始…”
- time docker pull $DOCKER_IMAGE
二回目に実行すると、時間が圧倒的に短縮されるのが確認できるはずです
- echo “二回目のプル（キャッシュ確認）…”
- time docker pull $DOCKER_IMAGE
初回と二回目の `time` を見比べてみてください。ネットワークレイテンシが消え去り、驚くほどの速さでイメージが取得できるはずです。
—
先輩エンジニアからのアドバイス：運用の極意
Dependency Proxyを使いこなす上で、これだけは覚えておいてください。
- 「library」プレフィックスを忘れない: Docker Hubの公式イメージ（alpine, node, python等）を呼ぶときは、URLの構造上 `library/` を含めるのを忘れないでください。
- クリーンアップ戦略: キャッシュは無限に増え続けるとストレージを圧迫します。GitLabの「パッケージ保持ポリシー」を設定し、古いイメージを自動削除する設定を併用するのが、プロフェッショナルな管理術です。
- 認証の自動化: CI/CDパイプライン内では、`CI_DEPENDENCY_PROXY_USER` と `CI_DEPENDENCY_PROXY_PASSWORD` が自動発行されます。これらは非常に強力な認証情報なので、直書きせず必ず環境変数を利用してください。
まとめ：開発体験を加速させるために
Dependency Proxyを導入することは、単に「エラーを消す」ことではありません。「インフラの制約から開発チームを解放し、本来のクリエイティブな作業に集中させる環境」を構築することです。
ビルド待ちのイライラから解放され、より速く、より安定したデリバリーを実現してください。あなたのコードが、GitLabの力でよりスムーズに世界へ届くことを応援しています！
もし設定でつまづいたり、「もっと高度なキャッシュ戦略が知りたい！」ということがあれば、いつでも聞いてくださいね。一緒に最高のパイプラインを作り上げましょう。