ストレージおよびプル・トラフィックの請求処理

選択しているサービス・プランに応じて、各リージョンで 1 カ月当たりに使用するストレージおよびプル・トラフィックに対して課金されます。

ストレージおよびプル・トラフィックのクォータ制限

選択しているサービス・プランに応じて、各リージョンのプラン固有の割り当て量制限またはカスタム割り当て量制限に達するまで、名前空間にイメージをプッシュしたり名前空間からイメージをプルしたりすることができます。

Container Registry のコスト

オファリング詳細ページの「価格設定プラン」セクションに IBM Cloud Container Registry のコストが表示されます。Container Registry を参照してください。

コンテナー・イメージ

コンテナーを作成するためにコンテナー・ランタイム内で使用されるファイル・システムおよびその実行パラメーター。 ファイル・システムは、継続的な更新によってコンテナー・イメージが構築されるときに作成され、実行時に結合される一連のレイヤーで構成されます。 コンテナ・イメージは、コンテナの実行時にその状態を保持しない。

コンテナー・イメージは、名前空間内に保管されているリポジトリー内に保管されます。

ダイジェスト

ダイジェストは、イメージ・マニフェスト、レイヤー、構成アイテムなど、レジストリー内のさまざまなオブジェクトへの不変参照として使用されます。

レジストリーのコンテキストでは、イメージ・ダイジェストは sha256 ハッシュ (イメージ・マニフェスト) を使用して、イメージを識別するイメージへの不変の参照です。 イメージ・ダイジェストを使用すると、常に同じバージョンのイメージを参照することができます。 イメージのプル、プッシュ、削除などイメージを処理するには、イメージ・ダイジェストの長形式を使用します。画像ダイジェストの長尺フォーマットを使って、画像の抜き差しや削除など、画像を扱う作業を行います。

イメージ・ダイジェストを検索するには、ibmcloud cr image-digests コマンドを実行します。 ibmcloud cr image-list コマンドもイメージ・ダイジェストを返しますが、デフォルトでは切り捨てられた形式になります。 ibmcloud cr image-list コマンドにオプションを追加すると、イメージ・ダイジェストを長形式で返すことができます。

イメージ・ダイジェストを使用してイメージを識別する場合は、必ず長形式を使用してください。

Container Registry で言う「ダイジェスト」とは、「イメージのダイジェスト」のことです。

Dockerfile

Dockerfile は、Docker イメージをビルドするための指示が含まれるテキスト・ファイルです。

コンテナー・イメージは通常、基本オペレーティング・システム (Ubuntu など) が含まれる基本イメージを元に構築されます。 アプリの実行に必要な環境を定義する Dockerfile の指示の基本イメージを徐々に変更することができます。 基本イメージの変更のたびに、イメージの新規レイヤーが記述されます。Dockerfile の単一の行に複数の変更を加えることができます。 Dockerfileの指示は、アプリやアプリの設定、依存関係など、別々に保存されているビルド成果物を参照することもある。 Dockerfileの詳細については、 Dockerfileリファレンスを参照。

Docker V2 コンテナー・イメージ

イメージ・マニフェスト・バージョン 2、スキーマ 2 仕様に準拠したコンテナ・イメージ。

Docker Image Manifest V2, Schema 2 のメディア・タイプは application/vnd.docker.distribution.manifest.v2+json で、マニフェスト・リストのメディア・タイプは application/vnd.docker.distribution.manifest.list.v2+json です。 Docker V2 コンテナー・イメージは、OCI コンテナー・イメージの一種です。 Docker のサポートについて詳しくは、Docker を参照してください。

ドメイン・ネーム

ホスト・システムの名前。 ドメイン名は、一連のサブネームとそれらを区切る文字で構成されます (例: www.ibm.com)。

Container Registry が使用するドメイン名の形式は、us.icr.ioです。 Container Registry が使用する以前のドメイン名の形式は、registry.ng.bluemix.netです。 どちらの形式のドメイン名も、同じレジストリーと内容を参照します。 Container Registry サービスは、以前のドメイン名と正規ドメイン名に対して同等に応答します。 どちらのドメイン名を使用しても、同じ意味でイメージをプッシュまたはプルすることができます。

ドメイン名は、次の状況でのみ意味を持ちます。

• Kubernetes はプル・シークレットを選択するときに、ドメイン名に一致するプル・シークレットを選択します。
• ibmcloud cr login がログインを支援する場合、us.icr.io 形式のドメイン名のみが使用されます。
• イメージが署名されると、署名時に使用されたドメイン名が署名に含まれます。

Container Registry が使用するドメイン名についての詳細は、リージョン を参照してください。

イメージ・マニフェスト

イメージ・マニフェストは、イメージをプルして実行するために必要な構成オブジェクトとイメージ・レイヤーを参照する .json 文書です。 イメージ・マニフェストの sha256 ハッシュは、イメージを識別するために使用されるダイジェストです。 ibmcloud cr manifest-inspect コマンドを実行して、イメージ・マニフェストを表示できます。

OCI コンテナー・イメージ

OCI Image Format 仕様に準拠したコンテナ・イメージ。

OCI コンテナー・イメージのメディア・タイプは application/vnd.oci.image.manifest.v1+json です。

レジストリ―

パブリックまたはプライベートのコンテナー・イメージのストレージおよび配布サービス。

ストレージは、 OCI コンテナ・イメージOCI イメージ・フォーマット仕様に準拠するコンテナー・イメージ （ Docker コンテナ・イメージとも呼ばれる）用に提供される。 OCI コンテナー・イメージは、該当するレジストリー・ドメイン・ネームを使用した OCI クライアントから、取得 (プル) できます。 誰でもアクセスできるコンテナー・イメージ (パブリック・イメージ) もあれば、特定のグループしかアクセスできないもの (プライベート・イメージ) もあります。Container Registry では、IBMがホストおよび管理する、マルチテナントで高可用性のプライベート・イメージ・レジストリーを利用できます。 このレジストリーにアカウント専用の名前空間を追加し、イメージをその名前空間にプッシュすることができます。

レジストリー名前空間

Container Registry、コンテナイメージを格納するフォルダやリポジトリを含むフォルダ。 レジストリー名前空間は、IBM Cloud アカウントに関連付けられています。 1 つのアカウント内に複数のレジストリー名前空間があってもかまいません。

Container Registry で独自の名前空間を設定すると、その名前空間がレジストリ URL <region>.icr.io/my_namespace に追加されます。 名前空間は、同じリージョン内のすべての IBM Cloud アカウントにわたって固有である必要があります。 適切な IAM パーミッションを持っている IBM Cloud アカウントのすべてのユーザーは、レジストリのネームスペースに保存されているイメージを表示したり、操作したりすることができます。

各リージョン内で使用できる名前空間は 100 個です。

ネームスペースは、指定した リソース・グループ 内に作成されるため、ネームスペース内のリソースへのアクセスをリソース・グループ・レベルで構成できます。 リソース・グループを指定せず、リソース・グループをターゲットにしない場合は、デフォルトのリソース・グループが使用されます。 リソース・グループ内にない古いネームスペースがある場合は、そのネームスペースをリソース・グループに割り当て、そのネームスペースの権限をリソース・グループ・レベルで設定できます。 リソース・グループについて詳しくは、リソース・グループへの既存の名前空間の割り当てを参照してください。

リソース・グループに割り当てられた名前空間は、IBM Cloud コンソールの 「リソース・リスト」 ページに表示されます。

リポジトリー

関連するコンテナ画像のコレクションを格納する。 リポジトリは名前空間に格納される。 コンテナ画像はタグまたはダイジェストのみで区別される。 リポジトリという用語は、コンテナ・イメージと同じ意味で使われることが多いが、リポジトリはコンテナ・イメージの複数のタグ付きバリアントを保持する可能性がある。

タグ

リポジトリー内のコンテナー・イメージに付加される識別子。 タグはイメージへの再割り当てや、イメージからの削除が可能です。

タグを使って1 つのアカウントに含まれるリソースのグループに結び付いているユーザー定義識別子。 タグはアカウント全体で表示されます。、リポジトリ内で同じベースイメージの異なるバージョンを区別することができます。 リポジトリー・イメージのタグを指定しないで Docker コマンドを実行すると、latest タグの付いたイメージがデフォルトで使用されます。

タグが付いていないイメージ

タグのないイメージは、タグの外されたイメージです。 タグ付けされていないイメージは、タグ参照形式 <repository>@<digest> ではなく、ダイジェスト参照形式 <repository>:<tag> を使用して参照できます。 通常、タグ付けされていないイメージは、既存の <repository>:<tag> の組み合わせでプッシュされたイメージの結果です。 この場合、タグは上書きされ、元のイメージはタグが付いていない状態になります。

ibmcloud cr image-digests コマンドを使用して、タグが付いていないイメージを表示したり、ibmcloud cr image-prune-untagged コマンドを使用して、タグが付いていないイメージをクリーンアップしたりできます。

グローバル・レジストリー

グローバル・レジストリーが使用可能です。 グローバル・レジストリーの名前 (icr.io) にはリージョンが含まれていません。 このレジストリーは、ユーザーの名前空間とイメージをホストするだけでなく、IBM によって提供されるパブリック・イメージもホストします。

Container Registry のグローバル・インスタンスは、以下の表に示すドメイン名を使用して使用できます。

プライベート・ドメイン名を使用して Container Registry に接続する方法については、プライベート・ネットワーク接続の使用方法を参照してください。

既存の bluemix.net ドメイン・ネームは非推奨となっていますが、現在のところ使用を継続できます。 サポート終了日はまだ発表されていません。

ローカル・リージョン

Container Registry のリージョン・インスタンスは、以下の表に示すドメイン名で使用できます。

プライベート・ドメイン名を使用して Container Registry に接続する方法については、プライベート・ネットワーク接続の使用方法を参照してください。

既存の bluemix.net ドメイン・ネームは非推奨となっていますが、現在のところ使用を継続できます。 サポート終了日はまだ発表されていません。

Docker のサポート

IBM Cloud Container Registry は、 がサポートしている のバージョンをサポートしている。 Docker Docker Engine

Docker が必要になるのは、イメージをプッシュまたはプルする場合のみです。

Docker V2 Schema 2 イメージがサポートされています。 マニフェスト・リストもサポートされています。 詳細は レジストリの互換性を参照。

Docker V2 Schema 1 イメージは終了します。そのため、今後それらを Container Registry にプッシュすることはできません。

他のクライアントへのサポート

IBM Cloud Container Registry OCIディストリビューション仕様バージョン1以降に準拠するクライアントのサポートバージョン（、、 など）をサポートしています。 Buildah Podman Skopeo