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
En la consola de Google Cloud , abre Developer Connect.
Haz clic en la pestaña Conexiones y, luego, en el nombre de la conexión que deseas usar.
En la página Detalles de la conexión, haz clic en la pestaña Configuración adicional.
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
En la consola de Google Cloud , abre Developer Connect.
Haz clic en la pestaña Conectores de cuenta y, luego, en el nombre del conector de cuenta que deseas usar.
En la página Detalles del conector, haz clic en la pestaña Configuración.
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
En la consola de Google Cloud , abre Developer Connect.
Haz clic en la pestaña Conexiones y, luego, en el nombre de la conexión que deseas usar.
En la página Detalles de la conexión, haz clic en la pestaña Repositorios.
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í:
REGIONes la región en la que creaste el conector de la cuenta.PROJECT_IDes el ID del proyecto en el que creaste el conector de cuenta.CONNECTOR_NAMEes el nombre del conector de la cuenta en el que habilitaste el proxy de Git.REPO_PATHes 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, elREPO_PATHesmyusername/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:
Configura la CLI de Git para usar el asistente de credenciales de Google Cloud CLI:
git config --global credential.'https://*.developerconnect.dev'.helper gcloud.shEnví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_PATHSi 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_PATHPara las conexiones del sistema, haz lo siguiente:
git clone https://REGION-git.developerconnect.dev/PROJECT_ID/CONNECTION_NAME/REPOSITORY_NAMESi 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_NAMEReemplaza 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.