Como implantar nas funções do Cloud Run

Nesta página, explicamos como implantar aplicativos em funções do Cloud Run usando o Cloud Build. Se você não estiver familiarizado com o Cloud Build, leia as guias de início rápido e a visão geral da configuração do Build primeiro.

O Cloud Run functions é um ambiente de execução sem servidor para criar e conectar serviços em nuvem, Com ele, você pode escrever funções simples com uma única finalidade e vinculadas a eventos emitidos pela sua infraestrutura e pelos serviços em nuvem. A função é acionada quando um evento que está sendo monitorado é disparado. Para mais informações sobre as funções do Cloud Run, leia a documentação das funções do Cloud Run.

Antes de começar

  • Ative a API Cloud Run functions:

    Ativar a API Cloud Run Functions

  • Conceda o papel de desenvolvedor de funções do Cloud Run à conta de serviço do Cloud Build:

    1. Abra a página Configurações do Cloud Build:

      Abrir a página Configurações do Cloud Build

    2. Defina o status do papel Desenvolvedor das funções do Cloud Run como Ativado.

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

  • Tenha em mãos o código-fonte do aplicativo que você quer criar e implantar no Cloud Run functions. O código-fonte precisa ser armazenado em um repositório, como Cloud Source Repositories, GitHub ou Bitbucket.

Como configurar a implantação

O Cloud Build permite que você use qualquer imagem de contêiner disponível publicamente para executar suas tarefas. Para fazer isso, especifique a imagem em uma step de build no arquivo de configuração do Cloud Build.

As funções do Cloud Run oferecem o comando gcloud functions deploy, que implanta a função do diretório que contém o código dela. Use a imagem cloud-sdk como uma etapa de build no arquivo de configuração para invocar os comandos gcloud na imagem. Os argumentos transmitidos para essa etapa de build são transmitidos diretamente para a CLI do Google Cloud, o que permite executar qualquer comando gcloud nessa imagem.

Para implantar um aplicativo nas funções do Cloud Run, siga estas etapas:

  1. No diretório raiz do projeto, crie o arquivo de configuração do Cloud Build chamado cloudbuild.yaml ou cloudbuild.json.

  2. No arquivo de configuração:

    • Adicione um campo name e especifique a etapa de criação gcloud.
    • Adicione functions deploy ao campo args para invocar o comando gcloud functions deploy. Para ver as opções de configuração disponíveis, consulte a referência do gcloud functions deploy.

    • --source=. indica que o código-fonte está no diretório de trabalho atual.

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args:
  - gcloud
  - functions
  - deploy
  - FUNCTION_NAME
  - --region=FUNCTION_REGION
  - --source=.
  - --trigger-http
  - --runtime=RUNTIME

    JSON

    {
 "steps": [
  {
     "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
     "args": [
       "gcloud",
       "functions",
       "deploy",
        [
          "FUNCTION_NAME"
        ],
        "--region=FUNCTION_REGION",
        "--source=.",
        "--trigger-http",
        "--runtime=RUNTIME"
     ]
   }
  ]
}

    Substitua os valores de marcador no arquivo de configuração acima pelo seguinte:

    • FUNCTION_NAME é o nome das funções do Cloud Run que você está implantando. Se você estiver atualizando uma função existente, esse valor precisará corresponder ao nome da função que você está atualizando.
    • FUNCTION_REGION é a região em que você está implantando funções do Cloud Run. Para conferir uma lista de regiões com suporte, consulte Locais do Cloud Run functions.
    • --trigger-http é o tipo de gatilho desta função. Neste caso, uma solicitação HTTP (webhook).
    • RUNTIME é o ambiente de execução em que a função será executada.

    Para mais informações sobre como usar o gcloud functions deploy, consulte a documentação do Cloud Run functions.

  3. Inicie a compilação usando o arquivo de configuração criado na etapa anterior:

     gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY

    Substitua os valores de marcador no arquivo de configuração acima pelo seguinte:

    • CONFIG_FILE_PATH é o caminho para o arquivo de configuração da compilação;
    • SOURCE_DIRECTORY é o caminho ou o URL do código-fonte.
    • REGION é uma das regiões de build com suporte.

    Se você não especificar CONFIG_FILE_PATH e SOURCE_DIRECTORY no comando gcloud builds submit, o Cloud Build presumirá que o arquivo de configuração e o código-fonte estão no diretório de trabalho atual.

Implantação contínua

É possível automatizar a implantação do software nas funções do Cloud Run criando gatilhos do Cloud Build. Configure os acionadores para criar e implantar imagens sempre que atualizar o código-fonte.

Para automatizar a implantação no Cloud Run functions:

  1. Na raiz do repositório, adicione um arquivo de configuração com etapas para invocar o comando gcloud functions deploy:

    YAML

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args:
  - gcloud
  - functions
  - deploy
  - FUNCTION_NAME
  - --region=FUNCTION_REGION
  - --source=.
  - --trigger-http
  - --runtime=RUNTIME

    JSON

    {
 "steps": [
  {
     "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
     "args": [
       "gcloud",
       "functions",
       "deploy",
        [
          "FUNCTION_NAME"
        ],
        "--region=FUNCTION_REGION",
        "--source=.",
        "--trigger-http",
        "--runtime=RUNTIME"
     ]
   }
  ]
}

    Substitua os valores de marcador no arquivo de configuração acima pelo seguinte:

    • FUNCTION_NAME é o nome das funções do Cloud Run que você está implantando. Se você estiver atualizando uma função existente, esse valor precisará corresponder ao nome da função que você está atualizando.
    • FUNCTION_REGION é a região em que você está implantando funções do Cloud Run. Para conferir uma lista de regiões compatíveis, consulte Locais do Cloud Run functions.
    • --trigger-http é o tipo de gatilho desta função. Neste caso, uma solicitação HTTP (webhook).
    • RUNTIME é o ambiente de execução em que a função será executada.

  2. Crie um gatilho de compilação com o arquivo de configuração criado na etapa anterior:

    1. Abra a página Gatilhos no console do Google Cloud:

      Abrir a página "Gatilhos"

    2. Selecione o projeto no menu suspenso do seletor na parte de cima da página.

    3. Clique em Criar gatilho.

    4. No campo Nome, insira um nome para o gatilho.

    5. Em Região, selecione a região do acionador.

    6. Em Evento, selecione o evento do repositório para iniciar o gatilho.

    7. Em Origem, selecione o repositório e o nome da ramificação ou da tag que iniciará o gatilho. Para mais informações sobre como especificar quais ramificações precisam ser criadas automaticamente, consulte Como criar um gatilho de compilação.

    8. Em Configuração, selecione Arquivo de configuração do Cloud Build (YAML ou JSON).

    9. No campo local do arquivo de configuração do Cloud Build, digite cloudbuild.yaml depois do /.

    10. Clique em Criar para salvar o gatilho de compilação.

Sempre que você enviar um novo código para o repositório, acionará automaticamente uma build e implantará no Cloud Functions.

Para mais informações sobre como criar gatilhos do Cloud Build, consulte Como criar e gerenciar gatilhos de build.

A seguir