Container Registry:イメージをビルドするために Container Registry Enterprise Edition インスタンスを使用する

ステップ 1: インスタンスをソースコードホスティングプラットフォームにバインドする

ステップ 2: 名前空間を作成する

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

2. 上部のナビゲーションバーで、リージョンを選択します。

3. 左側のナビゲーションウィンドウで、[インスタンス] をクリックします。

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

5. Enterprise Edition インスタンスの管理ページの左側のナビゲーションウィンドウで、[リポジトリ] > [名前空間] を選択します。

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

7. [名前空間の作成] サイドバーで、[名前空間] と [リポジトリの自動作成] を構成します。次に、[確認] をクリックします。

ステップ 3: イメージリポジトリを作成する

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

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

2. 上部のナビゲーションバーで、リージョンを選択します。

3. 左側のナビゲーションウィンドウで、[インスタンス] をクリックします。

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

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

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

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

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

   パラメータ	説明
   コードソース	コードソース。
   ビルド設定	コード変更時にイメージを自動的にビルドする: ブランチからコードがコミットされると、ビルドルールが自動的にトリガーされます。 中国本土以外にデプロイされたサーバーでビルドする: ビルドプロセス中に、ビルドは海外のデータセンターで実行され、完了すると指定されたリージョンにプッシュされます。プロジェクトの Dockerfile が外国のサイトからファイルをダウンロードする必要があるが、国境を越えたネットワーク接続が不安定な場合は、[中国本土以外にデプロイされたサーバーでビルドする] を有効にできます。 キャッシュなしでビルドする: イメージがビルドされるたびに、システムはソースコードリポジトリからベースイメージをプルします。これにより、ビルドプロセスが遅くなる可能性があります。イメージビルドを高速化するために、[キャッシュなしでビルドする] を無効にすることができます。

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

ステップ 4: イメージをビルドする

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

2. 上部のナビゲーションバーで、リージョンを選択します。

3. 左側のナビゲーションウィンドウで、[インスタンス] をクリックします。

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

5. Container Registry Enterprise Edition インスタンスの管理ページの左側のナビゲーションウィンドウで、[リポジトリ] > [リポジトリ] を選択します。

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

7. 左側のナビゲーションウィンドウで、[ビルド] をクリックします。[ビルドルール] セクションで、[ビルドルールの追加] をクリックします。「ビルドルールの追加」ウィザードの [ビルド情報] ステップで、パラメータを構成し、[次へ] をクリックします。次の表にパラメータを示します。

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

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

   説明

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

   パラメータ	説明
   [イメージタグ]	イメージのタグ。例: latest。名前付きキャプチャグループを有効にすることができます。たとえば、[ブランチ/タグ] に名前付きキャプチャグループを指定した場合、キャプチャされたコンテンツを使用できます。
   [ビルド時間]	ソースコードがプッシュされた時間 (UTC + 08:00)。例: 20201015 または 202010151613。 説明 このパラメータはオプションです。このパラメータを設定すると、システムのみがイメージをビルドできます。イメージを手動でビルドすることはできません。
   [コミット ID]	最後にプッシュされたコードのコミット ID から取得する文字数。デフォルトでは、最初の 6 文字が使用されます。スライダーを調整して文字数を変更できます。 説明 このパラメータはオプションです。このパラメータを設定すると、システムのみがイメージをビルドできます。イメージを手動でビルドすることはできません。

9. [ビルド構成] ステップで、パラメータを構成し、[確認] をクリックします。次の表にパラメータを示します。

   パラメータ	説明
   [ビルドアーキテクチャ]	イメージをビルドするアーキテクチャ。複数のアーキテクチャを選択できます。複数のアーキテクチャを選択すると、各イメージタグに対してアーキテクチャ用の複数のコンテナイメージがビルドされます。
   [ビルドパラメータ]	イメージビルドのランタイムパラメータ。各ビルドパラメータは、大文字と小文字を区別するキーと値のペアです。最大 20 個のビルドパラメータを構成できます。Dockerfile 内の環境変数を変更し、同じ Dockerfile を異なるステータスで表示するために、ビルドパラメータを設定できます。

10. イメージビルドルールをトリガーします。

    次のいずれかの方法を使用して、イメージビルドルールをトリガーできます。

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

    • ビルドルールをトリガーするために、ソースコードリポジトリの master ブランチにコードを送信します。

    説明

    • [ビルド] ページの [ビルドログ] セクションで、トリガーされたイメージビルドタスクを見つけ、[アクション] 列の [キャンセル] をクリックして、イメージビルドタスクをキャンセルします。

    • [ビルド] ページの [ビルドログ] セクションで、トリガーされたイメージビルドタスクを見つけ、[アクション] 列の [ログ] をクリックして、イメージビルドログを表示します。

    左側のナビゲーションウィンドウで、[イメージタグ] をクリックします。作成したイメージが表示されている場合、イメージはビルドされています。

例 1: main という名前のブランチに基づいてイメージをビルドする (イメージを手動でビルドできます)

[ビルド] をクリックするか、main ブランチのソースコードが更新されると、システムはイメージをビルドします。main ブランチの / ディレクトリにある Dockerfile という名前のファイルを使用して、イメージがビルドされます。作成されたイメージのタグは latest です。次の図は、ビルドルールの構成を示しています。

例 2: 正規表現に一致するブランチに基づいてイメージをビルドする (イメージを手動でビルドできません)

名前が release- で始まるブランチでソースコードが更新されると、システムは自動的にイメージをビルドします。ブランチの / ディレクトリにある Dockerfile という名前のファイルを使用して、イメージがビルドされます。

たとえば、名前が release-v1 で始まるブランチのソースコードが更新されると、release-(?<imageTag>\w*) の正規ルールは、ブランチ名で v1 をキャプチャし、v1 を imageTag 変数に送信し、イメージタグで v1 を使用します。この例では、作成されたイメージのタグは v1-202010151625-d4ef3dc3b77a011a5779eec7efdd45 です。次の図は、ビルドルールの構成を示しています。

次のステップ