Cloud Build を使用してビルドを自動化する

このページでは、Cloud Build を使用してビルドを自動化する方法について説明します。

Cloud Build は、ビルドトリガーを使用して CI / CD の自動化を有効にします。新しい commit がリポジトリに push されたときや、pull リクエストが開始されたときなどでの受信イベントをリッスンし、新しいイベントが生じたときにビルドを自動的に呼び出すようにトリガーを構成できます。

トリガーを作成し、GitHub リポジトリに変更を push するたびにビルドを呼び出すようにトリガーを構成します。

このタスクを Cloud Shell エディタで直接行う際のガイダンスについては、「ガイドを表示」をクリックしてください。

ガイドを表示

始める前に

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Cloud Build API を有効にします。

API を有効にする

Google Cloud CLI をインストールします。

gcloud CLI を初期化するには:

gcloud init

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Cloud Build API を有効にします。

API を有効にする

Google Cloud CLI をインストールします。

gcloud CLI を初期化するには:

gcloud init

まだインストールしていない場合は、GitHub でアカウントを作成してください。
GitHub で 2 要素認証を設定している場合は、コマンドラインで GitHub パスワードの代わりに使用する個人用のアクセストークンを作成します。

サンプル GitHub リポジトリをフォークしてクローンを作成する

ビルドするサンプルソースコードが必要です。このセクションでは、Go の Hello World のサンプルを含む既存のソースリポジトリのクローンを、独自の GitHub ユーザーアカウントに作成します。

まだインストールしていない場合は、GitHub でアカウントを作成してください。
GitHub で 2 要素認証を設定している場合は、コマンドラインで GitHub パスワードの代わりに使用する個人用のアクセストークンを作成します。
cloud-build-samples リポジトリを自分の GitHub アカウントにフォークします。
1. Cloud Build の cloud-build-samples リポジトリに移動します。
2. ページの右上にあるフォーク アイコンをクリックします。
3. リポジトリのフォーク先の GitHub ユーザーアカウントをクリックします。
  
  フォークされた cloud-build-samples リポジトリのバージョンのページに自動的にリダイレクトされます。
ローカル環境でターミナルを開きます。
次のコマンドを実行して、フォークされたリポジトリのクローンを作成します。ここで、GITHUB_USERNAME は、GitHub アカウントのユーザー名です。
```
git clone https://github.com/GITHUB_USERNAME/cloud-build-samples.git
```

Cloud Build を自分のリポジトリに接続する

トリガーを使用して GitHub でソースコードをビルドするには、まず Cloud Build を GitHub リポジトリに接続する必要があります。このセクションでは、cloud-build-samples リポジトリを Cloud Build に接続します。

Google Cloud Console のナビゲーションメニューで、[Cloud Build] > [トリガー] をクリックします。

[トリガー] ページを開く
プロジェクトを選択し、[開く] をクリックします。
[リポジトリを接続] をクリックします。
[ソースを選択] で、[GitHub（Cloud Build GitHub アプリ）] を選択します。
[続行] をクリックします。
GitHub アカウントを認証します。
[リポジトリを選択] セクションで、[GitHub アカウント] のユーザー名を選択します。自分のユーザー名がリストに表示されていない場合は、次のようにします。
1. [GitHub アカウント] リストで、[+ 追加] をクリックします。
  
  Cloud Build GitHub アプリをインストールするためのポップアップが表示されます。
2. 自分の GitHub ユーザー名をクリックします。
3. [Only certain repositories] をクリックして、特定のリポジトリに Cloud Build GitHub アプリをインストールします。
4. プルダウンメニューで、[GITHUB_USERNAME/cloud-build-samples] を選択します。ここで、GITHUB_USERNAME は GitHub アカウントのユーザー名です。
5. [Install] をクリックします。
  
  続行する前に、GitHub アカウントに関連付けられているパスワードの入力を求められることがあります。
6. Cloud Build GitHub アプリをインストールした後、[GitHub アカウント] フィールドのプルダウンメニューに自分のユーザー名が表示されます。ユーザー名を選択します。
[リポジトリ] で、リポジトリとして [GITHUB_USERNAME/cloud-build-samples] を選択します。
チェックマークをクリックして、トリガー接続の利用規約に同意します。
[接続] をクリックします。
[完了] をクリックします。

トリガーは、次のセクションで作成します。

トリガーを作成する

Google Cloud Console で [トリガー] ページを開きます。

[トリガー] ページを開く
ページの上部にあるプロジェクトセレクタのプルダウンメニューからプロジェクトを選択します。
[開く] をクリックします。
[トリガー] ページで、[トリガーを作成] をクリックします。
[トリガーの作成] ページで、次の設定を入力します。
- 名前: トリガーの名前として「hello-world-trigger」と入力します。
- イベント: トリガーを呼び出すリポジトリイベントとして [ブランチに push する] を選択します。
- ソース: ソースとして cloud-build-samples リポジトリを選択します。このリポジトリにはソースコードとビルド構成ファイルが含まれています。
- ビルド構成: ビルド構成ファイルとして [Cloud Build 構成ファイル] を選択します。
- Cloud Build 構成ファイルの場所: Cloud Build 構成ファイルへのパスとして quickstart-automate/cloudbuild.yaml を指定します。
[作成] をクリックして、ビルドトリガーを保存します。

変更を commit する

このセクションでは、独自の GitHub アカウントにクローン作成した cloud-build-samples リポジトリに変更を commit します。

ターミナルで quickstart-automate ディレクトリに移動します。
```
cd cloud-build-samples/quickstart-automate
```

main.go ファイルを開き、「Hello, world!」を含む行を「Hello, universe!」に更新します。

  package main

  import (
      "fmt"
  )

  func main() {
      fmt.Println("Hello, universe!")
  }

Cloud Build で使用されるビルド構成ファイルである cloudbuild.yaml を確認します。トリガーによってビルドを呼び出すと、このファイルのビルドステップは、Docker Hub の golang イメージを使用して main.go のビルドと実行を行うように Cloud Build に指示します。
```
   steps:
   - name: golang
     script: go run quickstart-automate/main.go
   
```
リポジトリのルートディレクトリに戻ります。
```
   cd ..
```
次のコマンドを実行して、変更を GitHub に commit します。
```
    
    git add quickstart-automate/main.go
    git commit -m "update text"
    git push
```
コードをリポジトリに push するときに、認証情報の入力を求められることがあります。プロンプトが表示されたら、ユーザー名とパスワードまたは認証トークンを入力します。

これで、変更がリポジトリに push されました。push することで、トリガーによって自動ビルドが行われます。

ビルドの詳細を表示

このセクションでは、変更の commit 後に、呼び出されたビルドに関連付けられたビルドの詳細を表示します。

Google Cloud Console のナビゲーションメニューで、[Cloud Build] > [履歴] をクリックします。

Cloud Build ページを開く
プロジェクトを選択し、[開く] をクリックします。

[ビルド履歴] ページが表示されます。
[ビルド] 列で、ビルドの名前をクリックします。
[ビルドの詳細] ページで、[ビルドアーティファクト] をクリックします。

出力は次のようになります。
ビルドログを見るには、ダウンロードアイコンをクリックし、ダウンロードされたファイルを開きます。

トリガーを使用して Cloud Build のビルドが正常に呼び出され、ビルドの詳細を表示しました。

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。

Google Cloud Console のナビゲーションメニューで、[Cloud Build] > [トリガー] をクリックします。

[トリガー] ページを開く
プロジェクトを選択し、[開く] をクリックします。
hello-world-trigger 行の右端にある [アクションメニュー]（縦三点リーダー）をクリックします。
[削除] を選択します。

これで、クローンされたリポジトリに関連付けられているトリガーが削除されました。

次のステップ

基本的なビルド構成ファイルを作成する方法を学習する。
ビルドトリガーを作成および管理する方法を学習する。