Conectar-se a um repositório do GitHub

Nesta página, explicamos como conectar um repositório do GitHub ao Cloud Build. Para saber mais sobre os repositórios do Cloud Build, consulte 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 em um repositório do GitHub.
  • Tenha um Dockerfile ou um arquivo de configuração do Cloud Build no seu repositório de origem do GitHub.
  • Se você estiver conectando o repositório ao Cloud Build inicialmente, verifique se tem permissões no nível do administrador no repositório. Para saber mais sobre as permissões de repositório do GitHub, consulte Níveis de permissão de repositório para uma organização.

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

Conectar a um repositório do GitHub

Para conectar seu repositório do GitHub ao Cloud Build:

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

    Abrir a página Repositórios

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

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

  4. Clique em Conectar repositório.

    O painel Conectar repositório vai aparecer.

    1. Em Selecionar provedor de gerenciamento de código-fonte, selecione GitHub app GitHub do Cloud Build.

    2. Clique em Continuar.

      Talvez seja necessário autenticar sua conexão com o GitHub ou instalar o app GitHub. Se ainda não tiver feito isso, conclua as seguintes etapas:

      1. Se você não tiver feito login no GitHub, faça isso agora.

        A página "Autorização" é exibida, onde você autoriza o app Google Cloud Build a se conectar ao Google Cloud.

        Captura de tela do botão de autorização

      2. Clique em Autorizar Google Cloud Build por GoogleCloudBuild.

      3. Clique em Instalar o Google Cloud Build .

      4. Na caixa de diálogo exibida, selecione seu nome de usuário ou organização do GitHub.

      5. Selecione uma das seguintes opções com base na necessidade do seu negócio:

        • Todos os repositórios: ative os repositórios atuais e futuros do GitHub para acesso usando o app Cloud Build.

        • Selecionar apenas repositórios: use a lista suspensa Selecionar repositórios para ativar apenas repositórios específicos para acesso usando o aplicativo Cloud Build.

        É possível ativar outros repositórios mais tarde. Se você selecionar Todos os repositórios, o app Cloud Build terá autorização para acessar todos os seus repositórios. No entanto, é necessário conectar cada novo repositório pelo Cloud Build seguindo as etapas descritas nesta seção.

      6. Clique em Instalar para instalar o aplicativo Cloud Build.

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

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

      • Conta do GitHub: a conta do GitHub usada para instalar o app GitHub do Cloud Build. Esse campo pode estar pré-selecionado para você.

      • Repositório: os repositórios que você quer conectar ao Cloud Build.

      Se você não encontrar um ou mais repositórios de destino, clique em Editar repositórios no GitHub para ativar outros repositórios no aplicativo do GitHub do Cloud Build. Em seguida, selecione o novo repositório de destino na seção Selecionar repositório.

    4. Depois de selecionar sua conta do GitHub e os repositórios, leia a exoneração de responsabilidade de consentimento e marque a caixa de seleção ao lado para indicar que você aceita os termos apresentados.

    5. Clique em Connect.

    6. (Opcional) Na seção Criar um gatilho, selecione os repositórios para os quais você quer criar um gatilho no campo Criar um gatilho de amostra para esses repositórios de dados. Depois de selecionar os repositórios, clique em Criar um gatilho.

    7. Clique em Concluído.

(Opcional) Como atualizar a conta autenticada do GitHub

Se você precisar atualizar a conta do GitHub associada à sua Conta do Google, acesse a página Autenticar com o GitHub. Talvez seja necessário fazer isso se perceber que a Página do repositório do Cloud Build Connect indica que o aplicativo GitHub não está instalado em nenhum repositório após a instalação do app Cloud Build no GitHub.

A seguir