Criar e clonar um repositório

Criar e clonar um repositório

Crie um repositório no Secure Source Manager e clone-o na sua máquina local.

Antes de começar

1. Crie ou solicite acesso a uma instância do Secure Source Manager. Para mais informações, consulte Criar uma instância do Secure Source Manager.

2. Instale a CLI do Google Cloud.

3. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

4. Para inicializar a gcloud CLI, execute o seguinte comando:

   gcloud init

Funções exigidas

Para receber as permissões necessárias para criar um repositório, peça ao administrador que conceda a você os seguintes papéis do IAM:

• Função de criador de repositórios de instâncias do Secure Source Manager (roles/securesourcemanager.instanceRepositoryCreator) na instância do Secure Source Manager
• Papel de criador de repositórios do Secure Source Manager (roles/securesourcemanager.repoCreator) no projeto da instância

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Observação: o papel de administrador do Secure Source Manager (roles/securesourcemanager.admin) ou o papel básico do IAM de proprietário (roles/owner) no seu projeto também contém permissões para criar e clonar um repositório. Não conceda papéis de administrador ou papéis básicos em um ambiente de produção, mas é possível fazer isso em um ambiente de desenvolvimento ou de teste.

Para informações sobre como conceder papéis do Secure Source Manager, consulte Controle de acesso com o IAM e Conceder acesso à instância aos usuários.

Criar um repositório

Interface da Web

1. Para acessar a instância do Secure Source Manager pela interface da Web, copie o seguinte URL na barra de endereço do navegador.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Substitua:

   • INSTANCE_ID pelo nome da instância.
   • PROJECT_NUMBER pelo número do projeto da instância Google Cloud. Para informações sobre como identificar projetos, consulte Identificar projetos.
   • LOCATION com a região da instância.

2. Se necessário, faça a autenticação usando suas credenciais do Secure Source Manager.

3. Clique no ícone + Criar repositório no canto superior direito do menu de navegação.

4. Preencha os detalhes do repositório:

   1. ID do repositório: insira um nome para o repositório.

      Observação: os IDs de repositório precisam seguir a convenção de nomenclatura de recursos. Eles precisam incluir apenas letras minúsculas, números ou traços, começar com uma letra e não podem ser alterados depois da criação do repositório.

   2. Descrição: opcional. Descrição do repositório.

      Atenção: não coloque dados sensíveis ou de identificação na descrição ou em outros campos de recursos semelhantes. Esses campos são tratados como dados de serviço de acordo com o Google Cloud Aviso de privacidade.

   3. Ramificação padrão: nome da ramificação padrão.

   4. Inicializar repositório: opcional. Selecione essa opção se quiser inicializar o repositório e adicionar arquivos .gitignore, de licença e README.

   5. .gitignore: opcional. Escolha quais arquivos não rastrear usando os modelos de menu suspenso.

   6. license: opcional. Selecione uma licença comum no menu suspenso.

5. Clique em Criar repositório.

O repositório é criado na sua instância do Secure Source Manager.

O papel de administrador do repositório (roles/securesourcemanager.repoAdmin) é concedido a você quando você cria um repositório. A nova permissão do IAM pode levar até dois minutos para ser propagada. Se você receber um erro de permissões ao tentar acessar o repositório após a criação, aguarde alguns minutos e tente de novo.

Os repositórios que você criou são listados na interface da Web do Secure Source Manager na página Meus repositórios.

Configurar suas credenciais

Adicione o auxiliar de autenticação do Secure Source Manager à sua configuração global do Git executando o seguinte comando:

Linux

git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh

Talvez as versões anteriores do Git não sejam compatíveis com caracteres curinga. Para adicionar o helper de autenticação sem caracteres curinga, execute o seguinte comando:

git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh

Windows

git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd

Talvez as versões anteriores do Git não sejam compatíveis com caracteres curinga. Para adicionar o helper de autenticação sem caracteres curinga, execute o seguinte comando:

git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd

Substitua:

• INSTANCE_ID pelo nome da sua instância do Secure Source Manager.
• PROJECT_NUMBER pelo número do projeto. Para ajuda encontrar o número do projeto, consulte Identificar projetos.
• LOCATION com a região da instância. Para mais informações sobre regiões, consulte Locais.

O auxiliar de autenticação usa a CLI gcloud para buscar suas credenciaisGoogle Cloud ao usar comandos do Git com o Secure Source Manager.

Para autenticar novamente após a configuração inicial das credenciais, execute o seguinte comando da CLI gcloud:

gcloud auth login

Clonar um repositório

1. Na interface da Web do Secure Source Manager, acesse a página do repositório.

2. Copie o URL HTTPS na parte de cima da página do repositório.

3. Clone o repositório executando o seguinte comando:

   git clone REPOSITORY_URL
   

   REPOSITORY_URL é o URL HTTPS exibido na parte de cima da página do repositório que você quer clonar.

   Ignore o aviso sobre clonar um repositório vazio.

Enviar para um repositório

1. Em uma janela de terminal, mude os diretórios para o repositório clonado.

   cd REPOSITORY_NAME
   

   Em que REPOSITORY_NAME é o nome do repositório.

2. Crie um arquivo README vazio:

   touch README.md
   

3. Adicione o arquivo README ao Git e crie uma mensagem de commit:

   git add README.md
   git commit -m "initial commit"
   

4. Envie as mudanças para o repositório remoto:

   git push -u origin main
   

   O Git envia o arquivo da ramificação principal para o repositório remoto de origem. A resposta será semelhante a:

   Enumerating objects: 3, done.
   Counting objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
   Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
   remote: . Processing 1 references
   remote: Processed 1 references in total
   To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   

Ver seus arquivos no Secure Source Manager

Na interface da Web do Secure Source Manager, clique no nome do seu repositório.

A página do repositório é aberta, e o arquivo README.md é listado na guia <> Código.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

Antes de remover o repositório, verifique se os arquivos que você quer manter estão disponíveis em outro local.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto do Google Cloud em que o Secure Source Manager está sendo executado.
• LOCATION: a região em que a instância está localizada. Para informações sobre os locais compatíveis, consulte Locais.
• REPOSITORY_ID: o ID do repositório.

Método HTTP e URL:

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

A resposta será semelhante a esta:

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

A seguir

• Liste e veja repositórios na interface da Web do Secure Source Manager.
• Trabalhe com solicitações de envio e problemas no Secure Source Manager.