このページでは、Developer Connect プロキシを構成する方法について説明します。
Developer Connect プロキシは、アカウント コネクタを使用して、Developer Connect がソースコード管理システム(SCM)、任意の HTTP エンドポイント、Google 以外のデベロッパー ツールのプロバイダへの接続に対する認証とネットワーク アクセスを処理する方法を強化します。
システム接続またはアカウント コネクタでプロキシを有効にすると、Developer Connect はプロキシ サーバーを使用して、git clone などの Git リクエストや HTTP エンドポイントへの API 呼び出しを発行します。Google Cloud コンソールを使用して接続を作成すると、プロキシはデフォルトで有効になります。この方法では、Secret Manager でアクセス トークンを管理する代わりに、ユーザーまたはサービス アカウントに IAM 権限を付与するだけで済みます。
たとえば、接続で Developer Connect プロキシを有効にすると、次のことができます。
- オンプレミス ネットワークを含む、プライベートにホストされたネットワークの SCM で Gemini Code Assist のコードのカスタマイズを使用する。
Google Cloud 認証と Identity and Access Management 権限を使用して、外部 SCM からソースコードのクローンを作成します。
オンプレミス ネットワーク(プレビュー)など、プライベートにホストされたネットワークで SCM と Gemini コードレビュー エージェントを使用する。
Developer Connect は、次の 2 種類のプロキシをサポートしています。
システム接続のプロキシ
システム接続プロキシには、次のものが含まれます。
- Git プロキシ
ソースコード管理システム(SCM)への接続
- HTTP プロキシ
任意の HTTP エンドポイントへの接続
アカウント コネクタのプロキシ
Developer Connect プロキシは、アカウント コネクタで使用できます。
これらはすべて同じ設定を使用して有効にできます。
始める前に
Developer Connect に少なくとも 1 つのシステム接続(GitHub、GitLab、Bitbucket などの SCM、または HTTP エンドポイントへの接続)またはアカウント コネクタがあることを確認します。
接続に Developer Connect プロキシを構成するために必要な権限を取得するには、Developer Connect プロキシを有効または無効にするユーザーに Developer Connect 管理者(developerconnect.admin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
接続のためにプロキシにリクエストを発行するために必要な権限を取得するには、Git リクエストを発行するユーザー アカウントまたはサービス アカウントに次の IAM ロールを付与するよう管理者に依頼してください。
-
システム接続に
git cloneなどの Git 読み取りリクエストを行う: Git プロキシ読み取り(roles/developerconnect.gitProxyReader) -
システム接続に対して
git pushなどの Git 書き込みリクエストを行う: Git プロキシ ユーザー(roles/developerconnect.gitProxyUser) -
アカウント コネクタの Git 読み取り / 書き込みリクエストを行う: アカウント コネクタ OAuth ユーザー(
roles/developerconnect.oauthUser)
システム接続の Developer Connect プロキシ設定を有効または無効にする
Google Cloud コンソールを使用してシステム接続を作成すると、プロキシはデフォルトで有効になります。有効にすると、Git プロキシと HTTP プロキシの両方が有効になります。
プロキシ設定を表示して更新するには、次の操作を行います。
コンソール
Google Cloud コンソールで Developer Connect を開きます。
[接続] タブをクリックし、使用する接続の名前をクリックします。
[接続の詳細] ページで、[追加構成] タブをクリックします。
[Developer Connect プロキシ] 切り替えボタンをクリックして、Developer Connect プロキシ機能を無効にするか、再度有効にします。
Developer Connect プロキシはデフォルトで有効になっています。
Google Cloud CLI
接続の Developer Connect プロキシ設定を有効にする
接続で Developer Connect プロキシを有効にするには、gcloud developer-connect connections update コマンドを実行してプロキシ設定を有効にします。
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--git-proxy-config-enabled
接続の Developer Connect プロキシを無効にする
接続の Developer Connect プロキシを無効にするには、gcloud developer-connect connections update コマンドを実行してプロキシ設定を無効にします。
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--no-git-proxy-config-enabled
接続のプロキシ設定を表示する
接続の Developer Connect プロキシ設定の詳細を表示するには、gcloud developer-connect connections describe コマンドを実行します。
gcloud developer-connect connections describe CONNECTION_NAME \
--location=REGION
次のように置き換えます。
- CONNECTION_NAME は、接続の名前に置き換えます。
- REGION は、接続のリージョンに置き換えます。
このドキュメントの残りの部分では、Git プロキシのみの手順について説明します。
アカウント コネクタの Developer Connect プロキシ設定を有効または無効にする
Google Cloud コンソールを使用してアカウント コネクタを作成すると、プロキシはデフォルトで有効になります。有効にすると、Git プロキシと HTTP プロキシの両方が有効になります。
プロキシ設定を表示して更新するには、次の操作を行います。
コンソール
Google Cloud コンソールで Developer Connect を開きます。
[アカウント コネクタ] タブをクリックし、使用するアカウント コネクタの名前をクリックします。
[コネクタの詳細] ページで、[構成] タブをクリックします。
[Developer Connect プロキシ] 切り替えボタンをクリックして、Developer Connect プロキシ機能を無効にするか、再度有効にします。
Developer Connect プロキシはデフォルトで有効になっています。
Google Cloud CLI
アカウント コネクタの Developer Connect プロキシ設定を有効にする
アカウント コネクタで Developer Connect プロキシを有効にするには、次のコマンドを実行します。
gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
--location=REGION \
--proxy-config-enabled
アカウント コネクタの Developer Connect プロキシを無効にする
接続の Developer Connect プロキシを無効にするには、次のコマンドを実行します。
gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
--location=REGION \
--no-proxy-config-enabled
アカウント コネクタのプロキシ設定を表示する
接続の Developer Connect プロキシ設定の詳細を表示するには、次のコマンドを実行します。
gcloud alpha developer-connect account-connectors describe CONNECTOR_NAME \
--location=REGION
次のように置き換えます。
- CONNECTOR_NAME は、アカウント コネクタの名前に置き換えます。
- REGION は、アカウント コネクタのリージョンに置き換えます。
Git プロキシ URI を確認する
システム接続の場合
Developer Connect プロキシが有効になっている場合、次の操作を行うことで、システム接続の Git プロキシ URI を確認できます。
コンソール
Google Cloud コンソールで Developer Connect を開きます。
[接続] タブをクリックし、使用する接続の名前をクリックします。
[接続の詳細] ページで、[リポジトリ] タブをクリックします。
接続のリポジトリを見つけて、[Git プロキシ URL をコピー] をクリックします。
Google Cloud CLI
Git プロキシ URI を取得するには、gcloud developer-connect connections git-repository-links describe コマンドを実行します。
gcloud developer-connect connections git-repository-links describe REPOSITORY_NAME \
--connection=CONNECTION_NAME \
--location=REGION
次のように置き換えます。
- REPOSITORY_NAME は、リポジトリの名前に置き換えます。
- CONNECTION_NAME は、接続の名前に置き換えます。
- REGION は、接続のリージョンに置き換えます。
Developer Connect API
Git プロキシ URI は、接続の GitRepositoryLink の git_proxy_url フィールドにあります。
アカウント コネクタの場合
Developer Connect プロキシを有効にすると、次の形式でアカウント コネクタの Git プロキシ URI を作成できます。
https://REGION-git.developerconnect.dev/a/PROJECT_ID/CONNECTOR_NAME/REPO_PATH
ここで
REGIONは、アカウント コネクタを作成したリージョンです。PROJECT_IDは、アカウント コネクタを作成したプロジェクトの ID です。CONNECTOR_NAMEは、Git プロキシを有効にしたアカウント コネクタの名前です。REPO_PATHは、リポジトリの Git URL のドメイン以降の部分です。たとえば、リポジトリの URL が
https://github.com/myusername/test-repo.gitの場合、REPO_PATHはmyusername/test-repoです。
Git プロキシにリクエストを発行する
Git プロキシ URI を取得したら、次の操作を行って Git プロキシにリクエストを送信できます。
Google Cloud CLI 認証情報ヘルパーを使用するように Git CLI を構成します。
git config --global credential.'https://*.developerconnect.dev'.helper gcloud.shGit プロキシにリクエストを発行します。この例は
git cloneリクエストです。アカウント コネクタの場合:
git clone https://REGION-git.developerconnect.dev/a/PROJECT_ID/ACCOUNT_CONNECTOR_NAME/REPO_PATH認証情報ヘルパーを使用しない場合は、代わりにクラウド アクセス トークンをリクエストに埋め込むことができます。
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/a/PROJECT_ID/ACCOUNT_CONNECTOR_NAME/REPO_PATHシステム接続の場合:
git clone https://REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAME認証情報ヘルパーを使用しない場合は、代わりにクラウド アクセス トークンをリクエストに埋め込むことができます。
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAME次のように置き換えます。
- REGION は、アカウント コネクタのリージョンに置き換えます。
- PROJECT_ID は、アカウント コネクタを作成したプロジェクトの ID に置き換えます。
- ACCOUNT_CONNECTOR_NAME は、アカウント コネクタの名前に置き換えます。
- CONNECTION_NAME は、システム接続の名前に置き換えます。
- REPOSITORY_NAME は、リポジトリの名前に置き換えます。
- REPO_PATH は、リポジトリのパス(
my-org/my-repoなど)に置き換えます。