そのイメージはVMの中にしかない — レジストリを立てる

レジストリを立てる。コンテナの箱を収めた棚と二台の端末、アップロードとダウンロードの矢印。

ビルドしたイメージは、そのVMの中にしかありません。自分でレジストリを立てて、保管して配れる形にします。

前回: Kubernetesは重すぎた — Swarmという選択肢

はじめに のカリキュラムでは 第6段階「運用する」 にあたります。

作業場所は VM の中(Ubuntu Server)です。 Windows 側では何もしません。

始める前に、VMのスナップショットを取ってください。 この記事は Docker の設定ファイルを1つ触ります。戻し方は「後片づけ」に全部書きます。

GitHub Actions の回で、push のたびにテストが走るようにしました。Docker の回では、イメージを pull して動かしました。

ここで、ひとつ質問をします。

あなたがビルドしたイメージは、いま、どこにありますか。

docker images で出てくるので「ある」と答えたくなります。では、それは「どこ」ですか。

答えは 「そのマシンのディスクの中だけ」 です。VMの中でビルドしたなら、そのVMの中にしかありません。

これが何を意味するか、はっきり書きます。

  • 別のサーバーでは動かせません。 相手のマシンにそのイメージが無いからです
  • CI でビルドしたものは、ジョブが終わった瞬間に消えます。 GitHub Actions のランナーは使い捨てです
  • VMを消したら、消えます。 Kubernetes の回で minikube delete を打ったときと同じです
  • 「動いたはずのあれ」を、あとから取り出せません

つまり、ビルドは終わっているのに、まだ何も届いていないのです。CI は「確かめる」ところまではやりました。確かめたものを、どこかに置いて、別の場所から取れるようにする。 そこが丸ごと抜けています。

その置き場のことを レジストリ、もっと広くは アーティファクトリポジトリ と呼びます。

この記事では、それを自分のVMに1つ立てます。 会社でよく使われる Nexus や Artifactory は立てません。理由は後で書きますが、一言で言えば 重すぎるからです。代わりに Docker 公式の registry イメージを使います。中身の考え方は同じで、こちらは数十MBで動きます。


対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • ビルドした結果(成果物)は、ソースコードとは別物で、Git には置かないこと。だから別の置き場が要ること
  • docker push の宛先は、タグの中に書いてあること。docker tag は名前を変える作業ではなく、行き先を決める作業だということ
  • レジストリは https でないと拒否されること。そして localhost だけが例外であること。なぜそうなっているのか
  • latest は「最新」という意味ではないこと。ただのタグ名で、中身は黙って入れ替わること
  • 会社が Nexus や Artifactory を立てる理由は「置き場が欲しいから」だけではないこと。外に出られない・遅い・社内のものを配りたい・何を使ったか記録したいの4つ
  • 依存を取ってくる先を、私たちは信頼していること。その信頼を確かめる道具に cosign と SBOM という名前があること
  • 古いイメージは黙って溜まること。ディスクは自動では空かないこと
  • 個人開発でここまで要らないこと。GHCR か Docker Hub で足りること

この記事でやること

  1. 成果物の種類を整理する。 コンテナイメージだけの話ではないと分かるところまで
  2. 自分のVMにプライベートレジストリを立てる。 registry:3 を 127.0.0.1 に縛って起動する
  3. 小さいイメージをビルドし、タグを付け直して push する。 そのあとローカルから消して、pull で取り戻す
  4. わざと https の拒否を起こす。 エラーメッセージを読んで、逃げ方と、本番でやってはいけない理由を確かめる
  5. タグの付け方を決める。 latest をやめて、バージョンとコミットハッシュにする
  6. docker system df でディスクを見る。 溜まったものを掃除する
  7. 後片づけして、元の状態に戻す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
成果物(アーティファクト)ソースをビルドして出てきた、配れる形のもの。イメージ・zip・jar など
レジストリコンテナイメージの置き場。docker push / docker pull の相手
リポジトリレジストリの中の、1つの名前のまとまり。myapp の中に 1.0 1.1 … が並ぶ
タグリポジトリの中の1つの版につけた名札。myapp:1.0 の 1.0 の部分
プライベートレジストリ社内や自分だけが使うレジストリ。公開されていない
プロキシリポジトリ外部のレジストリの代理。一度取ったものを溜めておいて、次からは自分が返す
イミュータブル一度置いたら書き換えないという性質。「1.0 は永久に同じ中身」
サプライチェーンソフトが手元に届くまでの経路全部。依存・ビルド・配布を含む
SBOMSoftware Bill of Materials。中に何が入っているかの部品表
署名「これは確かに私が作ったもので、途中で書き換えられていない」を数学的に示す仕組み
ガベージコレクションレジストリ側でもう誰も指していないデータを消す掃除処理

① 成果物とは何か — ソースではなく、ビルドした結果

まず、言葉をはっきりさせます。

何かどこに置くか
ソースコード人が書いたもの。.js .ts DockerfileGit(GitHub)
成果物(アーティファクト)それをビルドして出てきたもの。人は書いていないレジストリ / アーティファクトリポジトリ

この2つを同じ場所に置いてはいけません。

理由は3つあります。

  1. 成果物は再生成できる。 ソースとビルド手順があれば作り直せます。バックアップの価値が違います
  2. 成果物はでかい。 dist/ の回で見たとおり、ビルド結果は元より大きくなることがあります。Git は大きいバイナリが極端に苦手です(差分が取れないので、履歴に全部が積み上がる)
  3. 成果物は「誰が作ったか」が問われる。 ソースは読めば分かりますが、イメージの中身は開けないと分かりません

そして 成果物はコンテナイメージだけではありません。 ここが最初に誤解するところです。

成果物何をビルドしたものか置き場の例取り出すコマンド
コンテナイメージDockerfile とアプリDocker Hub / GHCR / 社内レジストリdocker pull
npm パッケージJavaScript / TypeScript のライブラリnpm レジストリ / 社内レジストリnpm install
jar / warJava のコードMaven Central / NexusMaven / Gradle
deb / rpmC などで書かれたソフトUbuntu のアーカイブ / 社内ミラーapt install
静的ファイルHTML・CSS・JS・画像S3 / CDN / GitHub PagesHTTP で取得

この表の右3列は、形が違うだけで、やっていることは全部同じです。

どこかに置いてある成果物を、名前とバージョンを指定して取ってくる。

npm install の回でやったことと、apt install の回でやったこと、そして docker pull は、同じ形の作業です。相手が npm レジストリか、Ubuntu のアーカイブか、Docker Hub か、が違うだけです。

この記事は、その「相手」を自分で1台立てる話です。


② 自分のVMにレジストリを立てる

2-1. 小さいイメージを1つ作る

まず、push する対象を作ります。VMのメモリとディスクに優しいように、極小のイメージにします。

bash
$ mkdir -p ~/registry-demo
$ cd ~/registry-demo

Dockerfile を作ります。中身は Alpine Linux(約8MB)にメッセージを出させるだけです。

bash
$ cat > Dockerfile <<'EOF'
  FROM alpine:3
  RUN echo 'echo "hello from myapp"' > /app.sh && chmod +x /app.sh
  CMD ["/bin/sh", "/app.sh"]
  EOF

ビルドします。

bash
$ docker build -t myapp:1.0 .

動くか確かめます。「成功したか確かめる方法」を、必ず各手順に置きます。

bash
$ docker run --rm myapp:1.0
hello from myapp

これが出れば成功です。そして、このイメージは、いまこのVMの中にしかありません。

bash
$ docker images myapp

2-2. レジストリを起動する(127.0.0.1 に縛る)

レジストリ本体も、コンテナで動かします。

bash
$ docker run -d \
    --name registry \
    -p 127.0.0.1:5000:5000 \
    -v registry-data:/var/lib/registry \
    -e REGISTRY_STORAGE_DELETE_ENABLED=true \
    --restart=unless-stopped \
    registry:3

1行ずつ読みます。ここは飛ばさないでください。

部分意味
-dバックグラウンドで動かす
--name registry後で止めたり消したりするための名前
-p 127.0.0.1:5000:5000ここが一番大事。 VMの中からしか繋がらないように縛っています
-v registry-data:/var/lib/registry置いたイメージの保存先。ボリュームにしないと、コンテナを消したとき中身も消えます
-e REGISTRY_STORAGE_DELETE_ENABLED=true消せるようにする設定。既定では削除が禁止されています(⑦で使います)
--restart=unless-stoppedVMを再起動しても勝手に立ち上がる

-p 5000:5000 と書かないでください。 そう書くと VMの全てのネットワーク面で待ち受けます。今回立てるレジストリには、認証がありません。 同じネットワークにいる誰でも、中身を読めて、勝手に置けます。

127.0.0.1: を頭に付けると、待ち受けるのは VM 自身からの接続だけになります。nginx の回やセキュリティ点検の回でやった「開けるポートは最小にする」と同じ考え方です。

動いているか確かめます。

bash
$ docker ps --filter name=registry
$ curl http://127.0.0.1:5000/v2/_catalog
{"repositories":[]}

{} の中が空なのが正解です。 まだ何も置いていないからです。この /v2/ という道は、レジストリの共通の窓口で、Docker Hub にも同じものがあります。

[スクリーンショット: 01_レジストリ起動.png] docker ps でレジストリが動いていることと、curl で {"repositories":[]} が返っている画面を撮ってください。

2-3. タグを付け直す — docker tag は「行き先を決める」作業

ここが、この記事で一番よく誤解されるところです。

いま手元にあるのは myapp:1.0 です。これをそのまま push することはできません。

bash
$ docker push myapp:1.0

やってみると、Docker Hub に送ろうとして失敗します。 理由は、タグの中に宛先が書かれていないからです。

タグは、実はこういう構造をしています。

localhost:5000/myapp:1.0
└────┬────┘ └─┬─┘ └┬┘
  レジストリ  リポジトリ タグ
 (どこへ)  (何を)  (どの版)

myapp:1.0 にはレジストリの部分がありません。 そのとき Docker は「書いていない=Docker Hub」と解釈します。これが docker push myapp:1.0 が Docker Hub へ行こうとした理由です。

つまり docker tag は、名前を変える作業ではありません。行き先を決める作業です。

bash
$ docker tag myapp:1.0 localhost:5000/myapp:1.0

確かめます。

bash
$ docker images | grep myapp

2行出ますが、IMAGE ID は同じはずです。 ここが分かれ目です。

docker tag はコピーではありません。同じイメージに、もう1枚の名札を付けただけです。

だからディスクは増えません。名札が2枚あるだけです。

2-4. push する

bash
$ docker push localhost:5000/myapp:1.0

レイヤーごとに送られていきます。終わったら、レジストリに聞いてみます。

bash
$ curl http://127.0.0.1:5000/v2/_catalog
$ curl http://127.0.0.1:5000/v2/myapp/tags/list
{"repositories":["myapp"]}
{"name":"myapp","tags":["1.0"]}

さっき空だったところに、名前が入りました。 これで、イメージはあなたのVMのディスクの、Docker が管理する場所ではないところ(レジストリのボリューム)にも存在します。

[スクリーンショット: 02_push完了.png] docker push の完了直後と、curl で {"repositories":["myapp"]} が返っている画面を撮ってください。

2-5. 本当に取り出せるのか — 手元から消して pull し直す

ここをやらないと、この記事は意味がありません。 「push できた」だけでは、まだローカルにあるものを見ているだけかもしれないからです。

手元のイメージを、名札ごと全部消します。

bash
$ docker rmi myapp:1.0 localhost:5000/myapp:1.0

消えたことを確かめます。

bash
$ docker images | grep myapp

何も出なければ成功です。 この状態で、もう一度動かそうとしてみてください。

bash
$ docker run --rm localhost:5000/myapp:1.0

動きます。 ただし、よく見ると Unable to find image ... locally と出てから動いているはずです。手元に無かったので、レジストリから取ってきたのです。

明示的に取るなら、こうです。

bash
$ docker pull localhost:5000/myapp:1.0

これが「置き場がある」ということです。 手元から消えても、取り戻せる。別のマシンでも、同じ1行で取れる。

2-6. 定番の詰まり — https でないと拒否される

ここまで、localhost:5000 では何の問題もなく通りました。では、同じレジストリを別の名前で呼んでみます。

まずVMのIPアドレスを確かめます(Linuxのネットワークの回でやりました)。

bash
$ ip -4 addr show | grep inet

出てきたアドレス(例では 192.168.100.20 とします。あなたの数字に読み替えてください)で、タグを付けて push してみます。

bash
$ docker tag localhost:5000/myapp:1.0 192.168.100.20:5000/myapp:1.0
$ docker push 192.168.100.20:5000/myapp:1.0

失敗します。 そして、出るエラーは2種類のどちらかです。どちらが出たかで意味が違うので、読み分けてください。

出たもの意味
dial tcp 192.168.100.20:5000: connect: connection refusedそこでは誰も待っていない。 今回はこれが正解です(127.0.0.1 に縛ったので)
http: server gave HTTP response to HTTPS client待ってはいるが、Docker が https を要求して断った

今回は前者が出ます。 それは私たちが意図してポートを閉じたからです。もし -p 5000:5000 で立てていたら、後者が出ます。 そして後者こそが、世の中で最も多く踏まれる詰まりです。

なぜ Docker は https を要求するのか。

理由は2つあり、どちらも「気分」ではありません。

  1. 平文だと中身が丸見えになる。 イメージの中には、設定ファイルも、うっかり入れた鍵も入り得ます(シークレットの回)。さらに push のときにはレジストリの認証情報が流れます
  2. 平文だと途中で差し替えられる。 これが本質です。あなたが pull したイメージが、あなたの本番サーバーで root 権限を持って動きます。 経路上の誰かがそれを別のイメージに差し替えられるなら、そのサーバーは相手のものです

では、なぜ localhost:5000 は通ったのか。

Docker が loopback アドレス(localhost と 127.0.0.0/8)だけを例外扱いしているからです。自分自身との通信は、途中の経路が存在しません。 盗聴する場所も、差し替える場所も無い。だから https を要求する理由がないのです。

この記事で 127.0.0.1 に縛ったのは、安全のためだけではありません。 そうすると https の設定を一切しなくても、正しいまま学習できるからです。

学習用の逃げ方(2つ)

逃げ方A(推奨): SSHのポート転送で「localhost に見せる」

別のマシンから使いたいなら、レジストリを外に開けるのではなく、経路のほうを持ってくるやり方があります。VS Code Remote SSH の回で SSH は使えるようになっています。

bash
$ ssh -L 5000:127.0.0.1:5000 ユーザー名@VMのIP

こうすると、手元のマシンの localhost:5000 が、VMの中の 127.0.0.1:5000 に繋がります。 Docker から見れば localhost なので、https は要求されません。 レジストリは外に開いていないままです。

逃げ方B(学習用のみ・本番禁止): 平文を許可する設定を書く

どうしても IP やホスト名で直接繋ぎたいときは、Docker の設定でその相手だけを例外にできます。設定ファイルの場所は /etc/docker/daemon.json です。

bash
$ sudo nano /etc/docker/daemon.json
{
  "insecure-registries": ["192.168.100.20:5000"]
}
bash
$ sudo systemctl restart docker

これを本番でやってはいけない理由を、はっきり書きます。

  • 「暗号化されていない」だけではありません。「相手が本物か確かめない」のです。 https の価値は、隠すことと、相手を確認することの2つです。この設定は両方を捨てます
  • 捨てた結果、pull したイメージが本物である保証がなくなります。 そのイメージはあなたのサーバーの中で実行されます
  • 一度書くと、誰も消しません。 「あとで直す」は直りません

本番でやることは、逃げることではなく、証明書をちゃんと用意することです。 nginx をリバースプロキシにして https を終端させる、というのが最も普通のやり方です。そして実際には、次の⑤で書くとおり、自分で立てずに借りるほうが多いです。

とりあえず、いまの練習用のタグは消しておきます。

bash
$ docker rmi 192.168.100.20:5000/myapp:1.0

③ タグの付け方 — latest を本番で使わない

registry は動きました。ここからは「何という名前で置くか」の話です。運用で効くのは、実はこちらです。

latest は「最新」という意味ではない

まず誤解を壊します。

latest は Docker にとって特別な意味を持ちません。ただのタグ名です。

myapp:latest は、myapp:banana と技術的に同格です。唯一の特別扱いは「タグを省略したときに補われる」ことだけです。

そして、latest には決定的な問題があります。

問題何が起きるか
中身が黙って入れ替わる昨日の latest と今日の latest は別物。同じ名前なのに
どれが動いているか言えなくなる「本番は latest です」は何も言っていないのと同じ
戻せない障害時に「前のに戻す」ができない。前のに名前が無いからです
pull されないことがある手元に latest があると、取り直さないことがある。古いまま動き続ける

障害対応の回で、切り分けの順番がすべてだと書きました。「いま動いているのはどの版か」が言えないと、切り分けは1歩目から止まります。

何を付けるか

答えは「二度と意味が変わらないもの」です。

付け方例いつ使うか
バージョンmyapp:1.4.2人に配るとき。人が読んで意味が分かる
コミットハッシュmyapp:a1b2c3dCI で自動で付けるとき。どのソースから作ったかが確実に分かる
日付+連番myapp:2026-09-13.3時系列で追いたいとき
latestmyapp:latest手元の試しだけ。本番のデプロイ対象にしない

一番強いのはコミットハッシュです。 理由は1つです。

イメージから、それを作ったソースへ、迷わず戻れるからです。

1.4.2 は誰かが手で付けた名前なので、付け間違えることがあります。 ハッシュは Git が中身から作るので、間違えようがありません。

実務では両方付けます。 さっき見たとおり、docker tag はディスクを増やしません。

bash
$ docker tag localhost:5000/myapp:1.0 myapp:1.0   # 2-5 で消した名札を戻す
$ docker tag myapp:1.0 localhost:5000/myapp:a1b2c3d
$ docker push localhost:5000/myapp:1.0
$ docker push localhost:5000/myapp:a1b2c3d

イミュータブルであること

もう1つ、名前より大事な原則があります。

一度 push したタグの中身を、後から書き換えない。

1.0 を push したあとで、直して、また 1.0 で push することは技術的にはできます。 レジストリによっては設定で禁止できますが、既定では通ります。

やってはいけません。

  • 手元の 1.0 と、サーバーの 1.0 と、レジストリの 1.0 が、全部違う中身になります
  • 「動かない」と言われたときに、相手が何を動かしているのか分からなくなります
  • Kubernetes は「同じタグなら取り直さない」ことがあるので、直したのに反映されません

直したら、番号を上げます。 1.0.1 にする。それだけです。番号はタダです。


④ なぜ会社は Nexus や Artifactory を立てるのか

ここまでで「置き場が要る」ことは分かりました。ではなぜ、わざわざサーバーを1台使って、専用のソフトを入れるのか。

「置き場が欲しいから」ではありません。 理由は4つあり、そのうち3つは置き場と関係ありません。

理由1: 外部に繋がらない環境がある

インターネットに出られないネットワークは、実在します。 金融・医療・工場・官公庁では珍しくありません。

そこでは npm install も apt install も docker pull も全部失敗します。 開発ができません。

そこで、外に出られる場所に1台だけ置いて、そこ経由で取るようにします。これが次の話に繋がります。

理由2: 取得の高速化(キャッシュ)— プロキシリポジトリ

これが Nexus / Artifactory の一番よく使われる機能です。

プロキシリポジトリという考え方があります。

社内のレジストリに聞く → 持っていなければ、代わりに外から取ってきて、渡しながら、自分にも保存する → 次からは自分が返す

Redis の回や CDN の回で見たキャッシュと、まったく同じ構造です。相手が DB か、外部のレジストリか、が違うだけです。

効くのは、こういうところです。

  • CI が1日に100回走る。 毎回 npm ci で同じものを外から取る。社内キャッシュがあれば1回で済む
  • Docker Hub には取得回数の制限があります。 CI から何度も引くと、ある日突然 429 で止まります
  • 外部が落ちても、キャッシュにあるものは動く

理由3: 社内ライブラリを配りたい

公開できないコードを、社内の複数チームで共有したいというのは、どこの会社にもあります。

npm に publish はできません(世界に公開されます)。そこで、社内のレジストリに publish します。 使う側は npm install の宛先を社内に向けるだけで、書き方は何も変わりません。

npm の回でやった npm install が、そのまま社内でも使える。 これが大きいのです。新しい配布方法を発明しなくて済みます。

理由4: 何を使っているかの記録

全員が同じ1箇所を通ると、そこにログが残ります。

  • どのライブラリが、どれだけ使われているか
  • 脆弱性が見つかったとき、誰が影響を受けるか(セキュリティ点検の回)
  • ライセンス的にまずいものが入っていないか

「使っているものの一覧が出せる」というのは、事故が起きたときに決定的です。

それでも、あなたは立てなくていい

Nexus も Artifactory も Java で動きます。 公式が案内する最小メモリは、どちらも数GB規模です。学習用のVMには重すぎます。

そして、立てても学べることは、今日 registry:3 でやったこととほとんど同じです。

プロキシリポジトリの考え方さえ持って帰れば、それで足ります。

「会社に入ったら Nexus があった」というときに、それが何をしているのか分かることが目的です。運用のしかたは、その会社のやり方に従うことになります。


⑤ 借りるという選択肢

個人開発と、たいていの会社の新規案件では、自分で立てません。借ります。

サービス一言で
Docker Hubコンテナイメージの事実上の標準置き場。無料でも私的なリポジトリを持てるが、取得回数に制限がある
GitHub PackagesGitHub が提供する成果物置き場の総称。npm・Maven・NuGet などに対応し、リポジトリの権限がそのまま使える
GHCRGitHub Packages のうちコンテナイメージ専用の入口(ghcr.io)。GitHub Actions から追加の設定なしで push できるのが強み
Amazon ECRAWS のレジストリ。AWS の権限管理と一体で、AWS 上で動かすなら第一候補
Cloudsmith形式を選ばない置き場の商用サービス。npm も deb も Docker も1箇所で扱える

選び方は単純です。

  • コードが GitHub にあるなら GHCR。 CI からの認証がほぼ設定なしで済みます
  • AWS で動かすなら ECR。 権限がそのまま繋がります
  • 公開したいだけなら Docker Hub
  • 迷ったら GHCR

料金は、置いた容量と、取り出した通信量にかかります。 クラウド料金の回で書いたとおり、止め忘れではなく「溜め忘れ」で膨らむのがこの分野です。⑦に繋がります。


⑥ サプライチェーン — 取ってくる先を信頼している

ここは名前だけ覚えて先へ進むところです。深入りしません。 ただし、問題の形だけは正確に持って帰ってください。

npm install を1回打つと、node_modules の回で見たとおり、数百から千を超えるパッケージが入ります。docker pull も同じです。ベースイメージの中に、あなたが選んでいないソフトが大量に入っています。

あなたはそれを、読まずに、自分のサーバーで実行しています。

これは怠慢ではありません。読める量ではないからです。 全員がそうしています。つまり私たちは「取ってくる先」を信頼することで成立しています。

その信頼を、気持ちではなく仕組みで確かめようとする動きがあります。名前が2つあります。

署名(cosign)

「このイメージは、確かにこの主体が作ったもので、置いてから書き換えられていない」を確かめる仕組みです。cosign は sigstore というプロジェクトの道具で、イメージに署名を付け、pull する側がそれを検証します。②で見た「差し替えられたら終わり」という問題への、直接の答えです。鍵の管理が要らない仕組み(ビルドした CI の身元をそのまま証拠にする)があるのが、この分野の新しいところです。いま覚えるのは「イメージには署名が付けられて、pull 時に検証できる」までで十分です。

SBOM

Software Bill of Materials、日本語で「部品表」です。 そのイメージやアプリの中に、どのライブラリのどのバージョンが入っているかを機械が読める形で並べたファイルです。形式には CycloneDX と SPDX という2つがあり、syft などの道具がイメージから自動で作ります。価値が出るのは事故のときです。 ある library に重大な脆弱性が出た日に、「うちの何百個のイメージのうち、どれが影響するか」を、その日のうちに答えられるかどうかが変わります。セキュリティ点検の回で npm audit を打ちましたが、あれを、動いている全部の成果物に対してやるのが SBOM の使いどころです。

署名は「本物か」、SBOM は「何が入っているか」。 役割が違います。両方が揃って初めて「取ってくる先を信頼できる」に近づきます。

個人開発でいま導入する必要はありません。 ただし、「読まずに実行している」という事実を忘れないでください。 これを忘れると、AIが書いた差分を読まずに入れるのと同じ場所に落ちます。


⑦ 古いイメージは黙って溜まる

レジストリを立てて、CI から自動で push するようにすると、必ずこうなります。

ある日、ディスクが埋まる。

CI が1日に20回走れば、1日に20個のイメージが増えます。誰も消しません。自動では消えません。

まず、いまどれだけ使っているか測ります。 パフォーマンスの回と同じで、測る前に消さないでください。

bash
$ docker system df
$ df -h /

docker system df の RECLAIMABLE の列が、消しても誰も困らない量です。

手元(Docker のキャッシュ側)の掃除は、これです。

bash
$ docker image prune

docker system prune -a は、いま使っていないイメージを全部消します。 便利ですが、次のビルドが全部やり直しになります。 何が消えるか読んでから y を押してください。

レジストリ側(置き場)の掃除には、2段階あります。 ここが分かりにくいところです。

  1. タグを消す。 名札を外すだけで、中身(レイヤー)は残ります
  2. ガベージコレクションを走らせる。 もう誰も指していない中身を、実際に消します

②で REGISTRY_STORAGE_DELETE_ENABLED=true を付けたのは、この1段目を可能にするためです。既定では消せません。 ガベージコレクションは、レジストリのコンテナの中でコマンドを1本打つ形になります。今回はディスクが埋まっていないので、走らせなくて構いません。

大事なのは、コマンドより方針です。

何をどうする
本番に出した版消さない。 戻す先が無くなります
タグ付きのリリース(1.4.2 など)残す。数が少ないので問題になりません
PRごと・コミットごとのタグ期限を決めて消す(例: 30日)。これが増える元凶です
latest③のとおり、そもそも本番の対象にしない

借りるサービス(GHCR や ECR)には、この「何日経ったら消す」を設定する機能があります。 立てるにせよ借りるにせよ、最初にこれを決めてください。 決めないと、必ずディスクか請求書で気づくことになります。


⑧ やりすぎない

この記事を読んだあとに、やらなくていいことを書いておきます。

  • 自分のプロジェクトのために Nexus や Artifactory を立てる。 重いだけです
  • プライベートレジストリを本番用に自分で運用する。 証明書・認証・バックアップ・冗長化が全部あなたの仕事になります。そのレジストリが落ちると、デプロイが全部止まります
  • いますぐ cosign と SBOM を全部の成果物に導入する

個人開発なら、GHCR か Docker Hub で十分です。

今日レジストリを立てたのは、運用するためではなく、中で何が起きているかを見るためです。docker push の宛先がタグの中に書かれていることと、https が要求される理由——この2つが分かっていれば、GHCR も ECR も、同じ道具として使えます。

そして最後に、この記事は「置き場」の話しかしていません。 置いたものをどう配るか(ローリング更新・切り戻し)は、Kubernetes や ArgoCD の側の仕事です。置き場と配り方は別の問題です。


つまずいたところ

書いてから直した順に、そのまま残します。

docker push myapp:1.0 が Docker Hub に行こうとした

最初、タグを付け直す意味が分かっていませんでした。 レジストリを立てたのだから、そこに行くだろうと思っていました。

そんな判断は誰もしていません。 Docker はタグの文字列だけを見ています。 レジストリ部分が無ければ Docker Hub。それだけです。「立てたから察してくれる」ということは起きません。

このとき、denied: requested access to the resource is denied のようなエラーが出ます。これを読んで「権限の問題だ」と思って、認証を調べに行きました。完全な遠回りでした。 権限の問題ではなく、宛先が違ったのです。

docker tag でディスクが2倍になったと思った

docker images を見たら同じサイズが2行出たので、コピーされたと思って片方を消しました。

IMAGE ID を見ていませんでした。 同じIDなら実体は1つです。そして docker rmi で片方を消しても、もう片方の名札が残っていれば実体は消えません。 ここは docker images --digests まで見ると、はっきりします。

レジストリを消したらイメージも消えた

最初、-v を付けずに起動していました。動作確認のあと docker rm -f registry して、立て直したら中身が空でした。

コンテナを消すと、その中に書いたものは消えます。 Docker の回でやった話が、そのまま出てきました。「消えると困るデータは、ボリュームに出す」 です。置き場を作っているのに、その置き場が消えるのでは意味がありません。

IPアドレスで push しようとして、エラーの意味を取り違えた

connection refused を見て、「レジストリが死んだ」と思って docker ps を見に行きました。 動いていました。

死んでいたのではなく、そのアドレスでは待っていなかったのです。127.0.0.1:5000 に縛るというのは、そういう意味です。ネットワークの回の「どの段階で切れているか」を、ここでもう一度使いました。

latest で本番を動かしていて、戻せなくなりかけた

これは実際にやりました。「前のバージョンに戻して」と言われて、戻す先の名前が無いという状態になりました。

イメージ自体は手元に残っていたので、IDを直接指定して事なきを得ました。 ただ、それは運が良かっただけです。タグを付けていない過去のイメージは、docker image prune の対象です。掃除した瞬間に、戻す先が消えます。


後片づけ

この記事で足したものを、全部戻します。 VMのディスクを空けておいてください。

1. レジストリを止めて消す

bash
$ docker stop registry
$ docker rm registry

2. 置いたイメージの実体(ボリューム)を消す

これを忘れると、消したつもりでディスクが空きません。

bash
$ docker volume ls
$ docker volume rm registry-data

3. 手元のイメージを消す

bash
$ docker rmi localhost:5000/myapp:1.0 localhost:5000/myapp:a1b2c3d myapp:1.0
$ docker rmi registry:3 alpine:3

4. 作業ディレクトリを消す

bash
$ rm -rf ~/registry-demo

5. daemon.json を触った人だけ、戻す

②の「逃げ方B」を試した場合だけです。試していないなら、この手順は飛ばしてください。

bash
$ sudo nano /etc/docker/daemon.json

insecure-registries の行を消します。 ファイル全体が insecure-registries だけだったなら、ファイルごと消して構いません。

bash
$ sudo rm /etc/docker/daemon.json
$ sudo systemctl restart docker

6. 空いたことを確かめる

bash
$ docker system df
$ df -h /
$ docker ps -a

レジストリのコンテナが一覧から消えていて、ディスクが元に戻っていれば完了です。

もし途中で分からなくなったら、最初に取ったスナップショットに戻してください。 それが一番速いです。


まとめ — 理解できたこと

  • ビルドした結果は、そのマシンの中にしかない。 CI が終われば消える。置き場が無いと、確かめただけで終わる
  • ソースは Git、成果物はレジストリ。 分ける理由は、再生成できる・でかい・出所が問われるの3つ
  • 成果物はイメージだけではない。 npm・jar・deb・静的ファイルも同じ。「名前とバージョンで取ってくる」という形は全部同じ
  • docker tag は名前を変える作業ではなく、行き先を決める作業。 レジストリ名を書かないと Docker Hub へ行く
  • docker tag はコピーではない。 同じ実体に名札がもう1枚付くだけ。ディスクは増えない
  • レジストリは 127.0.0.1 に縛って立てる。 認証の無いレジストリを開けると、誰でも読めて置ける
  • 消えると困るものはボリュームへ。 レジストリのコンテナを消すと、置いたイメージも消える
  • push できただけでは確かめたことにならない。 手元から消して pull し直すまで
  • Docker が https を要求するのは、隠すためと、相手を確かめるため。 平文だと差し替えられる
  • localhost が例外なのは、途中の経路が存在しないから。 気分で例外にしているのではない
  • insecure-registries は学習用。 本番では証明書を用意する。書いたら誰も消さない
  • 別マシンから使いたいなら、開けるより SSH のポート転送のほうが安全で早い
  • latest は「最新」という意味ではない。 ただのタグ名で、中身が黙って入れ替わる
  • 本番はバージョンかコミットハッシュ。 「いま動いているのはどれか」が言えないと、障害時に1歩目で止まる
  • 一度 push したタグの中身は書き換えない。 直したら番号を上げる。番号はタダ
  • 会社がレジストリを立てる理由は4つ。 外に出られない / キャッシュで速くする / 社内ライブラリを配る / 使ったものを記録する
  • プロキシリポジトリ=「持っていなければ外から取って、自分にも溜める」。 Redis や CDN と同じ構造
  • Nexus と Artifactory は学習用VMには重い。 考え方だけ持って帰れば足りる
  • 迷ったら GHCR。 GitHub にコードがあるなら CI からの認証がほぼ設定なしで済む
  • 私たちは、読んでいないものを実行している。 それを仕組みで確かめるのが署名(cosign)と SBOM
  • 署名は「本物か」、SBOM は「何が入っているか」。 役割が違う
  • 古い成果物は自動では消えない。 ディスクか請求書で気づく前に、保持期間を先に決める
  • タグを消しても中身は残る。 レジストリ側の掃除は2段階
  • 本番に出した版は消さない。 消すのは PR ごと・コミットごとの使い捨てのほう
  • 個人開発でここまで運用しない。 GHCR か Docker Hub で十分

参考リンク


この段階の確認

【第6段階】インフラとコンテナ は、ここで終わりです。 次に進む前に、答えを見ずに試してください。

読み終えた直後は、たいてい「分かった気」になっています。 手が動くかどうかは別です。

説明できますか

  1. コンテナは軽い仮想マシンではない。 では何なのか
  2. Kubernetes の「状態を宣言する」とは、何と何を比べ続けているのか
  3. AIにコマンドを実行させるとき、目視を主な防御にしてはいけないのはなぜか

手が動きますか

  • docker compose up 1つで、アプリとDBをまとめて立てる
  • Podを1つ消し、勝手に戻ってくることを確かめる
  • sudo を持たない作業用ユーザーを作り、本当に使えないことを確認する
  • 作業フォルダに秘密が無いか洗い、マスクした形を作る

1つでも詰まったら、飛ばした回があります。 そこへ戻ってください。戻るのは後退ではありません。 戻り先の目安: Dockerの回 / Kubernetesの回 / AIの安全網の回 / 渡してはいけないものの回

全部答えられたなら、次の段階へ進んでください。


次に読む

この記事は 【第6段階】インフラとコンテナ の 25 / 25 本目です。

記事
← 前の記事Kubernetesは重すぎた — Swarmという選択肢
→ 次の記事WordPressでサイトを公開するまで — ドメインとサーバー

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Artifact Management
  • コンテナレジストリを自分で立てる
  • Nexus / Artifactory / Cloudsmith — 会社が立てる理由

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次