Auf dieser Seite wird beschrieben, wie Sie den Developer Connect-Proxy konfigurieren.
Der Developer Connect-Proxy verbessert die Art und Weise, wie Developer Connect die Authentifizierung und den Netzwerkzugriff auf Quellcode-Verwaltungssysteme (SCMs), beliebige HTTP-Endpunkte und Verbindungen zu Anbietern von nicht von Google stammenden Entwicklertools mithilfe von Kontoverbindern verarbeitet.
Wenn Sie den Proxy für eine Systemverbindung oder einen Kontoverbinder aktivieren, verwendet Developer Connect den Proxyserver, um Git-Anfragen wie git clone oder API-Aufrufe an HTTP-Endpunkte zu senden. Wenn Sie eine Verbindung über dieGoogle Cloud -Konsole erstellen, ist der Proxy standardmäßig aktiviert. So müssen Sie nur einem Nutzer oder Dienstkonto IAM-Berechtigungen gewähren, anstatt ein Zugriffstoken in Secret Manager zu verwalten.
Wenn Sie beispielsweise den Developer Connect-Proxy für eine Verbindung aktivieren, können Sie Folgendes tun:
- Verwenden Sie die Codeanpassung von Gemini Code Assist mit SCMs in privat gehosteten Netzwerken, einschließlich lokaler Netzwerke.
Klonen Sie Quellcode aus einem externen SCM mit Google Cloud Authentifizierung und Identity and Access Management-Berechtigungen.
Verwenden Sie den Gemini Code Review-Agenten mit SCMs in privat gehosteten Netzwerken, einschließlich lokaler Netzwerke (Vorabversion).
Developer Connect unterstützt zwei Arten von Proxys:
Proxy für Systemverbindungen
Der Systemverbindungsproxy umfasst Folgendes:
- Git-Proxy
Für Verbindungen zu Quellcode-Verwaltungssystemen (SCMs)
- HTTP-Proxy
Für Verbindungen zu beliebigen HTTP-Endpunkten
Proxy für Konto-Connectors
Der Developer Connect-Proxy kann mit Kontoverbindern verwendet werden.
Alle diese Funktionen werden über dieselbe Einstellung aktiviert.
Hinweis
Sie benötigen mindestens eine Systemverbindung in Developer Connect (zu einem SCM wie GitHub, GitLab oder Bitbucket oder zu einem HTTP-Endpunkt) oder einen Konto-Connector.
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Developer Connect-Administrator“ (developerconnect.admin) für den Nutzer zuzuweisen, der den Developer Connect-Proxy aktiviert oder deaktiviert, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren des Developer Connect-Proxys für eine Verbindung benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Nutzerkonto oder Dienstkonto zuzuweisen, das Git-Anfragen ausgibt, um die Berechtigungen zu erhalten, die Sie zum Senden von Anfragen an den Proxy für eine Verbindung benötigen:
-
Git-Leseanfragen wie
git clonefür Systemverbindungen stellen: Git Proxy Reader (roles/developerconnect.gitProxyReader) -
Git-Schreibanfragen wie
git pushfür Systemverbindungen stellen: Git-Proxy-Nutzer (roles/developerconnect.gitProxyUser) -
Git-Lese- und -Schreibanfragen für Account Connectors stellen: Account Connector OAuth User (
roles/developerconnect.oauthUser)
Developer Connect-Proxy-Einstellungen für Systemverbindungen aktivieren und deaktivieren
Wenn Sie eine Systemverbindung über die Google Cloud Console erstellen, ist der Proxy standardmäßig aktiviert. Wenn diese Option aktiviert ist, sind sowohl der Git-Proxy als auch der HTTP-Proxy aktiviert.
So rufen Sie die Proxy-Einstellungen auf und aktualisieren sie:
Console
Öffnen Sie in der Google Cloud Console Developer Connect.
Klicken Sie auf den Tab Verbindungen und dann auf den Namen der Verbindung, die Sie verwenden möchten.
Klicken Sie auf der Seite Verbindungsdetails auf den Tab Zusätzliche Konfiguration.
Klicken Sie auf den Ein/Aus-Button Developer Connect-Proxy, um die Developer Connect-Proxy-Funktion zu deaktivieren oder wieder zu aktivieren.
Der Developer Connect-Proxy ist standardmäßig aktiviert.
Google Cloud CLI
Developer Connect-Proxy-Einstellung für eine Verbindung aktivieren
Wenn Sie den Developer Connect-Proxy für eine Verbindung aktivieren möchten, aktivieren Sie die Proxy-Einstellung mit dem Befehl gcloud developer-connect connections update:
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--git-proxy-config-enabled
Developer Connect-Proxy für eine Verbindung deaktivieren
Wenn Sie den Developer Connect-Proxy für eine Verbindung deaktivieren möchten, deaktivieren Sie die Proxy-Einstellung mit dem Befehl gcloud developer-connect connections update:
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--no-git-proxy-config-enabled
Proxy-Einstellung für eine Verbindung ansehen
Führen Sie den Befehl gcloud developer-connect connections describe aus, um Details zur Developer Connect-Proxy-Einstellung für eine Verbindung aufzurufen:
gcloud developer-connect connections describe CONNECTION_NAME \
--location=REGION
Ersetzen Sie Folgendes:
- CONNECTION_NAME durch den Namen Ihrer Verbindung.
- REGION durch die Region Ihrer Verbindung.
Der Rest dieses Dokuments enthält nur eine Anleitung für den Git-Proxy.
Developer Connect-Proxy-Einstellungen für Konto-Connectors aktivieren und deaktivieren
Wenn Sie einen Account Connector über die Google Cloud Console erstellen, ist der Proxy standardmäßig aktiviert. Wenn diese Option aktiviert ist, sind sowohl der Git-Proxy als auch der HTTP-Proxy aktiviert.
So rufen Sie die Proxy-Einstellungen auf und aktualisieren sie:
Console
Öffnen Sie in der Google Cloud Console Developer Connect.
Klicken Sie auf den Tab Konto-Connectors und dann auf den Namen des Konto-Connectors, den Sie verwenden möchten.
Klicken Sie auf der Seite Connector-Details auf den Tab Konfiguration.
Klicken Sie auf den Ein/Aus-Button Developer Connect-Proxy, um die Developer Connect-Proxy-Funktion zu deaktivieren oder wieder zu aktivieren.
Der Developer Connect-Proxy ist standardmäßig aktiviert.
Google Cloud CLI
Developer Connect-Proxy-Einstellung für einen Account Connector aktivieren
Führen Sie den folgenden Befehl aus, um den Developer Connect-Proxy für einen Konto-Connector zu aktivieren:
gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
--location=REGION \
--proxy-config-enabled
Developer Connect-Proxy für einen Account Connector deaktivieren
Führen Sie den folgenden Befehl aus, um den Developer Connect-Proxy für eine Verbindung zu deaktivieren:
gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
--location=REGION \
--no-proxy-config-enabled
Proxy-Einstellung für einen Konto-Connector aufrufen
Führen Sie den folgenden Befehl aus, um Details zur Developer Connect-Proxy-Einstellung für eine Verbindung aufzurufen:
gcloud alpha developer-connect account-connectors describe CONNECTOR_NAME \
--location=REGION
Ersetzen Sie Folgendes:
- CONNECTOR_NAME durch den Namen Ihres Kontoverbinders.
- REGION durch die Region Ihres Konto-Connectors.
Git-Proxy-URI ermitteln
Für Systemverbindungen
Wenn der Developer Connect-Proxy aktiviert ist, können Sie den Git-Proxy-URI für Ihre Systemverbindung so ermitteln:
Console
Öffnen Sie in der Google Cloud Console Developer Connect.
Klicken Sie auf den Tab Verbindungen und dann auf den Namen der Verbindung, die Sie verwenden möchten.
Klicken Sie auf der Seite Verbindungsdetails auf den Tab Repositories.
Suchen Sie das Repository für Ihre Verbindung und klicken Sie dann auf Git-Proxy-URL kopieren.
Google Cloud CLI
Führen Sie den Befehl gcloud developer-connect connections git-repository-links describe aus, um den Git-Proxy-URI abzurufen:
gcloud developer-connect connections git-repository-links describe REPOSITORY_NAME \
--connection=CONNECTION_NAME \
--location=REGION
Ersetzen Sie Folgendes:
- REPOSITORY_NAME durch den Namen Ihres Repositorys.
- CONNECTION_NAME durch den Namen Ihrer Verbindung.
- REGION durch die Region Ihrer Verbindung.
Developer Connect API
Der Git-Proxy-URI befindet sich im Feld git_proxy_url des GitRepositoryLink für Ihre Verbindung.
Für Konto-Connectors
Wenn der Developer Connect-Proxy aktiviert ist, können Sie den Git-Proxy-URI für Ihren Konto-Connector im folgenden Format erstellen:
https://REGION-git.developerconnect.dev/a/PROJECT_ID/CONNECTOR_NAME/REPO_PATH
Wobei:
REGIONist die Region, in der Sie Ihren Konto-Connector erstellt haben.PROJECT_IDist die ID des Projekts, in dem Sie den Kontoverbinder erstellt haben.CONNECTOR_NAMEist der Name des Kontoverbinders, in dem Sie den Git-Proxy aktiviert haben.REPO_PATHist alles nach der Domain in der Git-URL für Ihr Repository.Wenn die Repository-URL beispielsweise
https://github.com/myusername/test-repo.gitlautet, istREPO_PATHgleichmyusername/test-repo.
Anfragen an den Git-Proxy senden
Nachdem Sie den Git-Proxy-URI erhalten haben, können Sie Anfragen an den Git-Proxy senden. Gehen Sie dazu so vor:
Konfigurieren Sie die Git-Befehlszeile so, dass der Google Cloud CLI-Anmeldedaten-Helper verwendet wird:
git config --global credential.'https://*.developerconnect.dev'.helper gcloud.shSenden Sie eine Anfrage an den Git-Proxy. Dieses Beispiel ist eine
git clone-Anfrage.Für Konto-Connectors:
git clone https://REGION-git.developerconnect.dev/a/PROJECT_ID/ACCOUNT_CONNECTOR_NAME/REPO_PATHWenn Sie keinen Credential Helper verwenden möchten, können Sie das Cloud-Zugriffstoken stattdessen in die Anfrage einbetten:
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/a/PROJECT_ID/ACCOUNT_CONNECTOR_NAME/REPO_PATHFür Systemverbindungen:
git clone https://REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAMEWenn Sie keinen Credential Helper verwenden möchten, können Sie das Cloud-Zugriffstoken stattdessen in die Anfrage einbetten:
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAMEErsetzen Sie Folgendes:
- REGION durch die Region Ihres Konto-Connectors.
- PROJECT_ID durch die ID des Projekts, in dem Sie den Konto-Connector erstellt haben.
- ACCOUNT_CONNECTOR_NAME durch den Namen Ihres Kontoverbinders.
- CONNECTION_NAME durch den Namen Ihrer Systemverbindung.
- REPOSITORY_NAME durch den Namen Ihres Repositorys.
- REPO_PATH durch den Pfad zu Ihrem Repository, z. B.
my-org/my-repo.