Configura la autenticación local

Antes de que puedas acceder a tus repositorios alojados o interactuar con ellos desde tu sistema, debes configurar la autenticación local en tu entorno.

Después de configurar la autenticación local, podrás acceder a los repositorios alojados para los que tengas las funciones y permisos adecuados. También podrás realizar operaciones estándar de Git, como git clone, git pull y git push. La autenticación local no es necesaria para realizar operaciones en la consola de Google Cloud, por ejemplo, para explorar el contenido de un repositorio.

Cloud Source Repositories admite los siguientes tipos de autenticación:

• SSH
• Google Cloud CLI
• Credenciales generadas de forma manual

Autentica mediante SSH

Cloud Source Repositories te permite usar la autenticación de clave pública SSH para acceder a los repositorios alojados. En este caso, primero genera un par de claves en el sistema local desde el cual deseas acceder al repositorio. Luego, registra la clave pública con Google Cloud. Si ya tienes un par de llaves SSH en tu sistema, puedes reutilizarlas para la autenticación. Puedes registrar hasta 20 claves públicas por cada Cuenta de Google.

Nota: No puedes configurar la autenticación para las cuentas de servicio mediante claves SSH.

Cloud Source Repositories admite los tres tipos siguientes de llaves SSH:

• RSA (solo para claves con más de 2048 bits)
• ECDSA
• ED25519

Genera un par de claves

El par de llaves SSH consta de una clave privada que reside en tu sistema local y una clave pública que registras en Google Cloud.

Linux o macOS

1. Asegúrate de que OpenSSH esté instalado en tu sistema local.

2. En el símbolo del sistema, ingresa el siguiente comando:

   ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"
   

   Donde:

   • [USER_EMAIL] es tu dirección de correo electrónico.
   • [KEY_TYPE] es uno de los siguientes:
     • rsa
     • ecdsa
     • ed25519

   Por ejemplo:

   ssh-keygen -t rsa -C "[e-mail]"
   

   1. Cuando se te solicite, ingresa un nombre de archivo para el archivo de claves públicas. Para aceptar la ubicación predeterminada ~/.ssh, presiona Intro; de lo contrario, especifica un nombre de archivo.

   2. Cuando se te solicite, deja la frase de contraseña vacía y presiona Intro.

3. Registra la llave

Windows

1. Asegúrate de que PuTTY esté instalado en tu sistema local.

2. Inicia PuTTYGen desde el menú Inicio de Windows.

3. En la ventana que se abre, selecciona el tipo de clave en el campo Parameters.

4. Haz clic en Generate.

   PuTTYGen muestra la string de clave pública generada.

5. Especifica una frase de contraseña para proteger el par de claves.

6. Para guardar el par de claves que generaste en tu sistema local, haz clic en Save public key y Save private key.

Usa claves existentes

También puedes usar un par de claves existente para la autenticación de SSH.

Linux o macOS

De forma predeterminada, los archivos de claves públicas se encuentran en el directorio ~/.ssh.

En el símbolo del sistema, ingresa el siguiente comando:

ls -a ~/.ssh

Estos son los nombres de archivo predeterminados:

• id_rsa.pub
• id_ecdsa.pub
• id_ed25519.pub

Windows

1. Inicia PuTTYGen desde el menú Inicio de Windows.

2. En la ventana que se abre, haz clic en Load.

3. Busca tu archivo de claves públicas en el sistema de archivos local y selecciónalo.

   PuTTYGen muestra la string de clave pública. Si especificaste una frase de contraseña cuando guardaste el archivo de claves, PuTTYGen te pedirá que la ingreses para ver la clave pública.

Registra una clave pública

1. En GCP Console, abre la página Administrar llaves SSH.

   Abrir Cloud Source Repositories

2. Haz clic en Registrar llave SSH.

   Se abrirá el cuadro de diálogo Registrar llave SSH.

3. En el campo Nombre de la clave, escribe un nombre único para la clave.

4. En el campo Clave, copia la string de tu archivo de claves públicas.

5. Haz clic en Registrar.

Después de configurar la autenticación SSH, puedes clonar cualquier repositorio para el que tengas las funciones y los permisos necesarios, o enviar el contenido de un repositorio local a un repositorio vacío alojado.

Realiza la autenticación con gcloud CLI

Cloud Source Repositories te permite autenticar mediante gcloud CLI. Para esta situación, ejecuta el comando gcloud init en tu sistema a fin de configurar la autenticación local.

1. Asegúrate de que la CLI de gcloud esté instalada en tu sistema local.

2. En el símbolo del sistema, ejecuta gcloud init:

   gcloud init
   

3. Sigue las instrucciones.

Después de configurar la autenticación con gcloud CLI, puedes usar comandos estándar de Git para interactuar con el repositorio alojado en Cloud Source Repositories.

Autentica mediante credenciales generadas manualmente

También puedes usar credenciales generadas de forma manual para la autenticación. Cloud Source Repositories proporciona un conjunto de secuencias de comandos que puedes usar con el objetivo de generar de forma manual las credenciales que necesitas para acceder a los repositorios alojados.

1. Ve a la página Configurar Git para generar tus credenciales.

   Ir a la página Configurar Git

2. Abre una ventana de la terminal.

3. Escribe el siguiente comando:

   git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME
   

   Donde:

   • PROJECT_ID es el nombre de tu proyecto.
   • REPOSITORY_NAME es el nombre de tu repositorio

Después de configurar la autenticación con credenciales generadas manualmente, podrás usar los comandos estándar de Git para interactuar con el repositorio alojado en Cloud Source Repositories.