Container Registry:Enterprise Edition インスタンスを使用したコンテナイメージの構築

ステップ 1： ソースコードプラットフォームへの接続

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

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

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

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

4. [インスタンス] ページで、対象の Enterprise Edition インスタンスをクリックします。

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

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

7. [名前空間を作成] ペインで、[名前空間] 名を入力し、[リポジトリの自動作成] を [オン] または [閉じる] に設定し、[OK] をクリックします。

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

   パラメーター	説明
   リポジトリのタイプ	パブリック： デフォルトでは、パブリックイメージをプルするには Enterprise Edition インスタンスにログインする必要があります。匿名でのプルを許可する場合は、インスタンスの匿名プル設定を有効にしてください。 パブリックリポジトリのイメージは、許可されていないユーザーでもプルできるため、データセキュリティを確保するためにリポジトリを Private に設定することを推奨します。 プライベート： プライベートイメージをプルするには、Enterprise Edition インスタンスにログインし、プル権限を持つ必要があります。
   イメージバージョンは変更されません	イメージタグを [柔軟] にできるかどうかを指定します。有効にすると、このリポジトリ内の latest 以外のすべてのイメージタグは上書きできません。これにより、コンテナイメージのバージョンの一貫性が保たれます。
   高速化イメージ	リポジトリを [閉じる] にするかどうかを指定します。このオプションを選択すると、このリポジトリ内に _accelerated サフィックス付きの高速化イメージタグが自動生成されます。

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

イメージリポジトリを作成し、ソースコードリポジトリに接続します。このリポジトリには、接続されたソースコードリポジトリから構築されたすべてのイメージが保存されます。

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

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

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

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

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

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

7. [リポジトリ情報] ウィザードで、[名前空間]、[リポジトリ名]、[リポジトリのタイプ]、[イメージのバージョン]、[高速化イメージ]、[サマリー]、および [説明] を設定し、[次へ] をクリックします。

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

   パラメーター	説明
   Code source	コードソースを選択します。
   Build settings	Automatically Build Images When Code Changes： このオプションを有効にすると、ブランチにコードがコミットされた際に自動的にイメージ構築がトリガーされます。 海外のソースをインテリジェントにビルド： このオプションを有効にすると、構築プロセスで海外ソースからのデータプルに高速化リンクが使用されます。プロジェクトで GitHub または Bitbucket をコードソースとして使用している場合、または Dockerfile が海外からファイルをダウンロードしており、越境ネットワークの不安定性が発生している場合は、[海外のソースをインテリジェントにビルド] を有効にしてください。 キャッシュなしでビルド： このオプションを有効にすると、各イメージ構築時にベースイメージが強制的に再プルされ、構築時間が長くなる可能性があります。イメージ構築を高速化するには、[キャッシュなしでビルド] を無効にしてください。

   [リポジトリ] ページで、対象のイメージリポジトリをクリックします。左側のナビゲーションウィンドウに [ビルド] が表示されていれば、イメージリポジトリがソースコードリポジトリに正常に接続されています。

ステップ 4： イメージの構築

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

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

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

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

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

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

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

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

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

   説明

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

   パラメーター	説明
   イメージのバージョン	イメージタグ（例： latest）です。Branch/Tag 設定でキャプチャされた内容を名前付きキャプチャグループで使用できます。
   ビルド時間	ソースコードがプッシュされた時刻（UTC + 08:00）です。20201015 や 202010151613 などの 2 種類の形式が利用可能です。 説明 このパラメーターはオプションです。このパラメーターを選択した場合、自動構築のみがサポートされます。手動構築はサポートされていません。
   Commit ID	最新コミットの ID です。デフォルトでは先頭 6 文字が使用されます。スライダーを移動して文字数を設定できます。 説明 このパラメーターはオプションです。このパラメーターを選択した場合、自動構築のみがサポートされます。手動構築はサポートされていません。

9. [構成をビルド] ステップで、構築パラメーターを設定し、[OK] をクリックします。

   パラメーター	説明
   アーキテクチャの構築	1 つ以上の構築アーキテクチャを選択します。並列構築がサポートされており、複数のアーキテクチャ固有イメージに対応する単一のイメージタグが生成されます。
   タイプをビルド	イメージ構築時のランタイム引数で、大文字小文字を区別するキーと値のペアとして指定します。最大 20 個の構築引数を設定できます。これらの引数は Dockerfile 内の環境変数を変更でき、同じ Dockerfile から異なる結果を生成できます。

10. 構築ルールをトリガーします。

    構築ルールは、以下のいずれかの方法でトリガーできます。

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

    • ソースコードリポジトリの設定済みブランチにコードをコミットして、イメージ構築をトリガーします。

    説明

    • [ビルド] ページの [ビルドログ] セクションで、対象の構築タスクを見つけ、[操作] 列の [キャンセル] をクリックして、構築タスクをキャンセルできます。

    • [ビルド] ページの [ビルドログ] セクションで、対象の構築タスクを見つけ、[操作] 列の [ログ] をクリックして、構築プロセスのログを確認できます。

    左側のナビゲーションウィンドウで、[イメージのバージョン] をクリックします。構築されたイメージが表示されていれば、構築は成功しています。

例 1： 固定ブランチからの構築

main ブランチのソースコードが変更された場合、または手動で即時構築を開始した場合に、イメージ構築がトリガーされます。構築時の作業ディレクトリは / で、このディレクトリ内の Dockerfile という名前のファイルが使用されます。構築完了後に生成されるイメージタグは latest です。構築ルールを下図に示します。

例 2： 正規表現に一致するブランチからの構築

release- で始まるブランチのソースコードが変更されると、イメージ構築がトリガーされます。作業ディレクトリは / で、構築ファイルは作業ディレクトリ内の Dockerfile です。

たとえば、release-v1 ブランチにコード変更が加わった場合、正規表現 release-(?<imageTag>\w*) はブランチ名から v1 をキャプチャし、imageTag 変数に格納します。この変数はイメージタグとして使用されます。構築完了後の結果として生成されるイメージタグは、v1-202010151625-d4ef3dc3b77a011a5779eec7efdd45 です。構築ルールを次の図に示します。

関連操作