Docker Hub のミラーリング¶

あるいは¶

あるいは、頻繁に使うイメージ群がありませんでしょうか。単純にそれをローカル上のプライベートなレジストリから取得することも可能です。

それ以外にも、イメージは Docker Hub にあるものではなく、全てが自家製の場合もあるでしょう。そのような場合、単純にローカルにあるレジストリでイメージを管理したいと思いませんか。これが最も簡単なシナリオです。

捕捉¶

現時点では、特定のプライベート・レジストリをミラーする機能がありません。Docker Hub のみミラー可能です。

解決策¶

レジストリは pull （イメージの取得）時、キャッシュするように設定可能です。このモードでは Registry は通常の全ての docker pull に応答し、全てのイメージをローカルに保管します。

Docker Hub のイメージ内容が変わったら？¶

イメージの pull 時にタグを付けると、Registry はリモートの Docker Hub 上の最新版と内容が一致するかどうか確認します。もし一致しなければ、最新版の内容を取得し、ローカルにキャッシュします。

ディスクはどうですか？¶

利用頻度が高い環境では、古いデータがキャッシュとして残り続けるかもしれません。Registry にキャッシュしているデータを取得して利用している場合、ディスク容量を節約するため、定期的に古いデータを削除したほうが良いでしょう。キャッシュしているデータを消したとしても、またリクエストがあればリモートから取得し、再度キャッシュ化します。

Registry のベストなパフォーマンスやキャッシュの正常性を確保するには、ストレージに filesystem ドライバを使うべきでしょう。

キャッシュの設定¶

Registry が取得（pull）する時、キャッシュを通すように設定します。設定ファイルに proxy セクションを追加する必要があります。

Docker Hub のプライベート・イメージにアクセスが必要であれば、ユーザ名とパスワードも指定できます。

proxy:
  remoteurl: https://registry-1.docker.io
  username: [username]
  password: [password]

Docker デーモン・オプションの設定¶

Docker デーモンの起動時に --registry-mirror オプションを指定する必要があります。

docker --registry-mirror=https://<my-docker-mirror-host> daemon

例えば、 http://10.0.0.2:5000 をミラーとして使いたい場合は、次のように実行します。

docker --registry-mirror=https://10.0.0.2:5000 daemon