Cloud Build を使用すると、 Google Cloud コンソールを使用してソースコード リポジトリへの接続を作成し管理できます。Developer Connect または Cloud Build リポジトリ(第 2 世代)を使用して、接続を作成、管理できます。Cloud Build リポジトリ(第 2 世代)では、 Google Cloud コンソールやトリガーを使用せずにプログラムで個別にリポジトリを構成できます。
このページでは、Cloud Build リポジトリ(第 2 世代)と Developer Connect を介してリンクされたリポジトリの概要について説明します。
Developer Connect を使用してソース プロバイダに接続する
Developer Connect を使用すると、標準化された手順とアプリを使用して、Google 以外のプロダクトや Google 以外のデベロッパー ツールを Google Cloud に接続できます。Developer Connect 接続にリンクされたリポジトリを使用するように Cloud Build を構成し、リンクされたリポジトリからビルドするトリガーを作成できます。ビルドは、commit と pull リクエストで呼び出すことができます。
Developer Connect を使用して、次のプロバイダに接続できます。
Developer Connect の詳細については、Developer Connect の概要をご覧ください。
Cloud Build リポジトリ(第 2 世代)を使用してプロバイダに接続する
Cloud Build リポジトリ(第 2 世代)では、リポジトリ接続をプログラムで作成し、管理できます。リポジトリに単一の接続を設定し、その接続の Secret Manager シークレットを使用して、リージョン間やプロジェクト間で追加の接続をプログラムで設定できます。Google Cloud コンソール、gcloud
コマンドライン ツール、API に加えて、Terraform を使用して接続を設定することもできます。Cloud Build リポジトリ(第 2 世代)を使用する場合は、リポジトリをリンクする前にホスト接続を作成する必要があります。
Cloud Build リポジトリ(第 2 世代)は、次のプロバイダで使用できます。
ビルドは、commit と pull リクエストで呼び出すことができます。ビルドは、Pub/Sub トピックまたは着信 Webhook イベントで手動で呼び出すこともできます。
リポジトリの機能
次の表では、Cloud Build 第 2 世代リポジトリと Developer Connect を介してリンクされたリポジトリに関連する機能の概要を示します。
機能 | Cloud Build リポジトリ(第 2 世代) | Developer Connect リポジトリ |
---|---|---|
ブランチの push、タグの push、pull リクエスト イベントに応答してビルドできます。 | ○ | ○ |
手動トリガーを作成できます | あり | いいえ |
Pub/Sub トリガーを作成できます | あり | いいえ |
Webhook トリガーを作成できます | あり | いいえ |
リポジトリに単一の接続を作成し、その接続の認証を使用して追加の接続を設定できます | ○ | ○ |
GitHub と GitHub Enterprise からリポジトリを接続できます | ○ | ○ |
GitLab と GitLab Enterprise Edition からリポジトリを接続できます | ○ | ○ |
Bitbucket データセンターと Bitbucket Cloud からリポジトリを接続できます | ○ | ○ |
Cloud Source Repositories からリポジトリを接続できます | いいえ | いいえ |
ホスト接続を作成せずにリポジトリをリンクできます | いいえ | いいえ |
gcloud を使用してリポジトリ接続を作成できます | ○ | ○ |
Terraform を使用してリポジトリ接続を作成、自動化できます | ○(Bitbucket データセンターと Bitbucket Cloud を除く) | いいえ |
ホスト接続とリンク リポジトリは特定のリージョン内に存在している必要があります | ○ | ○ |
リポジトリを依存関係として指定する
デフォルトでは、次のいずれかがビルドのリポジトリとして使用されます。
トリガーを使用している場合は、ビルドをトリガーするリポジトリ
gcloud builds submit
を使用して指定するリポジトリ
ただし、メインのソースコード リポジトリやビルドが依存するその他のリポジトリなど、リポジトリを依存関係として明示的に指定することはできます。
次のステップ
- Developer Connect の詳細を確認する。
- GitHub のホストとリポジトリを接続する方法を確認する。
- GitHub Enterprise ホストに接続する方法を確認する。
- GitHub Enterprise リポジトリを接続する方法を確認する。
- GitLab ホストに接続する方法を確認する。
- GitLab リポジトリに接続する方法を確認する。
- GitLab Enterprise Edition リポジトリへの接続方法を確認する。
- GitLab Enterprise Edition リポジトリへの接続方法を学習する。
- ソース リポジトリでコードを手動でビルドする方法を学習する。
- Webhook イベントに応答してビルドを自動化する方法を学習する。
- Pub/Sub イベントに応答してビルドを自動化する方法を学習する。