Esta página foi traduzida pela API Cloud Translation.

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

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.
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
Instale o componente alpha da Google Cloud CLI:
```
gcloud components install alpha
```

Funções exigidas

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

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

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

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 Google Cloud da instância. Para informações sobre como identificar projetos, consulte Identificar projetos.
- LOCATION com a região da instância.
Autentique usando suas credenciais do Secure Source Manager, se necessário.
Clique no ícone + Criar repositório no canto superior direito do menu de navegação.
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. Inicializar repositório: opcional. Selecione essa opção se quiser inicializar o repositório e adicionar arquivos .gitignore, de licença e README.
4. .gitignore: opcional. Escolha quais arquivos não rastrear usando os modelos de menu suspenso.
5. license: opcional. Selecione uma licença comum no menu suspenso.
6. Ramificação padrão: nome da ramificação padrão.
Clique em Enviar.

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. Por isso, 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

Versões anteriores do Git podem não ser 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

Versões anteriores do Git podem não ser 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 com o nome da sua instância do Secure Source Manager.
PROJECT_NUMBER pelo número do projeto. Para saber como 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 fazer a reautenticação após a configuração inicial das credenciais, execute o seguinte comando da CLI gcloud:

gcloud auth login

Clonar um repositório

Na interface da Web do Secure Source Manager, acesse a página do repositório.
Copie o URL HTTPS na parte de cima da página do repositório.
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

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.
Crie um arquivo README vazio:
```
touch README.md
```
Adicione o arquivo README ao Git e crie uma mensagem de commit:
```
git add README.md
git commit -m "initial commit"
```

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

git push -u origin main

O Git envia o arquivo da ramificação principal para a origem remota. 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ê fez login na CLI 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. . É possível verificar a conta ativa atual executando 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ê fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando 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.