Implemente continuamente a partir de um repositório

Se tiver código fonte ou funções num repositório Git e quiser automatizar as compilações e configurar implementações contínuas a partir de um repositório, pode usar o Cloud Build ou o Developer Connect na consola do Cloud Run.

Quando configura esta opção, o Cloud Run usa um acionador do Cloud Build para compilar e implementar automaticamente o seu código sempre que novos commits são enviados para um determinado ramo de um repositório Git. As informações do repositório de origem são apresentadas na Google Cloud consola do seu serviço depois de implementar no Cloud Run.

Na consola do Cloud Run:

  • Se selecionar o Cloud Build, pode configurar implementações contínuas a partir do GitHub. Para ver um exemplo, consulte o guia de início rápido para criar um repositório de modelos e implementar continuamente a partir do git.

  • Se selecionar Developer Connect (pré-visualização), pode configurar implementações contínuas a partir de repositórios do GitHub, GitLab e Bitbucket.

Em alternativa, pode usar o Cloud Deploy para configurar um pipeline de entrega contínua para implementar serviços do Cloud Run em vários ambientes.

Antes de começar

  • Tem um repositório git com um Dockerfile ou a sua base de código está escrita num dos idiomas suportados pelos buildpacks do Google Cloud.

  • 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

  • Se selecionar a opção Developer Connect (pré-visualização), ative a API Developer Connect:

    Ative a API

Funções necessárias

Para receber as autorizações de que precisa para implementar serviços do Cloud Run a partir do Git através do Cloud Build ou do Developer Connect, peça ao seu administrador que lhe conceda as seguintes funções da IAM no seu projeto:

A conta de serviço que executa a compilação tem de ter as seguintes funções:

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se o seu serviço do Cloud Run interage com Google Cloud APIs, como as bibliotecas cliente da Google Cloud, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Configure a implementação contínua a partir da consola do Cloud Run

O procedimento de configuração varia ligeiramente consoante esteja a configurar a implementação contínua num novo serviço ou num serviço existente. Clique no separador adequado para saber mais.

Novo serviço

  1. Na Google Cloud consola, aceda à página do Cloud Run:

    Aceda ao Cloud Run

  2. Se estiver a criar um novo serviço, clique em Associar repositório para apresentar o formulário Criar serviço.

    Se estiver a modificar um serviço existente, localize-o na lista de serviços e clique nele. Clique em Associar ao repositório.

  3. Selecione Cloud Build ou Developer Connect.

    1. Se selecionou Cloud Build, consulte o artigo Configurar com o Cloud Build.

    2. Se selecionou Developer Connect, consulte o artigo Configure com o Developer Connect.

Serviço existente

  1. Na Google Cloud consola, aceda à página do Cloud Run:

    Aceda ao Cloud Run

  2. Localize o serviço na lista de serviços e clique nele.

  3. Clique em Associar ao repositório e siga as instruções em Configurar com o Cloud Build.

Configure com o Cloud Build

No painel Configurar com o Cloud Build:

  1. Selecione um repositório na lista. Tenha em atenção que o carregamento da lista de repositórios demora alguns momentos. Siga a instrução e clique em Seguinte.

    O GitHub é o fornecedor de repositórios predefinido. Se ainda não tiver feito a autenticação, clique em Autenticar e siga as instruções. A associação de um repositório é feita através da app GitHub do Cloud Build.

    Se não conseguir encontrar o seu repositório, clique no link Gerir repositórios associados. Siga as instruções para conceder ao seu repositório acesso ao Cloud Build.

  2. No passo Configuração da criação, preencha as opções:

    • Branch

      • Indica que origem deve ser usada quando o acionador é executado. Pode colocar a regex aqui. Os ramos correspondentes são validados automaticamente: pode vê-los abaixo da entrada. Tenha em atenção que, se for encontrada exatamente uma ramificação, o acionador é executado automaticamente após a criação.

    • Tipo de compilação

      • Dockerfile: se o repositório tiver de ser criado com o Docker e contiver um Dockerfile, selecione esta opção.

        • Em Localização de origem, especifique a localização e o nome do Dockerfile. Este diretório vai ser usado como o contexto de compilação do Docker. Todos os caminhos devem ser relativos ao diretório atual.

      • Go, Node.js, Python, Java, .NET Core, Ruby ou PHP através dos buildpacks do Google Cloud: se o seu repositório tiver de ser criado com buildpacks, selecione esta opção.

        • Em Criar diretório de contexto, especifique o diretório.
        • Em Entrypoint (opcional), indique o comando para iniciar o servidor. Por exemplo, gunicorn -p :8080 main:app para Python e java -jar target/myjar.jar para Java. Deixe este campo em branco para usar o comportamento predefinido.
        • Em Alvo da função (apenas para implementações de funções), introduza a função a invocar. Caso contrário, deixe este campo em branco.

  3. Clique em Guardar.

  4. A página é recarregada e volta a apresentar o formulário Criar serviço.

  5. Verifique as definições selecionadas na secção Repositório de origem.

  6. Preencha o resto do formulário em Configurar.

  7. Clique em Criar.

    É redirecionado para a página Detalhes do serviço, onde pode acompanhar o progresso da configuração de compilação e implementação a partir do repositório.

Depois de concluir todos os passos, pode:

  • Clique em Editar definições do repositório na consola do Cloud Run para editar o acionador do Cloud Build na consola do Cloud Build.
  • Veja o histórico de compilação clicando no link registos no passo Compilar e implementar a partir do repositório.
  • Veja os detalhes da origem na secção Detalhes da revisão.

Configure a implementação contínua manualmente

Consulte o artigo Configurar a implementação contínua manualmente se precisar de usar um procedimento manual e não a IU.

Anexe um acionador do Cloud Build existente ao serviço do Cloud Run

Se já tiver um acionador do Cloud Build, pode anexá-lo ao serviço adicionando uma etiqueta ao seu serviço do Cloud Run.

Para adicionar uma etiqueta na consola do Cloud Run:

  1. Na Google Cloud consola, aceda à página do Cloud Run:

    Aceda ao Cloud Run

  2. Selecione o seu serviço.

  3. Para o serviço selecionado, clique em Marcadores na parte superior da página para abrir o painel Marcadores.

  4. Adicione uma etiqueta com gcb-trigger-id como chave e o identificador único do acionador do Cloud Build como valor (não o nome do acionador). Se a chave gcb-trigger-id já existir, modifique o valor. Consulte o artigo Defina ou modifique etiquetas para configurar a etiqueta.

Configure com o Developer Connect

No painel Configurar com o Developer Connect:

  1. Selecione um repositório e clique em Seguinte.

    Se não vir o repositório que quer selecionar, clique em Associar novo repositório para abrir o painel Associe novos repositórios através do Developer Connect. Clique no separador adequado para saber mais sobre a ligação a um dos fornecedores de gestão de código fonte.

    GitHub

    Para as opções GitHub, GitHub Enterprise Cloud e GitHub Enterprise, clique em Associar.

    Se não vir uma caixa de diálogo, desative todos os plug-ins do navegador de bloqueio de pop-ups e certifique-se de que as definições do navegador permitem pop-ups. Por exemplo, no Chrome, siga as instruções para permitir pop-ups.

    Conceda autorizações na sua conta do GitHub e associe-as a repositórios através das seguintes instruções. Os comandos que vê no navegador de Internet dependem de a conta do GitHub já ter a app GitHub do Cloud Run instalada.

    Na caixa de diálogo do Cloud Run, conclua os seguintes passos:

    Se vir uma lista de contas do GitHub, instale a app e associe repositórios ao concluir estes passos:

    1. Escolha a conta do GitHub que quer usar.

    2. Selecione um ou mais repositórios aos quais quer conceder acesso.

    Se vir uma mensagem para reutilizar uma instalação de app existente, escolha onde configurar a app seguindo estes passos:

    1. Clique em Conta do GitHub para ver as contas que têm a app Google Cloud Run instalada. Se vir a conta que quer usar, escolha-a clicando em Confirmar.

    2. Se não vir a conta que quer usar, faça o seguinte:

      1. Escolha Instalar a app GitHub noutra conta do GitHub e clique em Confirmar.

      2. Siga os passos do GitHub para permitir a instalação de apps.

      3. Selecione um ou mais repositórios aos quais quer conceder acesso.

    Quando a caixa de diálogo for fechada, a instalação da app está concluída.

    GitLab

    Para a opção GitLab:

    1. Na secção Tokens de acesso pessoal, introduza os tokens para a sua conta:

      • Chave de acesso da API: introduza a chave de acesso pessoal com o âmbito api.
      • Leia a chave de acesso à API: introduza a chave de acesso pessoal com o âmbito read_api.

      É responsável por garantir que os seus tokens do GitLab permanecem válidos. Os tokens do GitLab têm uma duração máxima de 365 dias, salvo especificação em contrário pelo criador do token ou por um administrador. Para saber como gerir as definições e as notificações de expiração de tokens, consulte a documentação do GitLab sobre tokens de acesso pessoal.

      Para mais informações, consulte a documentação do GitLab sobre a expiração do token de acesso pessoal.

    2. Clique em Mostrar mais para ver as definições de configuração opcionais.

    3. Opcional: na secção Encriptação, selecione uma chave CMEK para encriptar segredos do Secret Manager que o Cloud Run cria.

    GitLab Enterprise Edition

    Para a opção GitLab Enterprise Edition:

    1. Para URL do anfitrião, introduza o URL do anfitrião ao qual quer estabelecer ligação.

    2. Na secção Tokens de acesso pessoal, introduza os tokens para a sua conta:

      • Chave de acesso da API: introduza a chave de acesso pessoal com o âmbito api.
      • Leia a chave de acesso à API: introduza a chave de acesso pessoal com o âmbito read_api.

      É responsável por garantir que os seus tokens do GitLab permanecem válidos. Os tokens do GitLab têm uma duração máxima de 365 dias, salvo especificação em contrário pelo criador do token ou por um administrador. Para saber como gerir as definições e as notificações de expiração de tokens, consulte a documentação do GitLab sobre tokens de acesso pessoal.

      Para mais informações, consulte a documentação do GitLab sobre a expiração do token de acesso pessoal.

    3. Clique em Mostrar mais para ver as definições de configuração opcionais.

    4. Opcional: na secção Encriptação, selecione uma chave CMEK para encriptar segredos do Secret Manager que o Cloud Run cria.

    Bitbucket

    Para a opção Bitbucket Cloud:

    1. Para o Workspace, introduza o ID do espaço de trabalho do Bitbucket Cloud.

    2. Na secção Chaves de acesso, introduza as suas chaves de acesso do Bitbucket:

    3. Clique em Mostrar mais para ver as definições de configuração opcionais.

    4. Opcional: na secção Encriptação, selecione uma chave CMEK para encriptar segredos do Secret Manager que o Cloud Run cria.

    Bitbucket Data Center

    Para a opção Bitbucket Data Center:

    1. Para o URL do anfitrião, introduza o URL do anfitrião do Bitbucket Data Center ao qual quer estabelecer ligação.

    2. Na secção Chaves de acesso, introduza as suas chaves de acesso do Bitbucket Cloud:

      • Chave de acesso de administrador: introduza a chave com o acesso ao âmbito de administrador do repositório.

      • Token de acesso de leitura: introduza o token com acesso ao âmbito de leitura do repositório.

    3. Clique em Mostrar mais para ver as definições de configuração opcionais.

    4. Opcional: na secção Encriptação, selecione uma chave CMEK para encriptar segredos do Secret Manager que o Cloud Run cria.

  2. Clique em Ligar. Este processo pode demorar alguns segundos.

  3. No passo Configuração da criação, preencha as opções:

    • Branch

      • Indica que origem deve ser usada quando o acionador é executado. Pode colocar a regex aqui. Os ramos correspondentes são validados automaticamente: pode vê-los abaixo da entrada. Tenha em atenção que, se for encontrada exatamente uma ramificação, o acionador é executado automaticamente após a criação.

    • Tipo de compilação

      • Dockerfile: se o repositório tiver de ser criado com o Docker e contiver um Dockerfile, selecione esta opção.

        • Em Localização de origem, especifique a localização e o nome do Dockerfile. Este diretório vai ser usado como o contexto de compilação do Docker. Todos os caminhos devem ser relativos ao diretório atual.

      • Go, Node.js, Python, Java, .NET Core, Ruby ou PHP através dos buildpacks do Google Cloud: se o seu repositório tiver de ser criado com buildpacks, selecione esta opção.

        • Em Criar diretório de contexto, especifique o diretório.
        • Em Entrypoint (opcional), indique o comando para iniciar o servidor. Por exemplo, gunicorn -p :8080 main:app para Python e java -jar target/myjar.jar para Java. Deixe este campo em branco para usar o comportamento predefinido.
        • Em Alvo da função (apenas para implementações de funções), introduza a função a invocar. Caso contrário, deixe este campo em branco.

  4. Clique em Guardar.

  5. Preencha o resto do formulário em Configurar.

  6. Quando terminar a configuração do serviço, clique em Criar para implementar a imagem no Cloud Run e aguarde que a implementação termine.

  7. Clique no link do URL apresentado para abrir o ponto final único e estável do seu serviço implementado.