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 cloneper le connessioni di sistema: Git Proxy Reader (roles/developerconnect.gitProxyReader) -
Effettua richieste di scrittura Git come
git pushper 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
Nella console Google Cloud , apri Developer Connect.
Fai clic sulla scheda Connessioni e poi sul nome della connessione che vuoi utilizzare.
Nella pagina Dettagli connessione, fai clic sulla scheda Configurazione aggiuntiva.
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
Nella console Google Cloud , apri Developer Connect.
Fai clic sulla scheda Connettori account, quindi sul nome del connettore account che vuoi utilizzare.
Nella pagina Dettagli connettore, fai clic sulla scheda Configurazione.
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
Nella console Google Cloud , apri Developer Connect.
Fai clic sulla scheda Connessioni e poi sul nome della connessione che vuoi utilizzare.
Nella pagina Dettagli connessione, fai clic sulla scheda Repository.
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:
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.shInvia 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_PATHSe 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_PATHPer le connessioni di sistema:
git clone https://REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAMESe 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_NAMESostituisci 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.