Como implantar Cloud Functions
Deployment
Para realizar as implantações, faça upload de um arquivo contendo o código-fonte da função em um bucket do Cloud Storage. Depois de fazer upload do código-fonte, o Cloud Build vai criar automaticamente o código em uma imagem de contêiner e enviar essa imagem ao Artifact Registry ou ao Container Registry. O Cloud Functions usa essa imagem para criar o contêiner que executa a função.
Mais especificamente:
- Iniciar uma implantação compacta seu código-fonte, incluindo todos os arquivos, exceto aqueles que correspondem a um padrão
.gcloudignore
. Depois que o código-fonte é compactado e enviado, uma versão é enviada ao Cloud Build. A versão usa o comando
pack build
comgcr.io/buildpacks/builder:v1
para criar seu contêiner. Essa ação faz o seguinte:- Usa a imagem base do Ubuntu.
- Instala o ambiente de execução da linguagem.
- Instala o framework do Functions, se ainda não houver.
- Instala as dependências do usuário.
- Exporta a imagem OCI.
O armazenamento em cache ajuda a tornar essas etapas mais rápidas. Assista a este vídeo para uma visão geral do processo.
Para mais informações sobre onde a imagem de uma função é armazenada, consulte Como criar imagens do Cloud Functions.
Opções de implantação
É possível implantar o Cloud Functions a partir da máquina local, do repositório de origem do GitHub ou do Bitbucket (usando o Cloud Source Repositories) ou diretamente da API Cloud Functions.
- Como implantar do computador local
- Como implantar do controle de origem
- Como implantar a partir do Console do Cloud
- Como implantar da API Cloud Functions
Durante a implantação, o Cloud Functions procura arquivos específicos, dependendo do ambiente de execução. Consulte Como gravar Cloud Functions para detalhes. Antes da conclusão da implantação da função, o Cloud Functions enviará uma solicitação de teste para confirmar que ela foi implantada com sucesso.
Como migrar entre implantações
A primeira implantação de uma função pode levar vários minutos para ser concluída enquanto a infraestrutura subjacente é provisionada. Reimplantar uma função existente é mais rápido, e o tráfego de entrada será automaticamente migrado para a versão mais recente da sua função.
Conceitos básicos
Conforme você aprende sobre as diferentes maneiras de implantar funções, é útil entender algumas terminologias básicas. Quando você implanta uma função, ela é exibida no Console do Cloud, conforme mostrado abaixo. Em particular, observe os campos Nome e Função executada:
- O campo Nome é o nome registrado que você atribui à função.
- O campo Função executada é o nome da função real no código-fonte executada quando a função implantada é chamada.
Esses dois campos podem ter o mesmo nome ou os nomes podem ser diferentes. Observe
abaixo que as duas primeiras funções têm nomes registrados diferentes
dos executados. A última função usa o mesmo nome para os dois
campos: helloHttp
.
Como criar e testar localmente
O Cloud Functions é executado em ambientes de execução com base em linguagens e frameworks de código aberto para que você possa criar e testar suas funções localmente usando ferramentas de ambiente de execução e desenvolvimento padrão.
Também é possível usar o Functions Framework para executar e depurar suas funções localmente para tempos de execução compatíveis e facilitar o teste e a depuração.
A seguir
- Como chamar funções HTTP.
- Como chamar funções de acionamento do Cloud Storage.
- Como chamar funções de acionamento do Cloud Pub/Sub.
- Tutorial do Cloud Functions HTTP.
- Tutorial do Cloud Functions com o Cloud Storage.
- Tutorial do Cloud Functions com o Cloud Pub/Sub.