コミュニティ提供のビルダーとカスタム ビルダーの使用

このページでは、Cloud Build でコミュニティ提供のビルダーとカスタム ビルダーを使用する方法について説明します。Cloud Build のデベロッパー コミュニティから、タスク実行のために使用できるオープンソースのビルダーが提供されています。実行するタスクに既存のイメージでは提供されない機能が必要な場合は、独自のカスタム イメージをビルドしてビルドステップで使用できます。さまざまな種類のビルダーの詳細については、クラウド ビルダーをご覧ください。

Cloud Build を初めて使用する場合は、最初にクイックスタートとビルド構成の概要をご覧ください。

コミュニティ提供のビルダーの使用

事前にビルドされたイメージは、コミュニティ提供のビルダーでは使用できません。これらのビルダーを Cloud Build 構成ファイルで使用するには、まずイメージをビルドし、プロジェクトの Container Registry に push する必要があります。

注意: Container Registry は非推奨で、提供終了となります。2024 年 1 月 8 日より前に Container Registry を使用していない組織では、デフォルトで Artifact Registry に新しい gcr.io リポジトリがホストされます。2024 年 5 月 15 日以降、以前に Container Registry を使用していない Google Cloud プロジェクトでは、Artifact Registry で gcr.io ドメインのイメージのホスティングと管理のみがサポートされます。

Container Registry は 2025 年 3 月 18 日に提供終了となる予定です。サポート終了の詳細については、Container Registry のサポート終了をご覧ください。

コミュニティ提供のビルダーを使用するには:

1. ビルダーをビルドして push します。

   1. プロジェクトのルート ディレクトリに移動します。

   2. cloud-builders-community リポジトリのクローンを作成します。

      git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git
      

   3. 使用するビルダー イメージに移動します。ここで、builder-name はビルダーを含むディレクトリです。

      cd cloud-builders-community/builder-name
      

   4. ビルダーをプロジェクトに送信します。

      gcloud builds submit .
      

   5. プロジェクトのルート ディレクトリに戻ります。

      cd ../..
      

   6. ルート ディレクトリからリポジトリを削除します。

      rm -rf cloud-builders-community/
      

2. Cloud Build 構成ファイルで、ビルドステップでビルダーを使用します。

   YAML

   steps:
   - name: 'gcr.io/project-id/builder-name'
     args: ['arg1', 'arg2', ...]
   ...
   

   JSON

   {
     "steps": [
     {
       "name": "gcr.io/project-id/builder-name",
       "args": [
         "arg1",
         "arg2",
         ...
       ]
       ...
     }
     ]
   }
   

3. ビルド構成ファイルを使用して手動でビルドを開始するか、トリガーでビルドします。

コミュニティ提供のビルダーの使用例については、Firebase にデプロイすると Packer を使用した VM イメージのビルドをご覧ください。

カスタム ビルダーの作成

実行するタスクに公開イメージ、サポート対象のビルダーまたはコミュニティ提供のビルダーで提供されない機能が必要な場合は、独自のイメージをビルドしてビルドステップで使用できます。

カスタム ビルダー イメージを使用する例を次に示します。

• 外部のロケーションからのソースコードまたはパッケージのダウンロード
• 外部ツールチェーンの使用
• 必要なライブラリのキャッシュ
• ソースの事前ビルド（ビルドをイメージにパッケージングする部分のみを受け持つ Cloud Build を使用）

他のビルダーと同様に、カスタム ビルダーは /workspace の下にマウントされたソースで実行され、/workspace の作業ディレクトリで実行されます。特定のビルドステップで /workspace に残されたファイルは、他のビルドステップでも使用できます。

カスタム ビルダーは、Cloud Build サービス アカウントがアクセスできる Container Registry（gcr.io/$PROJECT-NAME/ でホストされています）内のリポジトリに対して push または pull できます。

次の手順は、Dockerfile の例でカスタム ビルダーを作成して使用する方法を示しています。

1. 次のカスタム ビルダー イメージを作成します。

   1. カスタム ビルダーの Dockerfile を作成します。次のコードは、Dockerfile の例を示しています。

        FROM alpine
        RUN apk add curl
        CMD curl https://httpbin.org/ip -s > myip.txt; echo "*** My IP is: $(cat myip.txt)"
      

   2. project-id と image-name の値を置き換えて、カスタム ビルダーをビルドしてプロジェクトの Container Registry に push します。

        gcloud builds submit --tag gcr.io/project-id/image-name
      

2. ビルドステップの name フィールドにビルダーを指定して、Cloud Build のカスタム ビルダー イメージを使用します。

   YAML

       steps:
       - name: 'gcr.io/project-id/image-name'
         id: Determine IP of this build worker
   

   JSON

       {
         "steps": [
         {
           "name": "gcr.io/project-id/image-name",
           "id": "Determine IP of this build worker"
         }
         ]
       }
   

3. ビルド構成ファイルを使用して手動でビルドを開始するか、トリガーでビルドします。

注: ユーザーはビルド構成ファイルの dir フィールドを使用して作業ディレクトリを指定できます。カスタム ビルダーのユーザーは任意の dir 値を指定できるため、可能な限り /workspace をハードコードすることは避けてください。代わりに、現在の作業ディレクトリと相対パスを使用します。

次のステップ

• ビルドステップで bash スクリプトを実行する方法を学習する。
• ビルドステップの順序を構成する方法を学習する。
• 基本的なビルド構成ファイルを作成する方法を学習する。