Conectar-se a um host do GitLab

Console

Para conectar seu host do GitLab ao Cloud Build:

1. Abra a página Repositórios no console do Google Cloud .

   Abrir a página Repositórios

   A página Repositórios vai aparecer.

2. Na parte de cima da página, selecione a guia 2ª geração.

3. No seletor de projetos, na barra superior, selecione seu projeto Google Cloud .

4. Clique em Criar conexão de host para conectar um novo host ao Cloud Build.

5. No painel à esquerda, selecione GitLab como seu provedor de origem.

6. Na seção Configurar conexão, insira as seguintes informações:

   1. Região: selecione uma região para sua conexão.

   2. Nome: insira um nome para a conexão.

7. Na seção Detalhes do host, selecione ou insira as seguintes informações:

   1. Provedor do GitLab: selecione GitLab.com como seu provedor.

8. Na seção Tokens de acesso pessoal, insira as seguintes informações:

   1. Token de acesso à API: insira o token com o acesso ao escopo api. Esse token é usado para conectar e desconectar repositórios.

   2. Ler token de acesso à API: insira o token com o acesso ao escopo read_api. Os gatilhos do Cloud Build usam esse token para acessar o código fonte nos repositórios.

9. Clique em Conectar.

   Depois de clicar no botão Conectar, seus tokens de acesso pessoal serão armazenados com segurança no Secret Manager. Depois da conexão de host, o Cloud Build também cria um segredo de webhook em seu nome. Você pode acessar e gerenciar seus secrets na página Secret Manager.

Você criou uma conexão do GitLab.

gcloud

Antes de conectar seu host do GitLab ao Cloud Build, siga estas etapas para armazenar suas credenciais:

1. Armazene seu token no Secret Manager.

2. Crie um secret de webhook no Secret Manager executando o seguinte comando:

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create my-gle-webhook-secret --data-file=-
   

3. Se você armazenar seus segredos em um projeto Google Cloud diferente daquele que planeja usar para criar uma conexão de host, insira o seguinte comando para conceder ao seu projeto acesso ao agente de serviço do Cloud Build:

   PN=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")
   CLOUD_BUILD_SERVICE_AGENT="service-${PN}@gcp-sa-cloudbuild.iam.gserviceaccount.com"
   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:${CLOUD_BUILD_SERVICE_AGENT}" \
     --role="roles/secretmanager.admin"
   

   Em que:

   • PROJECT_ID é o ID do projeto Google Cloud .

Agora você pode conectar seu host do GitLab ao Cloud Build.

Siga estas etapas:

Para conectar seu host do GitLab ao Cloud Build:

1. Insira o seguinte comando para criar uma conexão do GitLab:

   gcloud builds connections create gitlab CONNECTION_NAME \
     --host-uri=HOST_URI \
     --project=PROJECT_ID \
     --region=REGION \
     --authorizer-token-secret-version=projects/PROJECT_ID/secrets/API_TOKEN/versions/SECRET_VERSION \
     --read-authorizer-token-secret-version=projects/PROJECT_ID/secrets/READ_TOKEN/versions/SECRET_VERSION \
     --webhook-secret-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET/versions/SECRET_VERSION
   

   Em que:

   • CONNECTION_NAME é o nome da sua conexão de host do GitLab no Cloud Build.
   • HOST_URI é o URI da sua instância do GitLab. Por exemplo, https://my-gle-server.net.
   • PROJECT_ID é o ID do projeto Google Cloud .
   • REGION é a região da sua conexão.
   • API_TOKEN é o nome do seu token com o apiscope.
   • READ_TOKEN é o nome do seu token com o read_apiscope.
   • SECRET_VERSION é a versão do seu secret.
   • WEBHOOK_SECRET é o secret do webhook.

Você criou uma conexão do GitLab.