コンテナレジストリ

コンテナレジストリは、自分でビルドした Docker / OCI イメージを保存して、 ToukaCloud の Web サービス (SaaS) や CI/CD から pull するための場所です。 以下の機能を提供します。

• プロジェクト: イメージをグルーピングする論理単位 (容量割当もここで管理)
• アクセストークン: docker login 用のパスワード相当 (Project ごとに発行)
• テナント隔離: 自分の namespace 配下にしか push/pull できない
• UI catalog: 自分のリポジトリ一覧のみ表示 (他人のは見えない)

• 有効なライセンス (S 以上のいずれか) があること
• ローカルマシンに docker CLI が入っていること

1. サイドバーの レジストリ を開く
2. 「プロジェクトを作成」 をクリック
3. プロジェクト名を入力 (小文字英数字とハイフン、英数字始まり / 終わり、最大 50 文字)
4. 容量をスライダーで選択 (1 GiB 〜 ライセンス上限)
5. 「プロジェクトを作成」 で確定

docker login のパスワードに使うトークンを発行します。 トークンは 1 度だけ表示されるので、必ずその場でコピーしてください。

1. 「アクセストークン」 タブを開く
2. 「トークンを作成」 をクリック
3. 対象プロジェクトを選択
4. ラベル (例: laptop や ci-runner) を入力
5. (任意) 有効期限を設定
6. 「トークンを作成」 で発行
7. 表示されたトークンをコピーして安全な場所に保存

レジストリ画面上部の「あなたのレジストリエンドポイント」欄からコマンドをコピーできます。

5.1 ログイン

docker login registry.max3584.net
Username: <任意 (例: あなたのメールアドレス)>
Password: <発行したアクセストークン>

5.2 イメージをタグ付け

ローカルでビルドしたイメージを、レジストリ用のフルパスでタグ付けします。 フルパスは Project カードに表示されている形式です:

docker tag myapp:latest \
  registry.max3584.net/<tenantId>/<userId>/<projectName>/myapp:latest

5.3 push

docker push registry.max3584.net/<tenantId>/<userId>/<projectName>/myapp:latest

5.4 pull

docker pull registry.max3584.net/<tenantId>/<userId>/<projectName>/myapp:latest

イメージのフルパスは以下の構造で固定されています:

registry.max3584.net/<tenantId>/<userId>/<projectName>/<image>:<tag>
                                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                  あなたの namespace (固定)

• tenantId: あなたのアカウント ID から自動生成 (8桁hex)
• userId: あなたのアカウント ID (Keycloak UUID)
• projectName: 作成したプロジェクト名
• image: 任意のイメージ名 (英数字, ハイフン, スラッシュ可)
• tag: 任意のタグ (例: latest, v1.0.0)

• 自分の namespace (tenantId/userId/) 配下以外への push / pull は 403 Forbidden で拒否されます
• docker search や catalog 取得で他人のイメージは見えません
• tags 一覧 (/v2/.../tags/list) も自分のリポジトリのみ取得可能
• トークンが流出しても、流出先は他人の namespace にはアクセスできません

レジストリ周りの上限はプラン別に決まります (ライセンスガイド と同じ SoT を参照しています):

現在の使用量と上限はレジストリ画面のヘッダや ライセンスページ で確認できます。上限を超えるとプロジェクト作成が拒否されます。