Crea y clona un repositorio

Crea y clona un repositorio

Crea un repositorio en Secure Source Manager y clónalo en tu máquina local.

Antes de comenzar

1. Crea o solicita acceso a una instancia de Secure Source Manager. Para obtener más información, consulta Crea una instancia de Secure Source Manager.

2. Instala Google Cloud CLI.

3. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

4. Para inicializar gcloud CLI, ejecuta el siguiente comando:

   gcloud init

Roles obligatorios

Para obtener los permisos que necesitas para crear un repositorio, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Rol de creador de repositorios de instancias de Secure Source Manager (roles/securesourcemanager.instanceRepositoryCreator) en la instancia de Secure Source Manager
• Rol de creador de repositorios de Secure Source Manager (roles/securesourcemanager.repoCreator) en el proyecto de la instancia

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.

Nota: El rol de administrador de Secure Source Manager (roles/securesourcemanager.admin) o el rol básico de IAM de propietario (roles/owner) en tu proyecto también contiene permisos para crear y clonar un repositorio. No deberías otorgar roles de administrador ni roles básicos en un entorno de producción, pero puedes otorgarlos en un entorno de desarrollo o de prueba.

Para obtener información sobre cómo otorgar roles de Secure Source Manager, consulta Control de acceso con IAM y Otorga a los usuarios acceso a la instancia.

Crea un repositorio

Interfaz web

1. Para acceder a la instancia de Secure Source Manager a través de su interfaz web, copia la siguiente URL en la barra de direcciones de tu navegador.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Reemplaza lo siguiente:

   • INSTANCE_ID por el nombre de la instancia.
   • PROJECT_NUMBER por el número de proyecto de la instancia. Google CloudPara obtener información sobre cómo identificar proyectos, consulta Identifica proyectos.
   • LOCATION por la región de la instancia.

2. Si es necesario, autentícate con tus credenciales de Secure Source Manager.

3. Haz clic en el ícono + Crear repositorio nuevo en la esquina superior derecha del menú de navegación.

4. Completa los detalles del repositorio:

   1. ID del repositorio: Ingresa un nombre para el repositorio.

      Nota: Los IDs de repositorio deben seguir la convención de nombres de recursos. Deben incluir solo letras minúsculas, números o guiones, deben comenzar con una letra y no se pueden cambiar después de crear el repositorio.

   2. Descripción: (opcional) Descripción del repositorio.

      **Precaución:** No ingreses datos sensibles ni de identificación en la descripción ni en otros campos de recursos similares. Estos campos se tratan como datos de servicio de acuerdo con el Google Cloud Aviso de Privacidad.

   3. Rama predeterminada: Nombre de la rama predeterminada.

   4. Inicializar repositorio: Opcional. Selecciona esta opción si deseas inicializar el repositorio y agregar archivos .gitignore, license y README.

   5. .gitignore: Opcional. Elige qué archivos no quieres hacer un seguimiento con las plantillas del menú desplegable.

   6. license: Opcional. Selecciona una licencia común en el menú desplegable.

5. Haz clic en Crear repositorio.

El repositorio se crea en tu instancia de Secure Source Manager.

Se te otorga el rol de administrador de repositorios (roles/securesourcemanager.repoAdmin) cuando creas un repositorio nuevo. El nuevo permiso de IAM puede tardar hasta 2 minutos en propagarse, por lo que, si recibes un error de permisos cuando intentas acceder al repositorio después de la creación, espera unos minutos y vuelve a intentarlo.

Los repositorios que creaste se muestran en la interfaz web de Secure Source Manager en la página Mis repositorios.

Configura tus credenciales

Agrega el auxiliar de autenticación de Secure Source Manager a tu configuración global de Git ejecutando el siguiente comando:

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

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. Para obtener ayuda para encontrar el número de tu proyecto, consulta Identifica proyectos.
• LOCATION por 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 Google Cloud credenciales 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

Clona un repositorio

1. En la interfaz web de Secure Source Manager, navega a la página de tu repositorio.

2. Copia la URL HTTPS en la parte superior de la página del repositorio.

3. Para clonar tu repositorio, ejecuta el siguiente comando:

   git clone REPOSITORY_URL
   

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

   Ignora la advertencia sobre clonar un repositorio vacío.

Envía a un repositorio

1. En una ventana de la terminal, cambia los directorios a tu repositorio clonado.

   cd REPOSITORY_NAME
   

   En el ejemplo anterior, REPOSITORY_NAME es el nombre de tu repositorio.

2. Crea un archivo README vacío:

   touch README.md
   

3. Agrega el archivo README a Git y crea un mensaje de confirmación:

   git add README.md
   git commit -m "initial commit"
   

4. Envía los cambios a tu repositorio remoto:

   git push -u origin main
   

   Git envía el archivo desde la rama principal al remoto de origen. El resultado es similar al siguiente:

   Enumerating objects: 3, done.
   Counting objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
   Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
   remote: . Processing 1 references
   remote: Processed 1 references in total
   To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   

Visualiza tus archivos en Secure Source Manager

En la interfaz web de Secure Source Manager, haz clic en el nombre de tu repositorio.

Se abrirá la página del repositorio y tu archivo README.md aparecerá en la pestaña <> Código.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu Google Cloud cuenta de por los recursos que usaste en esta página.

Antes de quitar el repositorio, asegúrate de que los archivos que quieres conservar estén disponibles en otra ubicación.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto de Google Cloud en el que se ejecuta Secure Source Manager.
• LOCATION: Es la región en la que se encuentra la instancia. Para obtener información sobre las ubicaciones compatibles, consulta Ubicaciones.
• REPOSITORY_ID: Es el ID del repositorio.

Método HTTP y URL:

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

La respuesta es similar a la siguiente:

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

¿Qué sigue?

• Consulta y visualiza repositorios en la interfaz web de Secure Source Manager.
• Trabaja con solicitudes de extracción y problemas en Secure Source Manager.