Configurare e utilizzare il proxy Developer Connect

Questa pagina descrive come configurare il proxy Developer Connect.

Il proxy Developer Connect migliora il modo in cui Developer Connect gestisce l'autenticazione e l'accesso di rete ai sistemi di gestione del codice sorgente (SCM), agli endpoint HTTP arbitrari e alle connessioni ai provider di strumenti per sviluppatori non Google, utilizzando i connettori di account.

Quando attivi il proxy per una connessione di sistema o un connettore dell'account, Developer Connect utilizza il server proxy per inviare richieste Git, ad esempio git clone, o chiamate API agli endpoint HTTP. Quando crei una connessione utilizzando la consoleGoogle Cloud , il proxy viene attivato per impostazione predefinita. In questo modo, devi solo concedere le autorizzazioni IAM a un utente o a un account di servizio, anziché gestire un token di accesso in Secret Manager.

Ad esempio, l'attivazione del proxy Developer Connect su una connessione ti consente di:

  • Utilizza la personalizzazione del codice di Gemini Code Assist con gli SCM in reti ospitate privatamente, incluse le reti on-premise.
  • Clona il codice sorgente da un SCM esterno utilizzando l'autenticazione Google Cloud e le autorizzazioni di Identity and Access Management.

  • Utilizza l'agente di revisione del codice Gemini con SCM in reti ospitate privatamente, incluse le reti on-premise (anteprima).

Developer Connect supporta due tipi di proxy:

  • Proxy sulle connessioni di sistema

    Il proxy di connessione di sistema include quanto segue:

    • Proxy Git

    Per le connessioni ai sistemi di gestione del codice sorgente (SCM)

    • Proxy HTTP

    Per le connessioni a endpoint HTTP arbitrari

  • Proxy per i connettori di account

    Il proxy Developer Connect può essere utilizzato con i connettori degli account.

Tutte queste funzionalità vengono attivate utilizzando la stessa impostazione.

Prima di iniziare

Assicurati di avere almeno una connessione di sistema in Developer Connect (a un SCM come GitHub, GitLab o Bitbucket o a un endpoint HTTP) o un connettore di account.

Per ottenere le autorizzazioni necessarie per configurare il proxy Developer Connect per una connessione, chiedi all'amministratore di concederti il ruolo IAM Developer Connect Admin (developerconnect.admin) per l'utente che abilita o disabilita il proxy Developer Connect. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per ottenere le autorizzazioni necessarie per inviare richieste al proxy per una connessione, chiedi all'amministratore di concederti i seguenti ruoli IAM nell'account utente o nel account di servizio che invia richieste Git:

  • Effettua richieste di lettura Git come git clone per le connessioni di sistema: Git Proxy Reader (roles/developerconnect.gitProxyReader)
  • Effettua richieste di scrittura Git come git push per le connessioni di sistema: Git Proxy User (roles/developerconnect.gitProxyUser)
  • Effettua richieste di lettura e scrittura Git per i connettori degli account: Utente OAuth del connettore dell'account (roles/developerconnect.oauthUser)

Attiva e disattiva le impostazioni del proxy Developer Connect per le connessioni di sistema

Quando crei una connessione di sistema utilizzando la console Google Cloud , il proxy viene attivato per impostazione predefinita. Quando è attiva, sono abilitati sia il proxy Git sia il proxy HTTP.

Per visualizzare e aggiornare le impostazioni del proxy, segui questi passaggi:

Console

  1. Nella console Google Cloud , apri Developer Connect.

    Vai a Developer Connect

  2. Fai clic sulla scheda Connessioni e poi sul nome della connessione che vuoi utilizzare.

  3. Nella pagina Dettagli connessione, fai clic sulla scheda Configurazione aggiuntiva.

  4. Fai clic sul pulsante di attivazione/disattivazione Proxy Developer Connect per disattivare o riattivare la funzionalità proxy Developer Connect.

    Il proxy Developer Connect è abilitato per impostazione predefinita.

Google Cloud CLI

Attiva l'impostazione del proxy Developer Connect per una connessione

Per abilitare il proxy Developer Connect per una connessione, abilita l'impostazione del proxy eseguendo il comando gcloud developer-connect connections update:

gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--git-proxy-config-enabled

Disabilita il proxy Developer Connect per una connessione

Per disattivare il proxy Developer Connect per una connessione, disattiva l'impostazione del proxy eseguendo il comando gcloud developer-connect connections update:

gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--no-git-proxy-config-enabled

Visualizza l'impostazione del proxy per una connessione

Per visualizzare i dettagli dell'impostazione del proxy Developer Connect per una connessione, esegui il comando gcloud developer-connect connections describe:

gcloud developer-connect connections describe CONNECTION_NAME \
--location=REGION

Sostituisci quanto segue:

  • CONNECTION_NAME con il nome della connessione.
  • REGION con la regione della tua connessione.

Il resto di questo documento include istruzioni solo per il proxy Git.

Attiva e disattiva le impostazioni del proxy Developer Connect per i connettori degli account

Quando crei un connettore di account utilizzando la console Google Cloud , il proxy viene attivato per impostazione predefinita. Quando è attiva, sono abilitati sia il proxy Git sia il proxy HTTP.

Per visualizzare e aggiornare le impostazioni del proxy, segui questi passaggi:

Console

  1. Nella console Google Cloud , apri Developer Connect.

    Vai a Developer Connect

  2. Fai clic sulla scheda Connettori account, quindi sul nome del connettore account che vuoi utilizzare.

  3. Nella pagina Dettagli connettore, fai clic sulla scheda Configurazione.

  4. Fai clic sul pulsante di attivazione/disattivazione Proxy Developer Connect per disattivare o riattivare la funzionalità proxy Developer Connect.

    Il proxy Developer Connect è abilitato per impostazione predefinita.

Google Cloud CLI

Abilita l'impostazione del proxy Developer Connect per un connettore di account

Per abilitare il proxy Developer Connect per un connettore di account, esegui il seguente comando:

gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
  --location=REGION \
  --proxy-config-enabled

Disabilita il proxy Developer Connect per un connettore di account

Per disabilitare il proxy Developer Connect per una connessione, esegui questo comando:

gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
  --location=REGION \
  --no-proxy-config-enabled

Visualizza l'impostazione del proxy per un connettore dell'account

Per visualizzare i dettagli dell'impostazione del proxy Developer Connect per una connessione, esegui questo comando:

gcloud alpha developer-connect account-connectors describe CONNECTOR_NAME \
  --location=REGION

Sostituisci quanto segue:

  • CONNECTOR_NAME con il nome del connettore dell'account.
  • REGION con la regione del connettore dell'account.

Trova l'URI del proxy Git

Per le connessioni di sistema

Con il proxy Developer Connect abilitato, puoi trovare l'URI del proxy Git per la connessione al sistema seguendo questi passaggi:

Console

  1. Nella console Google Cloud , apri Developer Connect.

    Vai a Developer Connect

  2. Fai clic sulla scheda Connessioni e poi sul nome della connessione che vuoi utilizzare.

  3. Nella pagina Dettagli connessione, fai clic sulla scheda Repository.

  4. Trova il repository per la tua connessione, quindi fai clic su Copia l'URL del proxy Git.

Google Cloud CLI

Per ottenere l'URI del proxy Git, esegui il comando gcloud developer-connect connections git-repository-links describe:

gcloud developer-connect connections git-repository-links describe REPOSITORY_NAME \
--connection=CONNECTION_NAME \
--location=REGION

Sostituisci quanto segue:

  • REPOSITORY_NAME con il nome del tuo repository.
  • CONNECTION_NAME con il nome della connessione.
  • REGION con la regione della tua connessione.

API Developer Connect

L'URI del proxy Git si trova nel campo git_proxy_url di GitRepositoryLink per la tua connessione.

Per i connettori di account

Con il proxy Developer Connect abilitato, puoi creare l'URI del proxy Git per il connettore dell'account utilizzando il seguente formato:

https://REGION-git.developerconnect.dev/a/PROJECT_ID/CONNECTOR_NAME/REPO_PATH

Dove:

  • REGION è la regione in cui hai creato il connettore dell'account.

  • PROJECT_ID è l'ID del progetto in cui hai creato il connettore dell'account.

  • CONNECTOR_NAME è il nome del connettore dell'account in cui hai abilitato il proxy Git.

  • REPO_PATH è tutto ciò che segue il dominio nell'URL Git del tuo repository.

    Ad esempio, se l'URL del repository è https://github.com/myusername/test-repo.git, REPO_PATH è myusername/test-repo.

Invia richieste al proxy Git

Una volta ottenuto l'URI del proxy Git, puoi inviare richieste al proxy Git procedendo nel seguente modo:

  1. Configura l'interfaccia a riga di comando Git in modo da utilizzare l'helper per le credenziali di Google Cloud CLI:

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

  2. Invia una richiesta al proxy Git. Questo esempio è una richiesta git clone.

    Per i connettori di account:

    git clone https://REGION-git.developerconnect.dev/a/PROJECT_ID/ACCOUNT_CONNECTOR_NAME/REPO_PATH
    

    Se non vuoi utilizzare un helper per le credenziali, puoi incorporare il token di accesso cloud nella richiesta:

    git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/a/PROJECT_ID/ACCOUNT_CONNECTOR_NAME/REPO_PATH
    
    

    Per le connessioni di sistema:

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

    Se non vuoi utilizzare un helper per le credenziali, puoi incorporare il token di accesso cloud nella richiesta:

    git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAME
    

    Sostituisci quanto segue:

    • REGION con la regione del connettore dell'account.
    • PROJECT_ID con l'ID del progetto in cui hai creato il connettore dell'account.
    • ACCOUNT_CONNECTOR_NAME con il nome del connettore dell'account.
    • CONNECTION_NAME con il nome della connessione di sistema.
    • REPOSITORY_NAME con il nome del tuo repository.
    • REPO_PATH con il percorso del tuo repository, ad esempio my-org/my-repo.