Como clonar um repositório

Neste tópico, você aprenderá como clonar o conteúdo de um repositório do Cloud Source Repositories para sua máquina local.

Antes de começar

O comando a seguir é necessário para clonar o conteúdo de um repositório:

• É preciso ter autenticação em seu sistema local.

  As etapas para clonar um repositório variam de acordo com o tipo de autenticação (SSH, Google Cloud CLI ou credenciais geradas manualmente).

• É preciso ter um repositório no Cloud Source Repositories.

• É preciso ter permissões para interagir com o repositório.

• O repositório a ser clonado não pode ter um nome restrito, como All-Users ou All-Projects.

Clonar usando SSH

Se você não estiver usando credenciais geradas manualmente ou a CLI gcloud, será possível clonar um repositório usando SSH.

Console

1. No console do Google Cloud, abra o Cloud Source Repositories.

   Abrir o Cloud Source Repositories

2. Mantenha o ponteiro do mouse sobre o repositório que você quer clonar.

3. Clique em Clonar .

   Uma caixa de diálogo com opções de autenticação é aberta.

4. Clique na guia Autenticação SSH e siga as instruções para clonar o repositório.

gcloud

1. Verifique se você está autenticado com SSH em sua máquina local.

2. Em seu sistema local, use seu nome de usuário do Google Cloud e o caminho SSH totalmente qualificado do seu repositório para cloná-lo:

   git clone ssh://[EMAIL]@source.developers.google.com:2022/p/[PROJECT_ID]/r/[REPO_NAME]
   

   Em que:

   • [EMAIL] é seu nome de usuário do Google Cloud;
   • [PROJECT_ID] é o ID do projeto do Google Cloud em que o repositório está localizado;
   • [REPO_NAME] é o nome do repositório.

   Exemplo:

   git clone ssh://[e-mail]@source.developers.google.com:2022/p/example-project/r/test-repo
   

Na primeira vez que você se conectar ao Cloud Source Repositories usando SSH, será solicitado que você confirme as impressões digitais da chave SSH para o host remoto. O nome do host para o serviço de repositório é source.developers.google.com. As impressões digitais são:

none
SHA256:AGvEpqYNMqsRNIviwyk4J4HM0lEylomDBKOWZsBn434
MD5:74:84:6c:08:d5:b5:54:68:19:da:2a:8e:4c:5b:d3:0d

Clonar usando a CLI gcloud

Se você não estiver usando SSH ou credenciais geradas manualmente, poderá clonar um repositório usando a CLI gcloud.

Console

1. No Console do GCP, abra o Cloud Source Repositories.

   Abrir o Cloud Source Repositories

2. Mantenha o ponteiro do mouse sobre o repositório que você quer clonar.

3. Clique em Clonar .

   Uma caixa de diálogo com opções de autenticação é aberta.

4. Clique na guia SDK do Google Cloud e siga as instruções para clonar seu repositório.

gcloud

1. Verifique se a CLI gcloud está instalada no sistema local.

2. Em uma janela de terminal, forneça suas credenciais de autenticação:

   gcloud init
   

3. Clone seu repositório:

   gcloud source repos clone [REPO_NAME] --project=[PROJECT_NAME]
   

   Em que:

   • [REPO_NAME] é o nome do repositório;
   • [PROJECT_NAME] é o nome do projeto do Google Cloud.

   Exemplo:

   gcloud source repos clone test-repo --project=example-project
   

Clonar usando credenciais geradas manualmente

Se você não estiver usando SSH ou a CLI gcloud, será possível clonar um repositório usando credenciais geradas manualmente.

Console

1. No Console do GCP, abra o Cloud Source Repositories.

   Abrir o Cloud Source Repositories

2. Mantenha o ponteiro do mouse sobre o repositório que você quer clonar.

3. Clique em Clonar .

   Uma caixa de diálogo com opções de autenticação é aberta.

4. Clique na guia Credenciais geradas manualmente e siga as instruções para clonar seu repositório.

gcloud

1. Certifique-se de ter gerado e armazenado suas credenciais do Git.

2. Em uma janela de terminal, digite o seguinte comando:

   git clone https://source.developers.google.com/p/[PROJECT_NAME]/r/[REPO_NAME]
   

   Em que:

   • [PROJECT_NAME] é o nome do projeto;
   • [REPO_NAME] é o nome do repositório.

A seguir

• Depois de clonar um repositório na sua máquina local, é possível explorar os guias de início rápido para saber como o Cloud Source Repositories se integra com outros serviços do Google Cloud.