Container Registry:Container Registry Enterprise Edition インスタンスでのイメージのビルド

ステップ 1: インスタンスとコードホスティングプラットフォームのバインド

ステップ 2: 名前空間の作成

名前空間を作成して、イメージリポジトリを整理します。リポジトリの自動作成を有効にすると、この名前空間配下のすべてのリポジトリに適用されるデフォルト設定を構成できます。

1. Container Registry コンソールにログインします。

2. 上部メニューで、リージョンを選択します。

3. 左側メニューで、[インスタンス] をクリックします。

4. [インスタンス] ページで、名前空間を作成する Enterprise Edition インスタンスをクリックします。

5. 左側メニューで、[リポジトリ] > [名前空間] を選択します。

6. [名前空間] ページで、[名前空間の作成] をクリックします。

7. [名前空間の作成] サイドバーで、[名前空間] を設定し、[リポジトリの自動作成] を [オン] または [オフ] に設定します。その後、[確認] をクリックします。

   [リポジトリの自動作成] を [オン] に設定した場合は、次のパラメーターを設定します：

   パラメーター	説明
   リポジトリタイプ	[Public] または [Private] を選択します。パブリック：デフォルトでは、パブリックイメージをプルするには、ユーザーがインスタンスにログインする必要があります。匿名のプルを許可するには、インスタンスのパブリック匿名プル設定を有効にします。パブリックリポジトリは権限のないユーザーでもプルできるため、データを保護するにはリポジトリをプライベートに設定します。プライベート：ユーザーは、プライベートイメージをプルする前に、インスタンスにログインし、プル権限が必要です。
   不変のイメージタグ	[Flexible] または [Immutable] を選択します。[Immutable] に設定すると、latest を除くすべてのイメージタグは上書きできなくなります。
   高速化イメージ	有効にすると、イメージがプッシュされた後、各イメージの高速化バージョンが自動的に生成されます。高速化イメージのタグには、_accelerated サフィックスが追加されます。

ステップ 3: イメージリポジトリの作成

イメージリポジトリを作成し、ソースコードリポジトリにバインドします。そのソースコードリポジトリからビルドされたすべてのイメージは、このイメージリポジトリにプッシュされます。

1. Container Registry コンソールにログインします。

2. 上部メニューで、リージョンを選択します。

3. 左側メニューで、[インスタンス] をクリックします。

4. [インスタンス] ページで、管理する Enterprise Edition インスタンスをクリックします。

5. 左側メニューで、[リポジトリ] > [リポジトリ] を選択します。

6. [リポジトリ] ページで、[リポジトリの作成] をクリックします。

7. [リポジトリ情報] ステップで、[名前空間]、[リポジトリ名]、[リポジトリタイプ]、[タグ]、[高速化イメージ]、[概要]、[説明] を設定し、[次へ] をクリックします。

8. [コードソース] ステップで、[コードソース]、[ビルド設定]、[ビルドルール] を設定し、[リポジトリの作成] をクリックします。

9. ビルド設定のパラメーターは次のとおりです：

   パラメーター	説明
   コード変更時のイメージ自動ビルド	有効にすると、コードがブランチにコミットされたときにビルドルールが自動的にトリガーされます。
   中国本土外にデプロイされたサーバーでのビルド	コードソースが GitHub または Bitbucket にある場合、または Dockerfile が中国以外から依存関係をダウンロードし、クロスボーダーネットワーク接続が不安定な場合は、このオプションを有効にしてください。ACR はビルド中に高速化リンクを使用して外部データソースをプルします。このオプションは特定のリージョンでのみ利用可能です。イメージリポジトリの作成時にオプションが表示されない場合、現在のリージョンはこの機能に対応していません。
   キャッシュなしのビルド	有効にすると、ACR はキャッシュされたレイヤーを無視して、毎回ソースからベースイメージをプルします。これにより、ビルドが遅くなる場合があります。このオプションを無効にすると、キャッシュされたレイヤーが使用され、ビルドが高速化されます。

   [リポジトリ] ページで、作成したイメージリポジトリをクリックします。リポジトリ管理ページの左側メニューに [ビルド] が表示されている場合、イメージリポジトリはソースコードリポジトリにバインドされています。

ステップ 4: イメージのビルド

ビルドルールを設定して、ACR がリポジトリからイメージをビルドする方法とタイミングを定義し、ビルドをトリガーして結果を検証します。

1. Container Registry コンソールにログインします。

2. 上部メニューで、リージョンを選択します。

3. 左側メニューで、[インスタンス] をクリックします。

4. [インスタンス] ページで、管理する Enterprise Edition インスタンスをクリックします。

5. インスタンス詳細ページの左側のナビゲーションウィンドウで、リポジトリ > リポジトリ を選択します。

6. [リポジトリ] ページで、作成したイメージリポジトリを見つけ、[操作] 列の [管理] をクリックします。

7. 左側メニューで、[ビルド] をクリックします。[ビルドルール] セクションで、[ビルドルールの追加] をクリックします。[ビルド情報] ステップで、次のパラメーターを設定し、[次へ] をクリックします。

   パラメーター	説明
   タイプ	ソースコードリポジトリのタイプ。有効な値：[Branch] と [Tag]。
   ブランチ/タグ	ブランチまたはタグを選択または入力します。正規表現に対応しています。たとえば、release-(?<imageTag>\w*) と入力すると、release-v1 ブランチのソースコードが更新されたときに、ACR は自動的にイメージをビルドします。名前付きキャプチャグループの詳細については、「名前付きキャプチャグループでの正規表現の使用」をご参照ください。 説明 正規表現を使用する場合、ACR のみがビルドをトリガーできます。手動ビルドはサポートされていません。
   ビルドコンテキストディレクトリ	Dockerfile を含むディレクトリ。ブランチまたはタグのルートからの相対パスで指定します。たとえば、ブランチが master で、Dockerfile がブランチのルートにある場合、これを / に設定します。
   Dockerfile 名	Dockerfile の名前。デフォルト名は Dockerfile です。

8. [タグ] ステップで、次のパラメーターを設定し、[保存] をクリックしてから、[次へ] をクリックします。

   説明

   [設定の追加] をクリックして、イメージタグを追加します。最大 3 つのイメージタグを追加できます。

   パラメーター	説明
   イメージタグ	ビルドするイメージのタグ (例：latest)。名前付きキャプチャグループに対応しています。[ブランチ/タグ] で名前付きキャプチャグループを定義した場合は、ここでキャプチャされた値を参照します。
   ビルド時間	(オプション) ソースコードがプッシュされた時刻 (UTC+8)。指定可能な形式：20201015 または 202010151613。 説明 このパラメーターを設定した場合、ACR のみがビルドをトリガーできます。手動ビルドはサポートされていません。
   コミット ID	(オプション) 最後にプッシュされたコードのコミット ID の先頭から使用する文字数。デフォルトでは、最初の 6 文字が使用されます。スライダーを調整して数を変更します。 説明 このパラメーターを設定した場合、ACR のみがビルドをトリガーできます。手動ビルドはサポートされていません。

9. [ビルド設定] ステップで、次のパラメーターを設定し、[次へ] をクリックします。

   パラメーター	説明
   ビルドアーキテクチャ	1 つ以上のターゲットアーキテクチャを選択します。複数のアーキテクチャを選択した場合、ACR は同じタグの下でアーキテクチャごとに個別のイメージを生成します。
   ビルドパラメーター	ビルドプロセスに渡されるキーと値のペア。パラメーター名では大文字と小文字が区別されます。[設定の追加] をクリックして、最大 20 個のビルドパラメーターを設定します。

10. ビルドをトリガーします：次のいずれかの方法を使用します。

    • [ビルド] ページの [ビルドルール] セクションで、ビルドルールを見つけ、[操作] 列の [ビルド] をクリックします。

    • ソースコードリポジトリの設定済みブランチにコードコミットをプッシュして、ビルドルールを自動的にトリガーします。

11. ビルドを監視します：[ビルドログ] セクションで、イメージビルドタスクを見つけ、[操作] 列の [ログ] をクリックしてビルドログを表示します。実行中のビルドを停止するには、[操作] 列の [キャンセル] をクリックします。

12. 結果を検証します：左側メニューで、[イメージタグ] をクリックします。ビルドしたイメージが一覧に表示されていれば、ビルドは成功です。

    左側メニューで、[イメージタグ] をクリックします。作成したイメージが表示されている場合、イメージがビルドされたことを示します。

例

次の 2 つの例は、一般的なビルドルールの設定を示しています。例 1 は、手動ビルドと自動ビルドの両方に対応するシンプルな設定です。例 2 は、正規表現を使用してリリースブランチ名からバージョン管理されたイメージタグを作成し、自動ビルドのみに対応します。

次のステップ