Docker Hub完全ガイド｜パブリック/プライベートリポジトリと自動ビルド

ここまで docker pull nginx や docker pull postgres:16 で公式イメージを取得してきました。その取得先が Docker Hub——世界最大のコンテナイメージレジストリです。第7章ではレジストリの世界に入り、自分のイメージをpush して他人と共有する方法を学びます。

目次

1. レジストリとは
2. Docker Hub のイメージ階層
3. アカウント作成と login
4. 自分のイメージを push する
5. パブリック vs プライベートリポジトリ
6. GitHub 連携の自動ビルド
7. 無料プランの Pull Rate Limit
8. まとめ

1. レジストリとは

レジストリは「コンテナイメージの置き場・配布所」。Git で言うなら GitHub に相当する存在です。

Docker Hub は Docker社が運営するパブリックレジストリの代表。他にも：

• GitHub Container Registry（ghcr.io）
• Amazon ECR（*.dkr.ecr.region.amazonaws.com）
• Google Artifact Registry（*-docker.pkg.dev）
• Harbor（自前ホスト型）

などが存在します（比較は 7-5 で）。

2. Docker Hub のイメージ階層

3. アカウント作成と login

3-1. アカウント作成

1. hub.docker.com/signup でサインアップ
2. メール認証を済ませる
3. Docker ID（= ユーザー名）が決まる。これがイメージ名の名前空間になる

3-2. CLI から login

$ docker login
Username: yourid
Password: ********
Login Succeeded

# 認証情報はここに保存される
# ~/.docker/config.json

4. 自分のイメージを push する

4-1. イメージを作る

# Dockerfile
FROM nginx:1.27
COPY index.html /usr/share/nginx/html/index.html

$ docker build -t myid/my-nginx:1.0 .

4-2. タグの命名規則

Docker Hub に push できるイメージ名は <Docker ID>/<repo>:<tag> という形式です。

4-3. push

$ docker push myid/my-nginx:1.0
The push refers to repository [docker.io/myid/my-nginx]
abc123: Pushed
def456: Layer already exists
1.0: digest: sha256:... size: 1234

4-4. 他のPCから pull して動作確認

$ docker pull myid/my-nginx:1.0
$ docker run -d -p 8080:80 myid/my-nginx:1.0
# → ブラウザで http://localhost:8080 → 自作のindex.htmlが出る

5. パブリック vs プライベートリポジトリ

プライベートリポジトリの作成

1. Docker Hub ウェブで「Create Repository」
2. Visibility で Private を選択
3. 通常通り docker push で push
4. pull する側は docker login 必須

6. GitHub 連携の自動ビルド

Docker Hub は GitHub/Bitbucket と連携して、push したらイメージを自動でビルド→Hub に自動公開する仕組みを提供します（Build plan 以上の有料機能）。

1. Hub 上で「Automated Build」を有効化
2. GitHub リポジトリを接続
3. ビルドルールを設定（どのブランチ・タグをどんなイメージタグでビルドするか）

7. 無料プランの Pull Rate Limit

Docker Hub は無料プランで pull 回数が制限されています（2020年11月から）。知らないと本番やCIで突然エラーになります。

8. まとめ

参考リンク

• Docker Hub — レジストリ本家。
• Docker Hub 公式ドキュメント — アカウント・課金・自動ビルド等の一次情報源。
• Pull rate limit（公式） — レート制限の仕様と回避法。

Dockerの基礎を動画で体系的に学びませんか？

実務で使う基礎だけを3時間に凝縮。環境構築から丁寧に解説しています。

クーポン割引で講座を見る →