CentOS Stream 10

Docker : Docker-Registry を利用する2025/08/08

 

Docker-Registry をインストールして、Docker イメージのプライベートレジストリサーバーを構築します。

[1] Registry イメージを Pull して起動します。
Registry コンテナーでは、イメージは [/var/lib/regstry] 配下に保管されるため、
該当領域を永続化させるために、ホスト側の [/var/lib/docker/registry] をマウントして利用するよう設定します。
[root@dlp ~]#
docker pull registry

[root@dlp ~]#
mkdir /var/lib/docker/registry

[root@dlp ~]#
docker run -d -p 5000:5000 \
-v /var/lib/docker/registry:/var/lib/registry \
registry
1f32cbc393d726b5f9b9ccd71216a17d6e759ef8a98ebc522df7739d48833bd6

[root@dlp ~]#
docker ps

CONTAINER ID   IMAGE      COMMAND                  CREATED          STATUS          PORTS                                         NAMES
1f32cbc393d7   registry   "/entrypoint.sh /etc…"   15 seconds ago   Up 15 seconds   0.0.0.0:5000->5000/tcp, [::]:5000->5000/tcp   serene_haslett

# Firewalld 稼働中の場合はポート許可

[root@dlp ~]#
firewall-cmd --add-port=5000/tcp

[root@dlp ~]#
firewall-cmd --runtime-to-permanent
# Docker クライアントホストから Registry を利用する場合はクライアント側の設定変更

[root@client ~]#
vi /etc/docker/daemon.json
# 新規作成 または 追記
# HTTP 通信を許可するホストを追加 (デフォルトは HTTPS)

{
  "insecure-registries":
    [
      "docker.internal:5000",
      "dlp.srv.world:5000"
    ]
}

[root@client ~]#
systemctl restart docker
# タグ付けして Registry に Push

[root@client ~]#
docker images

REPOSITORY               TAG        IMAGE ID       CREATED          SIZE
root-web                 latest     5bc6e8e3f1a9   13 minutes ago   345MB
srv.world/centos-httpd   latest     134889cd315b   38 minutes ago   351MB
srv.world/centos-nginx   latest     b587aa926cbf   46 minutes ago   345MB
quay.io/centos/centos    stream10   02ae49ff109e   7 weeks ago      306MB

[root@client ~]#
docker tag quay.io/centos/centos:stream10 dlp.srv.world:5000/centos:stream10

[root@client ~]#
docker push dlp.srv.world:5000/centos:stream10

[root@client ~]#
docker images

REPOSITORY                  TAG        IMAGE ID       CREATED          SIZE
root-web                    latest     5bc6e8e3f1a9   14 minutes ago   345MB
srv.world/centos-httpd      latest     134889cd315b   39 minutes ago   351MB
srv.world/centos-nginx      latest     b587aa926cbf   47 minutes ago   345MB
dlp.srv.world:5000/centos   stream10   02ae49ff109e   7 weeks ago      306MB
quay.io/centos/centos       stream10   02ae49ff109e   7 weeks ago      306MB
[2] Basic 認証を有効にする場合は以下のように設定します。
[root@dlp ~]#
dnf -y install httpd-tools
# Registry 認証用に任意のユーザーを登録

[root@dlp ~]#
htpasswd -Bc /etc/containers/.htpasswd cent

New password:
Re-type new password:
Adding password for user cent

[root@dlp ~]#
docker run --privileged -d -p 5000:5000 \
-v /var/lib/docker/registry:/var/lib/registry \
-v /etc/containers:/auth \
-e REGISTRY_AUTH=htpasswd \
-e REGISTRY_AUTH_HTPASSWD_PATH=/auth/.htpasswd \
-e REGISTRY_AUTH_HTPASSWD_REALM="Registry Realm" \
registry
# クライアントホストで登録したユーザーで認証してログイン

[root@client ~]#
docker login dlp.srv.world:5000 --tls-verify=false

Username: cent
Password:

WARNING! Your credentials are stored unencrypted in '/root/.docker/config.json'.
Configure a credential helper to remove this warning. See
https://docs.docker.com/go/credential-store/

Login Succeeded

[root@client ~]#
docker tag quay.io/centos/centos:stream10 dlp.srv.world:5000/centos:stream10

[root@client ~]#
docker push dlp.srv.world:5000/centos:stream10

[root@client ~]#
docker images

REPOSITORY                  TAG        IMAGE ID       CREATED          SIZE
root-web                    latest     5bc6e8e3f1a9   20 minutes ago   345MB
srv.world/centos-httpd      latest     134889cd315b   45 minutes ago   351MB
srv.world/centos-nginx      latest     b587aa926cbf   54 minutes ago   345MB
dlp.srv.world:5000/centos   stream10   02ae49ff109e   7 weeks ago      306MB
quay.io/centos/centos       stream10   02ae49ff109e   7 weeks ago      306MB
[3] Let's Encrypt 等の正規の証明書で、デフォルトの HTTPS で通信する場合の設定です。
証明書はリンク先の通り [/etc/letsencrypt] 配下に取得している場合の例です。
[root@dlp ~]#
docker run --privileged -d -p 5000:5000 \
-e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/fullchain.pem \
-e REGISTRY_HTTP_TLS_KEY=/certs/privkey.pem \
-v /etc/letsencrypt/live/dlp.srv.world:/certs \
-v /var/lib/docker/registry:/var/lib/registry \
registry
# 正規の証明書で HTTPS の場合はデフォルト設定で利用可

[root@client ~]#
docker tag quay.io/centos/centos:stream10 dlp.srv.world:5000/centos:stream10

[root@client ~]#
docker push dlp.srv.world:5000/centos:stream10

[root@client ~]#
docker images

REPOSITORY                  TAG        IMAGE ID       CREATED          SIZE
root-web                    latest     5bc6e8e3f1a9   23 minutes ago   345MB
srv.world/centos-httpd      latest     134889cd315b   48 minutes ago   351MB
srv.world/centos-nginx      latest     b587aa926cbf   56 minutes ago   345MB
dlp.srv.world:5000/centos   stream10   02ae49ff109e   7 weeks ago      306MB
quay.io/centos/centos       stream10   02ae49ff109e   7 weeks ago      306MB
関連コンテンツ