Configura y usa el proxy de Developer Connect

En esta página, se describe cómo configurar el proxy de Developer Connect.

El proxy de Developer Connect mejora la forma en que Developer Connect controla la autenticación y el acceso de red a los sistemas de administración de código fuente (SCM), los extremos HTTP arbitrarios y las conexiones a proveedores de herramientas para desarrolladores que no son de Google, con conectores de cuentas.

Cuando habilitas el proxy para una conexión del sistema o un conector de cuenta, Developer Connect usa el servidor proxy para emitir solicitudes de Git, como git clone, o llamadas a la API a extremos HTTP. Cuando creas una conexión con la consola de Google Cloud , el proxy se habilita de forma predeterminada. De esta manera, solo necesitas otorgar permisos de IAM a un usuario o una cuenta de servicio en lugar de administrar un token de acceso en Secret Manager.

Por ejemplo, habilitar el proxy de Developer Connect en una conexión te permite hacer lo siguiente:

  • Usa la personalización de código de Gemini Code Assist con SCM en redes alojadas de forma privada, incluidas las redes locales.
  • Clonar el código fuente de un SCM externo con la autenticación de Google Cloud y los permisos de Identity and Access Management

  • Usa el agente de revisión de código de Gemini con SCM en redes alojadas de forma privada, incluidas las redes locales (versión preliminar).

Developer Connect admite dos tipos de proxy:

  • Proxy en conexiones del sistema

    El proxy de conexión del sistema incluye lo siguiente:

    • Proxy de Git

    Para conexiones a sistemas de administración de código fuente (SCM)

    • Proxy HTTP

    Para conexiones a extremos HTTP arbitrarios

  • Proxy para conectores de cuentas

    El proxy de Developer Connect se puede usar con conectores de cuentas.

Todas estas opciones se habilitan con el mismo parámetro de configuración.

Antes de comenzar

Asegúrate de tener al menos una conexión del sistema en Developer Connect (a un SCM, como GitHub, GitLab o Bitbucket, o a un extremo HTTP) o un conector de cuenta.

Para obtener los permisos que necesitas para configurar el proxy de Developer Connect para una conexión, pídele a tu administrador que te otorgue el rol de IAM de administrador de Developer Connect (developerconnect.admin) en el usuario que habilita o inhabilita el proxy de Developer Connect. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener los permisos que necesitas para emitir solicitudes al proxy para una conexión, pídele a tu administrador que te otorgue los siguientes roles de IAM en la cuenta de usuario o de servicio que emite solicitudes de Git:

  • Realiza solicitudes de lectura de Git, como git clone, para conexiones del sistema: Lector de proxy de Git (roles/developerconnect.gitProxyReader)
  • Realiza solicitudes de escritura de Git, como git push, para conexiones del sistema: Usuario del proxy de Git (roles/developerconnect.gitProxyUser)
  • Realiza solicitudes de lectura y escritura de Git para conectores de cuentas: Usuario de OAuth del conector de cuentas (roles/developerconnect.oauthUser)

Habilitar e inhabilitar la configuración del proxy de Developer Connect para las conexiones del sistema

Cuando creas una conexión del sistema con la consola de Google Cloud , el proxy se habilita de forma predeterminada. Cuando se habilita, se habilitan el proxy de Git y el proxy HTTP.

Para ver y actualizar la configuración de proxy, haz lo siguiente:

Console

  1. En la consola de Google Cloud , abre Developer Connect.

    Ir a Developer Connect

  2. Haz clic en la pestaña Conexiones y, luego, en el nombre de la conexión que deseas usar.

  3. En la página Detalles de la conexión, haz clic en la pestaña Configuración adicional.

  4. Haz clic en el botón de activación Proxy de Developer Connect para inhabilitar o volver a habilitar la función de proxy de Developer Connect.

    El proxy de Developer Connect está habilitado de forma predeterminada.

Google Cloud CLI

Habilita el parámetro de configuración del proxy de Developer Connect para una conexión

Para habilitar el proxy de Developer Connect para una conexión, habilita el parámetro de configuración del proxy ejecutando el comando gcloud developer-connect connections update:

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

Inhabilita el proxy de Developer Connect para una conexión

Para inhabilitar el proxy de Developer Connect para una conexión, inhabilita el parámetro de configuración del proxy ejecutando el comando gcloud developer-connect connections update:

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

Visualiza la configuración de proxy de una conexión

Para ver los detalles sobre la configuración del proxy de Developer Connect para una conexión, ejecuta el comando gcloud developer-connect connections describe:

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

Reemplaza lo siguiente:

  • CONNECTION_NAME por el nombre de tu conexión.
  • REGION por la región de tu conexión.

En el resto de este documento, se incluyen solo las instrucciones del proxy de Git.

Habilita e inhabilita la configuración del proxy de Developer Connect para los conectores de cuentas

Cuando creas un conector de cuenta con la consola de Google Cloud , el proxy se habilita de forma predeterminada. Cuando se habilita, se habilitan el proxy de Git y el proxy HTTP.

Para ver y actualizar la configuración de proxy, haz lo siguiente:

Console

  1. En la consola de Google Cloud , abre Developer Connect.

    Ir a Developer Connect

  2. Haz clic en la pestaña Conectores de cuenta y, luego, en el nombre del conector de cuenta que deseas usar.

  3. En la página Detalles del conector, haz clic en la pestaña Configuración.

  4. Haz clic en el botón de activación Proxy de Developer Connect para inhabilitar o volver a habilitar la función de proxy de Developer Connect.

    El proxy de Developer Connect está habilitado de forma predeterminada.

Google Cloud CLI

Habilita el parámetro de configuración del proxy de Developer Connect para un conector de cuentas

Para habilitar el proxy de Developer Connect para un conector de cuenta, ejecuta el siguiente comando:

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

Inhabilitar el proxy de Developer Connect para un conector de cuentas

Para inhabilitar el proxy de Developer Connect para una conexión, ejecuta el siguiente comando:

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

Consulta la configuración del proxy para un conector de cuenta

Para ver los detalles de la configuración del proxy de Developer Connect para una conexión, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CONNECTOR_NAME por el nombre del conector de tu cuenta.
  • REGION por la región del conector de tu cuenta.

Busca el URI del proxy de Git

Para conexiones del sistema

Con el proxy de Developer Connect habilitado, puedes encontrar el URI del proxy de Git para la conexión de tu sistema de la siguiente manera:

Console

  1. En la consola de Google Cloud , abre Developer Connect.

    Ir a Developer Connect

  2. Haz clic en la pestaña Conexiones y, luego, en el nombre de la conexión que deseas usar.

  3. En la página Detalles de la conexión, haz clic en la pestaña Repositorios.

  4. Busca el repositorio de tu conexión y, luego, haz clic en Copiar la URL del proxy de Git.

Google Cloud CLI

Para obtener el URI del proxy de Git, ejecuta el comando gcloud developer-connect connections git-repository-links describe:

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

Reemplaza lo siguiente:

  • REPOSITORY_NAME por el nombre de tu repositorio.
  • CONNECTION_NAME por el nombre de tu conexión.
  • REGION por la región de tu conexión.

API de Developer Connect

El URI del proxy de Git se encuentra en el campo git_proxy_url del GitRepositoryLink de tu conexión.

Para los conectores de cuentas

Con el proxy de Developer Connect habilitado, puedes construir el URI del proxy de Git para tu conector de cuenta con el siguiente formato:

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

Aquí:

  • REGION es la región en la que creaste el conector de la cuenta.

  • PROJECT_ID es el ID del proyecto en el que creaste el conector de cuenta.

  • CONNECTOR_NAME es el nombre del conector de la cuenta en el que habilitaste el proxy de Git.

  • REPO_PATH es todo lo que aparece después del dominio en la URL de Git de tu repositorio.

    Por ejemplo, si la URL del repositorio es https://github.com/myusername/test-repo.git, el REPO_PATH es myusername/test-repo.

Emite solicitudes al proxy de Git

Después de obtener el URI del proxy de Git, puedes emitir solicitudes al proxy de Git con los siguientes pasos:

  1. Configura la CLI de Git para usar el asistente de credenciales de Google Cloud CLI:

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

  2. Envía una solicitud al proxy de Git. Este ejemplo es una solicitud git clone.

    Para los conectores de cuentas, haz lo siguiente:

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

    Si no quieres usar un ayudante de credenciales, puedes incorporar el token de acceso a la nube en la solicitud:

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

    Para las conexiones del sistema, haz lo siguiente:

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

    Si no quieres usar un ayudante de credenciales, puedes incorporar el token de acceso a la nube en la solicitud:

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

    Reemplaza lo siguiente:

    • REGION por la región del conector de tu cuenta.
    • PROJECT_ID por el ID del proyecto en el que creaste tu conector de cuenta.
    • ACCOUNT_CONNECTOR_NAME por el nombre del conector de tu cuenta.
    • CONNECTION_NAME por el nombre de la conexión del sistema.
    • REPOSITORY_NAME por el nombre de tu repositorio.
    • REPO_PATH por la ruta de acceso a tu repositorio, por ejemplo, my-org/my-repo.