Usa la administración de código fuente de Git

Secure Source Manager admite todos los comandos del cliente de SCM de Git y tiene solicitudes de extracción y seguimiento de problemas integrados. Se admiten tanto la autenticación HTTPS como la autenticación SSH.

Roles requeridos

Para obtener los permisos que necesitas para usar Git y, así, interactuar con un repositorio de Secure Source Manager, pídele a tu administrador que te otorgue los siguientes roles de IAM:

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 información sobre cómo otorgar roles de Secure Source Manager, consulta Control de acceso con IAM y Cómo otorgar acceso a la instancia a los usuarios.

Instala Git y Google Cloud CLI

  1. Instala Git.

  2. Si el instalador de Git te solicita que elijas un auxiliar de credenciales, selecciona Ninguno (no usar un auxiliar de credenciales).

  3. Instala la CLI de gcloud.

  4. Se requiere la versión 395.0.0 o una posterior de gcloud CLI para usar Git con HTTPS. Para verificar tu versión de gcloud CLI, ejecuta el siguiente comando:

    gcloud --version

  5. Para actualizar gcloud CLI, ejecuta el siguiente comando.

    gcloud components update

  6. Después de la actualización, ejecuta gcloud init para inicializar la CLI de gcloud.

    Consulta la documentación de gcloud CLI sobre la actualización de componentes para obtener más información.

Configura tus credenciales

Si te autenticas en Secure Source Manager con un proveedor de identidad externo y la federación de identidades de personal, no es necesario que completes esta sección. En su lugar, debes crear una configuración de acceso al grupo de identidades de personal.

Ejecuta el siguiente comando para agregar el asistente de autenticación de Secure Source Manager a tu configuración global de Git:

Linux 

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

Es posible que las versiones anteriores de Git no admitan comodines. Para agregar el auxiliar de autenticación sin comodines, ejecuta el siguiente comando:

git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh

Reemplaza lo siguiente:

  • INSTANCE_ID por el nombre de tu instancia de Secure Source Manager
  • PROJECT_NUMBER por el número de tu proyecto. Si necesitas ayuda para encontrar el número de tu proyecto, consulta Identifica proyectos.
  • LOCATION con la región de la instancia. Para obtener más información sobre las regiones, consulta Ubicaciones.

Windows

git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd

Es posible que las versiones anteriores de Git no admitan comodines. Para agregar el auxiliar de autenticación sin comodines, ejecuta el siguiente comando:

git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd

Reemplaza lo siguiente:

  • INSTANCE_ID por el nombre de tu instancia de Secure Source Manager
  • PROJECT_NUMBER por el número de tu proyecto. Si necesitas ayuda para encontrar el número de tu proyecto, consulta Identifica proyectos.
  • LOCATION con la región de la instancia. Para obtener más información sobre las regiones, consulta Ubicaciones.

El auxiliar de autenticación usa gcloud CLI para recuperar tus credenciales deGoogle Cloud cuando usas comandos de Git con Secure Source Manager.

Para volver a autenticarte después de la configuración inicial de las credenciales, ejecuta el siguiente comando de gcloud CLI:

gcloud auth login

Crea una configuración de acceso para el grupo de identidades de personal

No es necesario que completes esta sección, a menos que uses la federación de identidades de personal para autenticarte en Secure Source Manager con un proveedor de identidad externo.

Para autenticarte con las credenciales de tu grupo de identidades para trabajadores en tu instancia de Secure Source Manager con comandos de gcloud CLI o comandos de Git, debes crear una configuración de acceso con tu grupo de identidades para trabajadores.

Para crear una configuración de acceso al grupo de identidades de personal, sigue las instrucciones en Obtén tokens de corta duración para la federación de identidades de personal para crear un acceso basado en el navegador con gcloud CLI.

Después de autenticarte, puedes usar comandos de Git para interactuar con tu instancia de Secure Source Manager. Debes volver a autenticarte cuando venza la duración de la sesión de tu grupo de identidades de personal.

Clona un repositorio

Para clonar un repositorio, ejecuta el siguiente comando:

git clone REPOSITORY_URL

En el ejemplo anterior, REPOSITORY_URL es la URL HTTPS o SSH que se muestra en la parte superior de la página del repositorio que deseas clonar.

Envía un repositorio existente a Secure Source Manager

Debes crear un repositorio de Secure Source Manager para que actúe como un repositorio remoto antes de poder enviar contenido a él.

Para enviar tu repositorio de Git existente a un repositorio vacío de Secure Source Manager, debes agregar el repositorio de Secure Source Manager como un repositorio remoto y enviar contenido a él.

  1. Para configurar el repositorio de Secure Source Manager como un repositorio remoto, ejecuta el siguiente comando:

    git remote add origin REPOSITORY_URL

    Aquí, REPOSITORY_URL es la URL HTTPS o SSH que se muestra en la parte superior de la página del repositorio.

  2. Para enviar los cambios al repositorio, ejecuta el siguiente comando:

    git push -u origin main

Para obtener más información sobre la administración del código fuente de Git, consulta la documentación de Git.

¿Qué sigue?