Esta página descreve como configurar o proxy do Developer Connect.
O proxy do Developer Connect melhora a forma como o Developer Connect lida com a autenticação e o acesso à rede em sistemas de gerenciamento de código-fonte (SCMs) e endpoints HTTP arbitrários (prévia). Quando você
ativa o proxy para uma conexão, o Developer Connect usa o servidor proxy
para fazer proxy de solicitações do Git, como git clone, ou chamadas de API para endpoints HTTP
(Pré-lançamento). Quando você cria uma conexão usando o console
Google Cloud , o proxy é ativado por padrão. Assim, você só precisa
conceder permissões do IAM a um usuário ou conta de serviço em vez de
gerenciar um token de acesso no Secret Manager.
Por exemplo, ao ativar o proxy do Developer Connect em uma conexão, você pode fazer o seguinte:
- Usar a personalização de código do Gemini Code Assist com SCMs em redes hospedadas de forma privada, incluindo redes locais.
- Clonar o código-fonte de um SCM externo usando a autenticação Google Cloud e as permissões do Identity and Access Management.
- Use o agente de revisão de código do Gemini com SCMs em redes hospedadas de forma particular, incluindo redes locais (pré-lançamento).
Há dois componentes do proxy do Developer Connect:
Proxy Git
Para conexões com sistemas de gerenciamento de código-fonte (SCMs)
Proxy HTTP (prévia)
Para conexões com endpoints HTTP arbitrários
Os dois componentes são ativados usando a mesma configuração. O proxy Git oferece mais controle sobre o uso.
Antes de começar
Verifique se você tem pelo menos uma conexão no Developer Connect com um SCM, como GitHub, GitLab ou Bitbucket.
Para receber as permissões necessárias para configurar o proxy do Developer Connect em uma conexão,
peça ao administrador para conceder a você o papel do IAM
Administrador do Developer Connect (developerconnect.admin)
no usuário que ativa ou desativa o proxy do Developer Connect.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
Para receber as permissões necessárias para emitir solicitações ao proxy de uma conexão, peça ao administrador para conceder a você os seguintes papéis do IAM na conta de usuário ou de conta de serviço que emite solicitações do Git:
-
Faça com que o Git leia solicitações como
git clone: Leitor de proxy do Git (roles/developerconnect.gitProxyReader) -
Fazer solicitações de gravação do Git, como
git push: Usuário de proxy do Git (roles/developerconnect.gitProxyUser)
Conferir e atualizar as configurações de proxy do Developer Connect
O proxy do Developer Connect fica ativado por padrão. Quando ativada, as opções de proxy do Git e HTTP são ativadas.
Para conferir e atualizar as configurações de proxy, faça o seguinte:
Console
No console do Google Cloud , abra o Developer Connect.
Clique na guia Conexões e depois no nome da conexão que você quer usar.
Na página Detalhes da conexão, clique na guia Configuração adicional.
Clique no botão Proxy do Developer Connect para desativar ou reativar o recurso.
O proxy do Developer Connect fica ativado por padrão.
CLI do Google Cloud
Ativar a configuração de proxy do Developer Connect para uma conexão
Para ativar o proxy do Developer Connect em uma conexão, execute o comando gcloud developer-connect connections update:
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--git-proxy-config-enabled
Desativar o proxy do Developer Connect para uma conexão
Para desativar o proxy do Developer Connect em uma conexão, desative a configuração de proxy executando o comando gcloud developer-connect connections update:
gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--no-git-proxy-config-enabled
Ver a configuração de proxy de uma conexão
Para conferir detalhes sobre a configuração de proxy do Developer Connect para uma conexão,
execute o comando gcloud developer-connect connections describe:
gcloud developer-connect connections describe CONNECTION_NAME \
--location=REGION
Substitua:
- CONNECTION_NAME com o nome da sua conexão.
- REGION pela região da sua conexão.
O restante deste documento inclui instruções apenas para o proxy do Git.
Encontrar o URI do proxy Git
Com o proxy do Developer Connect ativado, você pode encontrar o URI do proxy do Git para sua conexão fazendo o seguinte:
Console
No console do Google Cloud , abra o Developer Connect.
Clique na guia Conexões e depois no nome da conexão que você quer usar.
Na página Detalhes da conexão, clique na guia Repositórios.
Encontre o repositório da sua conexão e clique em Copiar URL do proxy do Git.
CLI do Google Cloud
Para receber o URI do proxy do Git, execute o comando
gcloud developer-connect connections git-repository-links describe:
gcloud developer-connect connections git-repository-links describe REPOSITORY_NAME \
--connection=CONNECTION_NAME \
--location=REGION
Substitua:
- REPOSITORY_NAME com o nome do repositório.
- CONNECTION_NAME com o nome da sua conexão.
- REGION pela região da sua conexão.
API Developer Connect
O URI do proxy Git está localizado no campo git_proxy_url do
GitRepositoryLink
da sua conexão.
Emitir solicitações para o proxy Git
Depois de ter o URI do proxy do Git, é possível emitir solicitações para ele fazendo o seguinte:
Configure a CLI do Git para usar o auxiliar de credenciais da Google Cloud CLI:
git config --global credential.'https://*.developerconnect.dev'.helper gcloud.shEmita uma solicitação, como
git clone, para o proxy do Git:git clone https://REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY NAMESe você não quiser usar um assistente de credenciais, incorpore o token de acesso à nuvem na solicitação:
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY NAMESubstitua:
- REPOSITORY_NAME com o nome do repositório.
- CONNECTION_NAME com o nome da sua conexão.
- REGION pela região da sua conexão.