Crie e clone um repositório

Crie e clone um repositório

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

Antes de começar

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

2. Install the Google Cloud CLI.

3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

4. To initialize the gcloud CLI, run the following command:

   gcloud init

5. Instale o componente da alphaCLI do Google Cloud:

   gcloud components install alpha

Funções necessárias

Para receber as autorizações de que precisa para criar um repositório, peça ao seu administrador que lhe conceda as seguintes funções do IAM:

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

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Nota: a função de administrador do Secure Source Manager (roles/securesourcemanager.admin) ou a função básica do IAM de proprietário (roles/owner) no seu projeto também contém autorizações para criar e clonar um repositório. Não deve conceder funções de administrador nem funções básicas num ambiente de produção, mas pode concedê-las num ambiente de desenvolvimento ou de teste.

Para obter informações sobre a concessão de funções do Secure Source Manager, consulte os artigos Controlo de acesso com o IAM e Conceda aos utilizadores acesso à instância.

Crie um repositório

Interface Web

1. Para aceder à instância do Secure Source Manager através da respetiva interface Web, copie o seguinte URL para a barra de endereço do navegador.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Substitua o seguinte:

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

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

3. Clique no ícone + Criar novo repositório na parte superior direita do menu de navegação.

4. Preencha os detalhes do repositório:

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

      Nota: os IDs dos repositórios têm de seguir a convenção de nomenclatura de recursos. Têm de incluir apenas letras minúsculas, números ou travessões, têm de começar por uma letra e não podem ser alterados após a criação do repositório.

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

      Aviso: não coloque dados confidenciais ou de identificação na descrição nem noutros campos de recursos semelhantes. Estes campos são tratados como dados do serviço de acordo com o Google Cloud Aviso de Privacidade.

   3. Agência predefinida: nome da agência predefinida.

   4. Inicializar repositório: opcional. Selecione esta opção se quiser inicializar o repositório e adicionar ficheiros .gitignore, license e README.

   5. .gitignore: opcional. Escolha os ficheiros que não quer monitorizar através dos modelos do menu pendente.

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

5. Clique em Criar repositório.

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

A função de administrador do repositório (roles/securesourcemanager.repoAdmin) é-lhe concedida quando cria um novo repositório. A nova autorização do IAM pode demorar até 2 minutos a propagar-se. Por isso, se receber um erro de autorizações quando tentar aceder ao repositório após a criação, aguarde alguns minutos e tente novamente.

Os repositórios que criou são apresentados na interface Web do Secure Source Manager na página Os meus repositórios.

Configure as suas credenciais

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

Linux

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

As versões anteriores do Git podem não suportar carateres universais. Para adicionar o auxiliar de autenticação sem carateres universais, 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

As versões anteriores do Git podem não suportar carateres universais. Para adicionar o auxiliar de autenticação sem carateres universais, execute o seguinte comando:

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

Substitua o seguinte:

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

O auxiliar de autenticação usa a CLI gcloud para obter as suas Google Cloud credenciais quando usa comandos 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

Clone um repositório

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

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

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

   git clone REPOSITORY_URL
   

   Onde REPOSITORY_URL é o URL HTTPS apresentado na parte superior da página do repositório que quer clonar.

   Ignore o aviso sobre a clonagem de um repositório vazio.

Envie para um repositório

1. Numa janela de terminal, altere os diretórios para o repositório clonado.

   cd REPOSITORY_NAME
   

   Onde REPOSITORY_NAME é o nome do repositório.

2. Crie um ficheiro README vazio:

   touch README.md
   

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

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

4. Envie as alterações para o repositório remoto:

   git push -u origin main
   

   O Git envia o ficheiro do ramo principal para o repositório remoto de origem. O resultado é semelhante ao seguinte:

   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'.
   

Veja os seus ficheiros no Secure Source Manager

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

A página do repositório é aberta e o ficheiro README.md é apresentado no separador <> Código.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

Antes de remover o repositório, certifique-se de que os ficheiros que quer manter estão disponíveis noutra localização.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto do projeto do Google Cloud onde o Secure Source Manager está a ser executado.
• LOCATION: a região onde a sua instância está localizada. Para ver informações sobre as localizações suportadas, consulte o artigo Localizações.
• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando 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

Deve receber uma resposta JSON semelhante à seguinte:

"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 é semelhante à seguinte:

{"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"}

O que se segue?

• Liste e veja repositórios na interface Web do Secure Source Manager.
• Trabalhe com pedidos de obtenção e problemas no Secure Source Manager.