自分たちで開発した Docker コンテナをイントラネット内で使ってもらうために、Docker Registry を構築しました。構築時、proxyでハマったので簡単に手順を残します。
OS は CentOS7.7 を使用します。この構築手順は OS のインストール直後を想定しています。また、証明書や認証の設定については、省略させていただきます。
Docker Registry とは
社内のみで Docker イメージを登録、取得したいケースがあります。このような場合、Dockerイメージが大量に保存されている Docker Hub を利用するのではなく、社内用のDockerイメージの保管庫が必要になります。Docker Registry は、Docker イメージを保存しておいて、提供するサービスです。Docker Registry を 利用することで、社内で Docker イメージの登録（docker push）、取得（docker pull）が可能になります。
Docker Registry も Docker イメージとして、Docker Hub に登録されていて、取得（docker pull）して、それを使ってコンテナを起動させることで、Docker Registry を構築することができます。
詳細は公式サイト Docker Registry で紹介しています。
Docker のインストール
Docker Registry をインストールする前に、まず、Docker をインストールします。
各種設定
yum に proxy の設定を追加するために /etc/yum.conf を編集します。
$ sudo vi /etc/yum.conf
以下を yum.conf に追加します。proxy の利用に認証が必要な場合、proxy_username, proxy_passwird も追加して下さい。今回は省略します。
proxy=http://<proxy_host>:<proxy_port>
デフォルトのリポジトリ設定では、yum 実行時にタイムアウトになる可能性がありますので、/etc/yum.repos.d/CentOS-Base.repo を編集します。
$ sudo vi /etc/yum.repos.d/CentOS-Base.repo
[base], [update], [extras], [centosplus] の baseurl を以下のように置き換えます。
[base]
baseurl=http://ftp.riken.jp/Linux/centos/$releasever/os/$basearch/
[updates]
baseurl=http://ftp.riken.jp/Linux/centos/$releasever/updates/$basearch/
[extras]
baseurl=http://ftp.riken.jp/Linux/centos/$releasever/extras/$basearch/
[centosplus]
baseurl=http://ftp.riken.jp/Linux/centos/$releasever/centosplus/$basearch/
yum update を実行して、各パッケージを最新にします。
$ sudo yum update
Docker のインストール
公式な手順 Get Docker Engine - Community for CentOS に従って、以下のようにDockerのインストールを進めます。
古いバージョンの Docker パッケージをアンインストールします。
$ sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine
Docker のインストールに必要な yum-utils, device-mapper-persistent-data, lvm2 パッケージをインストールします。
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
Docker インストール用リポジトリを yum に追加します。
$ sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
リポジトリーの構成を表示して、docker-ce-stable が含まれていれば問題ありません。
$ sudo yum repolist
読み込んだプラグイン:fastestmirror, langpacks
Loading mirror speeds from cached hostfile
repo ID repo name status
base/7/x86_64 CentOS-7 - Base 10,097
docker-ce-stable/x86_64 Docker CE Stable - x86_64 61
extras/7/x86_64 CentOS-7 - Extras 305
updates/7/x86_64 CentOS-7 - Updates 711
Docker をインストールします。
$ sudo yum install docker-ce docker-ce-cli containerd.io
docker -v で Docker がインストールされたか確認できます。
$ sudo docker -v
Docker version 19.03.4, build 9013bf583a
Docker を起動します。
$ sudo systemctl start docker
以下で Docker の起動を確認します。エラーが出力されなければ、Docker は起動されています。
$ sudo docker search hello-world
Docker の設定
sudo を使用しなくても Docker が使用できるように、現在のユーザーを docker グループに追加します（docker グループは、Docker インストール後、追加されている）。
$ sudo usermod -aG docker $USER
docker のプロキシを設定します。詳細は公式サイトの Control Docker with systemd に記述されています。
$ sudo mkdir -p /etc/systemd/system/docker.service.d
$ sudo vi /etc/systemd/system/docker.service.d/http-proxy.conf
以下のように、http-proxy.conf に proxy の情報を記述します。
[Service]
Environment="HTTP_PROXY=http://<proxy_host>:<proxy_port>" "HTTPS_PROXY=http://<proxy_host>:<proxy_port>" "NO_PROXY=localhost,127.0.0.1"
設定を反映して、Docker を再起動します。
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker
docker info で proxy が設定されたか確認ができます。最後の方で以下のように表示されます。
$ docker info
HTTP Proxy: http://<proxy_host>:<proxy_port>
HTTPS Proxy: http://<proxy_host>:<proxy_port>
No Proxy: localhost, 127.0.0.1
以下で、OS 起動時に Docker を自動起動にします。詳細は公式サイトの Configure Docker to start on boot に記述されています。
$ sudo systemctl enable docker
Docker Registry の構築
インストールした Docker を用いて、Docker Registory を構築していきます。
イメージの取得
はじめに、Docker Registry イメージの確認をします。
$ docker search registry
docker pull で Docker Registry イメージを取得します。
$ docker pull registry
Using default tag: latest
latest: Pulling from library/registry
c87736221ed0: Pull complete
1cc8e0bb44df: Pull complete
54d33bcb37f5: Pull complete
e8afc091c171: Pull complete
b4541f6d3db6: Pull complete
Digest: sha256:8004747f1e8cd820a148fb7499d71a76d45ff66bac6a29129bfdbfdc0154d146
Status: Downloaded newer image for registry:latest
docker.io/library/registry:latest
docker images で registry イメージが取得できていることを確認します。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
registry latest f32a97de94e1 8 months ago 25.8MB
コンテナの起動
ホスト側に、push されたイメージを保存するために以下のディレクトリを作成します。
/root/docker/registry/
取得した registry イメージをもとに Docker Registry 用のコンテナを docker run で起動します。ポートは5000番を使用します。
$ docker run -d -p 5000:5000 registry
$ docker run -d -p 5000:5000 -v /root/docker/registry/data:/var/lib/registry --restart=always --name registry01 registry:latest
docker ps で Docker Registry コンテナが動作していることを確認します。
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
091ea25e90fe registry:latest "/entrypoint.sh /etc…" 8 seconds ago Up 25 hours 0.0.0.0:5000->5000/tcp registry01
他 Docker Client から Docker Registry コンテナにアクセス
各種設定
他の環境で、前述と同じように [Dockerのインストール](# Docker のインストール)を行います。
以下のように、http-proxy.conf の NO_PROXYに Docker Registry のIPアドレスまたはサーバ名を記述します。
[Service]
Environment="HTTP_PROXY=http://<proxy_host>:<proxy_port>" "HTTPS_PROXY=http://<proxy_host>:<proxy_port>" "NO_PROXY=localhost,127.0.0.1,<registry_host>"
insecure registry の設定
Registry が暗号化されていないhttp通信の場合は、insecure registry にその Registry を登録しないと、Dockerイメージをpullすることができないので、設定します。
$ sudo vi /etc/docker/daemon.json
/etc/docker/daemon.json に以下を追加します。
{ "insecure-registries":["<registry_host>:<registry_port>"] }
設定を反映して、Docker を再起動します。
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker
イメージの登録
まず、 Docker Registry に登録するイメージを準備する。今回は確認のために hello-world イメージを docker pull します。
$ docker pull hello-world
イメージを Docker Registry に登録するために、hello-world イメージにタグを付けます。
$ docker tag hello-world <registry_host>:5000/hello-world
docker images で <registry_host>:5000/hello-world が作成されていることを確認します。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest fce289e99eb9 10 months ago 1.84kB
<registry_host>:5000/hello-world latest fce289e99eb9 10 months ago 1.84kB
docker push で <registry_host>:5000/hello-world イメージを Docker Registry に登録します。
$ docker push <registry_host>:5000/hello-world
The push refers to repository [<registry_host>:5000/hello-world]
af0b15c8625b: Pushed
latest: digest: sha256:92c7f9c92844bbbb5d0a101b22f7c2a7949e40f8ea90c8b3bc396879d95e899a size: 524
イメージの取得
Docker Registry からイメージの取得する前に、確認のため、ローカルのイメージを削除します。
$ docker rmi <registry_host>:5000/hello-world
docker images で <registry_host>:5000/hello-world が削除されていることを確認します。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest fce289e99eb9 10 months ago 1.84kB
docker pull で <registry_host>:5000/hello-world イメージを Docker Registry から取得します。
$ docker pull <registry_host>:5000/hello-world
Using default tag: latest
latest: Pulling from hello-world
Digest: sha256:92c7f9c92844bbbb5d0a101b22f7c2a7949e40f8ea90c8b3bc396879d95e899a
Status: Downloaded newer image for <registry_host>:5000/hello-world:latest
docker images で <registry_host>:5000/hello-world が取得されていることを確認します。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest fce289e99eb9 10 months ago 1.84kB
<registry_host>:5000/hello-world latest fce289e99eb9 10 months ago 1.84kB
registry のイメージ一覧の取得
以下の方法で registry のイメージ一覧を取得できます。
$ curl --noproxy <registry_host> http://<registry_host>:5000/v2/_catalog
{"repositories":["hello-world"]}
まとめ
Docker Registry も Docker イメージとして、Docker Hub に登録されていて、取得して、それを使ってコンテナを起動させることで、Docker Registry を構築することができました。Docker Registry コンテナをイントラネット内で使用するためには、proxyの設定が不可欠です。proxy 設定と proxy を使わない設定を正しくできると動作まで辿り着けます。
もし、記述について誤りがあったり、気になることがあれば、編集リクエストやコメントでフィードバックしていただけると助かります。
参考
Docker 公式サイト他に以下の記事を参考にさせていただきました。