Esta página se ha traducido con Cloud Translation API.

Crear y clonar un repositorio

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

Antes de empezar

Crea una instancia de Secure Source Manager o solicita acceso a una. Para obtener más información, consulta el artículo Crear una instancia de Secure Source Manager.
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
Instala el componente alpha Google Cloud CLI:
```
gcloud components install alpha
```

Roles obligatorios

Para obtener los permisos que necesitas para crear un repositorio, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

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

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para obtener información sobre cómo conceder roles de Secure Source Manager, consulta los artículos Control de acceso con gestión de identidades y accesos y Conceder acceso a instancias a los usuarios.

Crear un repositorio

Interfaz web

Para acceder a la instancia de Secure Source Manager a través de su interfaz web, copie la siguiente URL en la barra de direcciones de su navegador.
```
INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev
```
Haz los cambios siguientes:
- INSTANCE_ID con el nombre de la instancia.
- PROJECT_NUMBER con el número de proyecto de la instancia. Google Cloud Para obtener información sobre cómo identificar proyectos, consulta el artículo Identificar proyectos.
- LOCATION con la región de la instancia.
Si es necesario, autentícate con tus credenciales de Secure Source Manager.
Haz clic en el icono + Crear repositorio, situado en la parte superior derecha del menú de navegación.
Rellena los detalles del repositorio:
1. ID de repositorio: introduce un nombre para el repositorio.
  
  Nota: Los IDs de repositorio deben seguir la convención de nomenclatura de recursos. Solo pueden incluir letras minúsculas, números o guiones, deben empezar por una letra y no se pueden cambiar después de crear el repositorio.
2. Descripción: opcional. Descripción del repositorio.
  
  Precaución: No incluyas datos sensibles ni identificables en la descripción ni en otros campos de recursos similares. Estos campos se tratan como datos del servicio de acuerdo con el Google Cloud Aviso de Privacidad.
3. Inicializar repositorio: opcional. Selecciona esta opción si quieres inicializar el repositorio y añadir los archivos .gitignore, license y README.
4. .gitignore: opcional. Elige los archivos que no quieras monitorizar con las plantillas del menú desplegable.
5. license: opcional. Selecciona una licencia de Creative Commons en el menú desplegable.
6. Rama predeterminada: nombre de la rama predeterminada.
Haz clic en Enviar.

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

El rol de administrador de repositorio (roles/securesourcemanager.repoAdmin) se te asigna cuando creas un repositorio. El nuevo permiso de gestión de identidades y accesos puede tardar hasta 2 minutos en propagarse, por lo que, si aparece un error de permisos al intentar acceder al repositorio después de crearlo, espera unos minutos y vuelve a intentarlo.

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

Configurar las credenciales

Añade el asistente 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

Es posible que las versiones anteriores de Git no admitan comodines. Para añadir 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

Windows

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

Es posible que las versiones anteriores de Git no admitan comodines. Para añadir 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

Haz los cambios siguientes:

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

La herramienta auxiliar de autenticación usa la CLI de gcloud para obtener tusGoogle 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 la CLI de gcloud:

gcloud auth login

Clonar un repositorio

En la interfaz web de Secure Source Manager, vaya a la página de su repositorio.
Copia la URL HTTPS que aparece en la parte superior de la página del repositorio.
Clona tu repositorio ejecutando el siguiente comando:
```
git clone REPOSITORY_URL
```
Donde REPOSITORY_URL es la URL HTTPS que se muestra en la parte superior de la página del repositorio que quieres clonar.

Ignora la advertencia sobre la clonación de un repositorio vacío.

Enviar a un repositorio

En una ventana de terminal, cambia el directorio al repositorio clonado.
```
cd REPOSITORY_NAME
```
Donde REPOSITORY_NAME es el nombre de tu repositorio.
Crea un archivo README vacío:
```
touch README.md
```
Añade el archivo README a Git y crea un mensaje de confirmación:
```
git add README.md
git commit -m "initial commit"
```

Envía los cambios al repositorio remoto:

git push -u origin main

Git envía el archivo de la rama principal al repositorio remoto de origen. La salida es similar a la 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'.

Ver 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 el archivo README.md aparecerá en la pestaña <> Código.

Limpieza

Para evitar que se apliquen cargos en tu cuenta de Google Cloud por los recursos utilizados en esta página, sigue estos pasos.

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de proyecto del proyecto de Google Cloud en el que se ejecuta Secure Source Manager.
LOCATION: la región en la que se encuentra tu instancia. Para obtener información sobre las ubicaciones admitidas, consulta Ubicaciones.
REPOSITORY_ID: 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, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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 presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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 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"}
```

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"}

Siguientes pasos

Lista y vista de repositorios en la interfaz web de Secure Source Manager.
Trabajar con solicitudes de extracción y problemas en Secure Source Manager