Configurar la autenticación local

Para poder acceder a repositorios alojados o interactuar con ellos desde tu sistema, debes configurar la autenticación local en tu entorno.

Una vez que hayas configurado la autenticación local, podrás acceder a los repositorios alojados para los que tengas los roles y permisos adecuados. También puedes realizar operaciones estándar de Git, como git clone, git pull y git push. No es necesario autenticarse localmente para realizar operaciones en la consolaGoogle Cloud , como consultar el contenido de un repositorio.

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

Autenticarse mediante SSH

Cloud Source Repositories te permite usar la autenticación de clave pública SSH para acceder a repositorios alojados. En este caso, primero generas un par de claves en el sistema local desde el que quieres acceder al repositorio. A continuación, registra la clave pública con Google Cloud. Si ya tienes un par de claves SSH en tu sistema, puedes volver a usar esas claves para la autenticación. Puedes registrar hasta 20 claves públicas por cuenta de Google.

Cloud Source Repositories admite tres tipos de claves SSH:

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

Generar un par de claves

El par de claves SSH consta de una clave privada que se encuentra 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, introduce el siguiente comando:

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

    Donde:

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

    Por ejemplo:

    ssh-keygen -t rsa -C "user@example.com"

    1. Cuando se te solicite, introduce el nombre del archivo de clave pública. Para aceptar la ubicación predeterminada ~/.ssh, pulsa Intro. De lo contrario, especifica un nombre de archivo.

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

  3. Registra tu llave

Windows

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

  2. En el menú Inicio de Windows, inicia PuTTYGen.

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

  4. Haz clic en Generar.

    PuTTYgen muestra la cadena 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 has generado en tu sistema local, haz clic en Guardar clave pública y Guardar clave privada.

Usar las llaves existentes

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

Linux o macOS

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

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

ls -a ~/.ssh

Los nombres de archivo predeterminados son los siguientes:

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

Windows

  1. En el menú Inicio de Windows, inicia PuTTYGen.

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

  3. Busca el archivo de clave pública en el sistema de archivos local y selecciónalo.

    PuTTYGen muestra la cadena de clave pública. Si has especificado una contraseña al guardar el archivo de clave, PuTTYgen te pedirá que la introduzcas antes de que puedas ver la clave pública.

Registrar una clave pública

  1. En la Google Cloud consola, abre la página Gestionar claves SSH.

    Abrir Cloud Source Repositories

  2. Haz clic en Registrar clave SSH.

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

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

  4. En el campo Clave, copia la cadena de clave de tu archivo de clave pública.

  5. Haz clic en Registrarse.

Una vez que hayas configurado la autenticación SSH, podrás clonar cualquier repositorio para el que tengas los roles y permisos necesarios, o bien enviar el contenido de un repositorio local a un repositorio alojado vacío.

Autenticarse con la CLI de gcloud

Cloud Source Repositories te permite autenticarte mediante gcloud CLI. En este caso, ejecuta el comando gcloud init en tu sistema para 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. Siga las instrucciones.

Una vez que hayas configurado la autenticación con la CLI de gcloud, podrás usar comandos de Git estándar para interactuar con el repositorio alojado en Cloud Source Repositories.

Autenticarse con credenciales generadas manualmente

También puedes usar credenciales generadas manualmente para la autenticación. Cloud Source Repositories proporciona un conjunto de secuencias de comandos que puedes usar para generar manualmente 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 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

Una vez que hayas configurado la autenticación con credenciales generadas manualmente, podrás interactuar con el repositorio alojado en Cloud Source Repositories mediante los comandos de Git estándar.