Antes de acessar ou interagir com os repositórios hospedados do seu sistema, configure a autenticação local no seu ambiente.
Depois de configurar a autenticação local, é possível acessar os repositórios hospedados para os quais você tem os papéis e permissões apropriados.
Também é possível 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 no console do Google Cloud, como procurar o conteúdo de um repositório, por exemplo.
O Cloud Source Repositories aceita os seguintes tipos de autenticação:
Autenticar usando SSH
O Cloud Source Repositories permite que você use autenticação de chave pública SSH para acessar repositórios hospedados. Nesse cenário, primeiro é preciso gerar um par de chaves no sistema local a partir do qual você quer acessar o repositório. Depois, é necessário registrar a chave pública com o Google Cloud. Se você já tiver um par de chaves SSH no seu sistema, poderá reutilizá-las para autenticação. É possível registrar até 20 chaves públicas por Conta do Google.
O Cloud Source Repositories é compatível com três tipos de chave SSH:
- RSA (somente para chaves com mais de 2048 bits)
- ECDSA
- ED25519
Gerar um par de chaves
O par de chaves SSH consiste em uma chave privada que reside no seu sistema local e uma chave pública registrada no Google Cloud.
Linux ou macOS
Verifique se OpenSSH é instalado no sistema local.
Em um prompt de comando, digite o seguinte:
ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"
Em que:
[USER_EMAIL]
é seu endereço de e-mail;[KEY_TYPE]
é um destes:rsa
ecdsa
ed25519
Exemplo:
ssh-keygen -t rsa -C "user@example.com"
Quando solicitado, insira um nome para o arquivo de chave pública. Para aceitar o local
~/.ssh
padrão, pressione Enter. Caso contrário, especifique um nome de arquivo.Quando solicitado, deixe a senha longa em branco e pressione Enter.
Windows
Verifique se PuTTY é instalado no sistema local.
No menu Iniciar do Windows, inicie o PuTTYGen.
Na janela que é aberta, selecione o tipo de chave no campo Parâmetros.
Clique em Gerar.
O PuTTYGen exibe a string de chave pública gerada.
Especifique uma senha longa para proteger o par de chaves.
Para salvar o par de chaves que você gerou para seu sistema local, clique em Salvar chave pública e Salvar chave privada.
Usar chaves atuais
Também é possível usar um par de chaves atual para a autenticação SSH.
Linux ou macOS
Por padrão, os arquivos de chave pública estão localizados no diretório ~/.ssh
.
Em um prompt de comando, digite o seguinte:
ls -a ~/.ssh
Os nomes de arquivos padrão são:
id_rsa.pub
id_ecdsa.pub
id_ed25519.pub
Windows
No menu Iniciar do Windows, inicie o PuTTYGen.
Na janela que é aberta, clique em Carregar.
Procure o sistema de arquivos local para seu arquivo de chave pública e selecione o arquivo.
O PuTTYGen exibe a string de chave pública. Se você especificou uma senha longa quando salvou o arquivo de chave, o PuTTYGen solicita que você a insira para visualizar a chave pública.
Registrar uma chave pública
No console do Google Cloud, abra a página Gerenciar chaves SSH.
Clique em Registrar chave SSH.
A caixa de diálogo Registrar chave SSH é aberta.
No campo Nome da chave, digite um nome exclusivo para ela.
No campo Chave, copie a string de chave do seu arquivo de chave pública.
Clique em Registrar.
Depois de configurar a autenticação SSH, clonar repositórios em que você tem os papéis e permissões necessários; ou enviar o conteúdo por push de um repositório local para um repositório hospedado vazio.
Fazer a autenticação usando a CLI gcloud
O Cloud Source Repositories permite que você faça a autenticação usando
CLI gcloud. Nesse cenário, você executa o comando
gcloud init
no seu sistema para configurar a autenticação local.
Verifique se a CLI gcloud está instalada no seu sistema local.
No prompt de comando, execute
gcloud init
:gcloud init
Siga as instruções.
Depois de configurar a autenticação usando a CLI gcloud, use comandos padrão do Git para interagir com o repositório hospedado no Cloud Source Repositories.
Autenticar usando credenciais geradas manualmente
Também é possível usar credenciais geradas manualmente para autenticação. O Cloud Source Repositories fornece um conjunto de scripts que podem ser usados para gerar manualmente as credenciais necessárias para acessar os repositórios hospedados.
Acesse a página Configurar Git para gerar suas credenciais.
Abra uma janela de terminal.
Digite o seguinte comando:
git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME
Onde:
- PROJECT_ID é o nome do projeto.
- REPOSITORY_NAME é o nome do repositório.
Depois de configurar a autenticação com credenciais geradas manualmente, é possível interagir com o repositório hospedado no Cloud Source Repositories usando os comandos padrão do Git.