Como implantar nas funções do Cloud Run

Nesta página, explicamos como implantar aplicativos nas 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 as funções do Cloud Run, você escreve código simples e de finalidade única vinculadas a eventos emitidos pela infraestrutura em nuvem e serviços. A função é acionada quando um evento em análise é 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 de funções do Cloud Run:

    Ative a API de funções do Cloud Run

  • Conceder o papel de Desenvolvedor de funções do Cloud Run ao serviço de build conta:

    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 de funções do Cloud Run como Ativado.

  • Para executar os comandos gcloud desta página, instale o Google Cloud CLI.

  • Tenha em mãos o código-fonte do aplicativo que você quer criar e implantar nas funções do Cloud Run. 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. Você pode usar o Imagem cloud-sdk como uma etapa de build no arquivo de configuração para invocar comandos gcloud na imagem. Os argumentos passados para essa etapa de build são transmitidos diretamente para a Google Cloud CLI. permitindo que você execute 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 de funções do Cloud Run.
    • --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 gcloud functions deploy, consulte a Documentação de funções do Cloud Run.

  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

Para automatizar a implantação do seu software nas funções do Cloud Run, crie gatilhos do Cloud Build. Configure os acionadores para criar e implantar imagens sempre que atualizar o código-fonte.

Para automatizar sua implantação nas funções do Cloud Run:

  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 uma lista de regiões compatíveis, consulte Locais das funções do Cloud Run.
    • --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 de projetos na parte superior 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 Cloud Build. arquivo de configuração (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 criar e implantar funções do Cloud Run.

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

A seguir