Configurar a autenticação local

Antes de poder aceder ou interagir com repositórios alojados a partir do seu sistema, tem de configurar a autenticação local no seu ambiente.

Depois de configurar a autenticação local, pode aceder aos repositórios alojados para os quais tem as funções e as autorizações adequadas. Também pode executar operações Git padrão, como git clone, git pull e git push. A autenticação local não é necessária para realizar operações na consolaGoogle Cloud , por exemplo, para procurar o conteúdo de um repositório.

Os Cloud Source Repositories suportam os seguintes tipos de autenticação:

Autentique-se através de SSH

Os Cloud Source Repositories permitem-lhe usar a autenticação de chave pública de SSH para aceder a repositórios alojados. Neste cenário, primeiro, gera um par de chaves no sistema local a partir do qual quer aceder ao repositório. Em seguida, regista a chave pública em Google Cloud. Se já tiver um par de chaves SSH no seu sistema, pode reutilizar essas chaves para autenticação. Pode registar até 20 chaves públicas por Conta Google.

Os Cloud Source Repositories suportam três tipos de chaves SSH:

  • RSA (apenas para chaves com mais de 2048 bits)
  • ECDSA
  • ED25519

Gere um par de chaves

O par de chaves SSH consiste numa chave privada que reside no seu sistema local e numa chave pública que regista no Google Cloud.

Linux ou macOS

  1. Certifique-se de que o OpenSSH está instalado no seu sistema local.

  2. Num comando, introduza o seguinte comando:

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

    Onde:

    • [USER_EMAIL] é o seu endereço de email.
    • [KEY_TYPE] é uma das seguintes opções:
      • rsa
      • ecdsa
      • ed25519

    Por exemplo:

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

    1. Quando lhe for pedido, introduza um nome de ficheiro para o ficheiro de chave pública. Para aceitar a localização ~/.ssh predefinida, prima Enter. Caso contrário, especifique um nome de ficheiro.

    2. Quando lhe for pedido, deixe a frase de acesso vazia e prima Enter.

  3. Registe a chave

Windows

  1. Certifique-se de que o PuTTY está instalado no seu sistema local.

  2. No menu Iniciar do Windows, inicie o PuTTYGen.

  3. Na janela apresentada, selecione o tipo de chave no campo Parâmetros.

  4. Clique em Gerar.

    O PuTTYgen apresenta a string da chave pública gerada.

  5. Especifique uma frase de acesso para proteger o par de chaves.

  6. Para guardar o par de chaves gerado no seu sistema local, clique em Guardar chave pública e Guardar chave privada.

Use chaves existentes

Também pode usar um par de chaves existente para a autenticação SSH.

Linux ou macOS

Por predefinição, os ficheiros de chave pública encontram-se no diretório ~/.ssh.

Num comando, introduza o seguinte comando:

ls -a ~/.ssh

Os nomes de ficheiros predefinidos são:

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

Windows

  1. No menu Iniciar do Windows, inicie o PuTTYGen.

  2. Na janela apresentada, clique em Carregar.

  3. Procure o ficheiro de chave pública no sistema de ficheiros local e selecione-o.

    O PuTTYgen apresenta a string da chave pública. Se especificou uma frase secreta quando guardou o ficheiro de chave, o PuTTYgen pede-lhe que a introduza antes de poder ver a chave pública.

Registe uma chave pública

  1. Na Google Cloud consola, abra a página Faça a gestão das chaves SSH.

    Abrir Cloud Source Repositories

  2. Clique em Registar chave SSH.

    É apresentada a caixa de diálogo Registar chave SSH.

  3. No campo Nome da chave, escreva um nome exclusivo para a chave.

  4. No campo Chave, copie a string da chave do ficheiro de chave pública.

  5. Clique em Registar.

Depois de configurar a autenticação SSH, pode clonar qualquer repositório para o qual tenha as funções e as autorizações necessárias ou enviar o conteúdo de um repositório local para um repositório alojado vazio.

Autentique-se através da CLI gcloud

Os Cloud Source Repositories permitem-lhe fazer a autenticação através da CLI gcloud. Neste cenário, executa o comando gcloud init no seu sistema para configurar a autenticação local.

  1. Certifique-se de que a CLI gcloud está instalada no seu sistema local.

  2. Numa linha de comandos, execute gcloud init:

    gcloud init

  3. Siga as instruções.

Depois de configurar a autenticação através da CLI gcloud, pode usar comandos Git padrão para interagir com o repositório alojado nos Cloud Source Repositories.

Autentique através de credenciais geradas manualmente

Também pode usar credenciais geradas manualmente para autenticação. Os Cloud Source Repositories fornecem um conjunto de scripts que pode usar para gerar manualmente as credenciais necessárias para aceder a repositórios alojados.

  1. Aceda à página Configurar Git para gerar as suas credenciais.

    Aceda à página Configurar Git

  2. Abra uma janela de terminal.

  3. Escreva o seguinte comando:

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

    Onde:

    • PROJECT_ID é o nome do seu projeto
    • REPOSITORY_NAME é o nome do seu repositório

Depois de configurar a autenticação com credenciais geradas manualmente, pode interagir com o repositório alojado nos Cloud Source Repositories através dos comandos Git padrão.