Configurar e usar o proxy do Developer Connect

Esta página descreve como configurar o proxy do Developer Connect.

O proxy do Developer Connect melhora a maneira como o Developer Connect processa a autenticação e o acesso à rede a sistemas de gerenciamento de código-fonte (SCMs, na sigla em inglês), endpoints HTTP arbitrários (prévia) e conexões a provedores de ferramentas de desenvolvedor que não são do Google, usando conectores de conta .

Ao ativar o proxy para uma conexão de sistema ou um conector de conta, o Developer Connect usa o servidor proxy para emitir solicitações do Git, como git clone, ou chamadas de API para endpoints HTTP (prévia). Ao criar uma conexão usando Google Cloud o console, o proxy é ativado por padrão. Dessa forma, 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, ativar o proxy do Developer Connect em uma conexão permite que você faça o seguinte:

  • Use a personalização de código do Gemini Code Assist com SCMs em redes hospedadas de forma privada, incluindo redes locais.

  • Clone o código-fonte de um SCM externo usando Google Cloud a autenticação 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 privada, incluindo redes locais (prévia).

O Developer Connect é compatível com dois tipos de proxy:

  • Proxy em conexões de sistema

    O proxy de conexão do sistema inclui o seguinte:

    • Proxy Git

    Para conexões com sistemas de gerenciamento de código-fonte (SCMs)

    Para conexões com endpoints HTTP arbitrários

  • Proxy para conectores de conta (prévia)

    O proxy do Developer Connect pode ser usado com conectores de conta.

Todos eles são ativados usando a mesma configuração.

Antes de começar

Verifique se você tem pelo menos uma conexão de sistema no Developer Connect (a um SCM, como GitHub, GitLab ou Bitbucket, ou a um endpoint HTTP) ou um conector de conta.

Para receber as permissões necessárias para configurar o proxy do Developer Connect para uma conexão, peça ao administrador para conceder a você o papel do IAM de 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 personalizados papéis ou outros predefinidos papéis.

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:

  • Fazer solicitações de leitura do Git, como git clone, para conexões de sistema: Leitor de proxy do Git (roles/developerconnect.gitProxyReader)
  • Fazer solicitações de gravação do Git, como git push, para conexões de sistema: Usuário de proxy do Git (roles/developerconnect.gitProxyUser)
  • Fazer solicitações de leitura e gravação do Git para conectores de conta: Usuário OAuth do conector de conta (roles/developerconnect.oauthUser)

Ativar e desativar as configurações de proxy do Developer Connect para conexões de sistema

Ao criar uma conexão de sistema usando o Google Cloud console, o proxy é ativado por padrão. Quando ativado, o proxy Git e o proxy HTTP são ativados.

Para visualizar e atualizar as configurações de proxy, faça o seguinte:

Console

  1. No Google Cloud console do, abra o Developer Connect.

    Acessar o Developer Connect

  2. Clique na guia Conexões e no nome da conexão que você quer usar.

  3. Na página Detalhes da conexão , clique na guia Configuração adicional.

  4. Clique na opção Proxy do Developer Connect para desativar ou reativar o recurso de proxy do Developer Connect.

    O proxy do Developer Connect está ativado por padrão.

Google Cloud CLI

Ativar a configuração de proxy do Developer Connect para uma conexão

Para ativar o proxy do Developer Connect para uma conexão, ative a configuração de proxy executando 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 para 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

Conferir 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 pelo nome da conexão.
  • REGION pela região da conexão.

O restante deste documento inclui instruções apenas para o proxy Git.

Ativar e desativar as configurações de proxy do Developer Connect para conectores de conta

Ao criar um conector de conta usando o Google Cloud console, o proxy é ativado por padrão. Quando ativado, o proxy Git e o proxy HTTP são ativados.

Para visualizar e atualizar as configurações de proxy, faça o seguinte:

Console

  1. No Google Cloud console do, abra o Developer Connect.

    Acessar o Developer Connect

  2. Clique na guia Conectores de conta e no nome do conector de conta que você quer usar.

  3. Na página Detalhes do conector, clique na guia Configuração.

  4. Clique na opção Proxy do Developer Connect para desativar ou reativar o recurso de proxy do Developer Connect.

    O proxy do Developer Connect está ativado por padrão.

Google Cloud CLI

Ativar a configuração de proxy do Developer Connect para um conector de conta

Para ativar o proxy do Developer Connect para um conector de conta, execute o seguinte comando:

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

Desativar o proxy do Developer Connect para um conector de conta

Para desativar o proxy do Developer Connect para uma conexão, execute o seguinte comando:

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

Conferir a configuração de proxy de um conector de conta

Para conferir detalhes sobre a configuração de proxy do Developer Connect para uma conexão, execute o seguinte comando:

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

Substitua:

  • CONNECTOR_NAME pelo nome do conector de conta.
  • REGION pela região do conector de conta.

Encontrar o URI do proxy Git

Para conexões de sistema

Com o proxy do Developer Connect ativado, você pode encontrar o URI do proxy Git para sua conexão de sistema fazendo o seguinte:

Console

  1. No Google Cloud console do, abra o Developer Connect.

    Acessar o Developer Connect

  2. Clique na guia Conexões e no nome da conexão que você quer usar.

  3. Na página Detalhes da conexão, clique na guia Repositórios.

  4. Encontre o repositório da sua conexão e clique em Copiar URL do proxy Git.

Google Cloud CLI

Para receber o URI do proxy 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 pelo nome do repositório.
  • CONNECTION_NAME pelo nome da conexão.
  • REGION pela região da conexão.

API Developer Connect

O URI do proxy Git está localizado no campo git_proxy_url de the GitRepositoryLink para sua conexão.

Para conectores de conta

Com o proxy do Developer Connect ativado, é possível construir o URI do proxy Git para o conector de conta usando o seguinte formato:

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

Em que:

  • REGION é a região em que você criou o conector de conta.

  • PROJECT_ID é o ID do projeto em que você criou o conector de conta.

  • CONNECTOR_ID é o ID do conector de conta em que você ativou o proxy Git.

  • REPO_PATH é tudo depois do domínio no URL do Git do seu repositório.

    Por exemplo, se o URL do repositório for https://github.com/myusername/test-repo.git, o REPO_PATH for myusername/test-repo.

Emitir solicitações para o proxy Git

Depois de ter o URI do proxy Git, você pode emitir solicitações para o proxy Git fazendo o seguinte:

  1. Configure a CLI do Git para usar o auxiliar de credenciais da Google Cloud CLI:

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

  2. Emita uma solicitação para o proxy Git. Este exemplo é uma solicitação git clone.

    Para conectores de conta:

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

    Se você não quiser usar um auxiliar de credenciais, poderá incorporar o token de acesso à nuvem na solicitação:

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

    Para conexões de sistema:

    git clone https://REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY_NAME

    Se você não quiser usar um auxiliar de credenciais, poderá incorporar o token de acesso à nuvem na solicitação:

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

    Substitua:

    • REGION pela região do conector de conta.
    • PROJECT_NAME pelo nome do Google Cloud projeto em que você criou o conector de conta.
    • ACCOUNT_CONNECTOR_NAME pelo nome do conector de conta.
    • CONNECTION_NAME pelo nome da conexão de sistema.
    • REPOSITORY_NAME pelo nome do repositório.
    • REPO_PATH pelo caminho para o repositório, por exemplo my-org/my-repo.