Developer Connect-Proxy konfigurieren und verwenden

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 clone für Systemverbindungen stellen: Git Proxy Reader (roles/developerconnect.gitProxyReader)
  • Git-Schreibanfragen wie git push fü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

  1. Öffnen Sie in der Google Cloud Console Developer Connect.

    Zu Developer Connect

  2. Klicken Sie auf den Tab Verbindungen und dann auf den Namen der Verbindung, die Sie verwenden möchten.

  3. Klicken Sie auf der Seite Verbindungsdetails auf den Tab Zusätzliche Konfiguration.

  4. 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

  1. Öffnen Sie in der Google Cloud Console Developer Connect.

    Zu Developer Connect

  2. Klicken Sie auf den Tab Konto-Connectors und dann auf den Namen des Konto-Connectors, den Sie verwenden möchten.

  3. Klicken Sie auf der Seite Connector-Details auf den Tab Konfiguration.

  4. 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

  1. Öffnen Sie in der Google Cloud Console Developer Connect.

    Zu Developer Connect

  2. Klicken Sie auf den Tab Verbindungen und dann auf den Namen der Verbindung, die Sie verwenden möchten.

  3. Klicken Sie auf der Seite Verbindungsdetails auf den Tab Repositories.

  4. 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:

  • REGION ist die Region, in der Sie Ihren Konto-Connector erstellt haben.

  • PROJECT_ID ist die ID des Projekts, in dem Sie den Kontoverbinder erstellt haben.

  • CONNECTOR_NAME ist der Name des Kontoverbinders, in dem Sie den Git-Proxy aktiviert haben.

  • REPO_PATH ist alles nach der Domain in der Git-URL für Ihr Repository.

    Wenn die Repository-URL beispielsweise https://github.com/myusername/test-repo.git lautet, ist REPO_PATH gleich myusername/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:

  1. Konfigurieren Sie die Git-Befehlszeile so, dass der Google Cloud CLI-Anmeldedaten-Helper verwendet wird:

    git config --global credential.'https://*.developerconnect.dev'.helper gcloud.sh

  2. Senden 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_PATH
    

    Wenn 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_PATH
    
    

    Für Systemverbindungen:

    git clone https://REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAME
    

    Wenn 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_NAME
    

    Ersetzen 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.