Associe um repositório do GitHub

Esta página explica como associar um repositório do GitHub ao Cloud Build. Para saber mais sobre os repositórios do Cloud Build, consulte o artigo Repositórios do Cloud Build.

Antes de começar

  • Enable the Cloud Build API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  • Tenha o código fonte pronto num repositório do GitHub.
  • Ter um Dockerfile ou um ficheiro de configuração do Cloud Build no seu repositório de origem do GitHub.
  • Se estiver a associar inicialmente o seu repositório ao Cloud Build, certifique-se de que tem autorizações ao nível de administrador no seu repositório. Para saber mais sobre as autorizações de repositórios do GitHub, consulte o artigo Níveis de autorização de repositórios para uma organização.

  • Para usar os comandos gcloud nesta página, instale a CLI do Google Cloud.

Associe um repositório do GitHub

Para associar o seu repositório do GitHub ao Cloud Build:

  1. Abra a página Repositórios na Google Cloud consola.

    Abra a página Repositórios

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

  3. Na parte superior da página, selecione o separador 1.ª geração.

  4. Clique em Associar repositório.

    É apresentado o painel Associar repositório.

    1. Em Selecionar fornecedor de gestão de código fonte, selecione GitHub App GitHub do Cloud Build.

    2. Clique em Continuar.

      Pode ser-lhe pedido que autentique a sua ligação ao GitHub ou instale a app GitHub. Se ainda não o fez, conclua os seguintes passos:

      1. Se nunca iniciou sessão no GitHub, faça-o agora.

        É apresentada a página de autorização, onde autoriza a app Google Cloud Build a estabelecer ligação a Google Cloud.

        Captura de ecrã do botão Autorizar

      2. Clique em Autorizar o Google Cloud Build por GoogleCloudBuild.

      3. Clique em Instalar Google Cloud Build.

      4. Na caixa de diálogo apresentada, selecione o seu nome de utilizador ou organização do GitHub.

      5. Selecione uma das seguintes opções com base nas necessidades da sua empresa:

        • Todos os repositórios: ative os repositórios do GitHub atuais e futuros para acesso através da app Cloud Build

        • Selecionar apenas repositórios: use o menu pendente Selecionar repositórios para ativar apenas repositórios específicos para acesso através da app Cloud Build.

        Pode ativar repositórios adicionais mais tarde. Se selecionar Todos os repositórios como opção, a app Cloud Build é autorizada a aceder a todos os seus repositórios. No entanto, tem de associar cada novo repositório através do Cloud Build, seguindo os passos descritos nesta secção.

      6. Clique em Instalar para instalar a app Cloud Build.

        A caixa de diálogo é fechada e é apresentada a página Repositórios.

    3. Na secção Selecionar repositório, selecione os seguintes campos:

      • Conta do GitHub: a conta do GitHub usada para instalar a app GitHub do Cloud Build. Este campo pode estar pré-selecionado para si.

      • Repositório: os repositórios aos quais quer ligar o Cloud Build.

      Se não vir um ou mais dos seus repositórios de destino, clique em Editar repositórios no GitHub para ativar repositórios adicionais na app GitHub do Cloud Build. Em seguida, pode selecionar o novo repositório de destino na secção Selecionar repositório.

    4. Depois de selecionar a sua conta e repositórios do GitHub, leia a exclusão de responsabilidade de consentimento e selecione a caixa de verificação junto à mesma para indicar que aceita os termos apresentados.

    5. Clique em Ligar.

    6. (Opcional) Na secção Criar um acionador, selecione os repositórios para os quais quer criar um acionador no campo Criar um acionador de exemplo para estes repositórios. Depois de selecionar os repositórios, clique em Criar um acionador.

    7. Clique em Concluído.

(Opcional) Atualizar a conta do GitHub autenticada

Se precisar de atualizar a conta do GitHub associada à sua Conta Google, pode navegar para a página Autenticar com o GitHub. Pode ter de o fazer se reparar que a página do repositório do Cloud Build Connect indica que a app GitHub não está instalada em nenhum repositório depois de instalar a app Cloud Build no GitHub.

O que se segue?