このページでは、GitHub リポジトリを Cloud Build に接続する方法について説明します。Cloud Build リポジトリの詳細については、Cloud Build リポジトリをご覧ください。
準備
-
Enable the Cloud Build API.
- GitHub リポジトリにソースコードを用意します。
- GitHub ソース リポジトリに、
Dockerfile
または Cloud Build 構成ファイルを配置します。 - 最初にリポジトリを Cloud Build に接続する場合は、リポジトリに対する管理者レベルの権限があることを確認してください。GitHub リポジトリの権限の詳細については、組織におけるリポジトリ権限レベルをご覧ください。
このページで
gcloud
コマンドを使用するには、Google Cloud CLI をインストールします。
GitHub リポジトリを接続する
GitHub リポジトリを Cloud Build に接続するには:
Google Cloud コンソールで [リポジトリ] ページを開きます。
上部のバーにあるプロジェクト セレクタで、Google Cloud プロジェクトを選択します。
ページ上部の [第 1 世代] タブを選択します。
[リポジトリを接続] をクリックします。
[リポジトリを接続] パネルが表示されます。
[ソースコード管理プロバイダを選択] で、[GitHub Cloud Build GitHub アプリ] を選択します。
[続行] をクリックします。
GitHub への接続を認証するか、GitHub アプリをインストールするよう求められます。まだ行っていない場合は、次の手順を実行します。
GitHub にログインしていない場合は、今すぐ GitHub にログインします。
承認ページが表示され、Google Cloud Build アプリが Google Cloud に接続できるよう承認を求められます。
[Authorize Google Cloud Build by GoogleCloudBuild] をクリックします。
[Google Cloud Build のインストール] をクリックします。
ポップアップが表示されたら、GitHub のユーザー名または組織を選択します。
ビジネスニーズに応じて、次のいずれかの項目を選択します。
All repositories - Cloud Build アプリを介して、現在と将来の GitHub リポジトリにアクセスできます。
Only select repositories - [Select repositories] プルダウンを使用し、Cloud Build アプリを介して特定のリポジトリにのみアクセスできるようにします。
後で追加のリポジトリを有効にできます。オプションとして [すべてのリポジトリ] を選択した場合、Cloud Build アプリはすべてのリポジトリへのアクセスが許可されます。ただし、このセクションで説明する手順に従って、Cloud Build を介して新しいリポジトリを接続する必要があります。
Cloud Build アプリをインストールするには、[Install] をクリックしてください。
ポップアップが閉じ、[リポジトリ] ページに移動します。
リポジトリを選択 セクションで、次のフィールドを選択します。
GitHub アカウント: Cloud Build GitHub アプリのインストールに使用された GitHub アカウント。このフィールドはあらかじめ選択されています。
リポジトリ: Cloud Build に接続するリポジトリ。
ターゲット リポジトリが 1 つ以上表示されない場合は、GitHub でリポジトリを編集 をクリックし、上記の手順を繰り返して、Cloud Build GitHub アプリ内の追加リポジトリを有効にします。
GitHub アカウントとリポジトリを選択したら、同意の免責条項を読み、横にあるチェックボックスをオンにして、提示された利用規約に同意することを表明します。
[接続] をクリックします。
(省略可)トリガーを作成 セクションの これらのリポジトリのサンプル トリガーを作成 フィールドで、トリガーを作成するリポジトリを選択します。リポジトリを選択したら、トリガーを作成 をクリックします。
[完了] をクリックします。
これで Google Cloud プロジェクトに 1 つ以上の GitHub リポジトリが接続されました。 Google Cloud コンソールの [トリガー] ページが開きます。
(省略可)認証済みの GitHub アカウントの更新
Google アカウントに関連付けられている GitHub アカウントを更新する必要がある場合は、GitHub で認証するのページに移動してください。Cloud Build Connect のリポジトリ ページに、GitHub への Cloud Build アプリのインストール後に GitHub アプリがリポジトリにインストールされていないことが示されている場合は、この操作を行うことが必要な可能性があります。
次のステップ
- GitHub からリポジトリを構築する方法を確認する。
- Compute Engine で Blue/Green デプロイを実行する方法を学習する。