O Function Compute oferece suporte ao versionamento de funções para facilitar a implementação de integração contínua e entrega contínua (CI/CD) em todo o ciclo de desenvolvimento de software. Publique uma versão estável para o tráfego de produção enquanto continua o desenvolvimento na versão LATEST, sem afetar os usuários ativos.
Como funciona
O controle de versão no Function Compute opera no nível da função. Publicar uma versão captura o código e a configuração atuais como um snapshot imutável. Após a publicação, a versão não pode ser modificada; seu número aumenta monotonicamente e não pode ser reutilizado.
O snapshot inclui:
Configurações principais da função: runtime, handler e comando de inicialização
Configuração de instância: tipo de instância, simultaneidade de instância e hooks de ciclo de vida da instância
Recursos associados: layers, variáveis de ambiente, logs, rede, armazenamento, verificações de integridade, DNS personalizado e permissões (função)
Alternar entre versões não exige alterações no código ou na configuração da função.
O diagrama a seguir ilustra como as versões e a versão LATEST coexistem.
O que não está incluído no snapshot
Gatilhos e configurações de tarefas assíncronas ficam fora do snapshot da versão. Configure-os independentemente para cada versão após a publicação. As políticas de Auto Scaling aplicam-se apenas no nível de alias; configure-as em um alias, não diretamente em uma versão.
A tabela a seguir mostra quais itens de configuração podem ser vinculados a versões e aliases.
|
**Item de configuração** |
**Version** |
**Alias** |
|
Lógica de código |
|
|
|
|
|
|
|
Especificações da instância, simultaneidade da instância, hook de ciclo de vida da instância |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Layer, variável de ambiente, logs, rede, armazenamento, verificação de integridade, DNS personalizado, permissões (função) |
|
|
Observações de uso
Toda função começa com a versão LATEST. Antes de publicar qualquer versão, a LATEST é a única existente e não pode ser excluída.
Uma versão publicada é imutável. Seu número é incrementado automaticamente e não pode ser reutilizado.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma função. Para mais informações, consulte Crie uma função
Publicar uma versão
Faça login no console do Function Compute. No painel de navegação à esquerda, clique em Functions.
Na barra de navegação superior, selecione uma região. Na página Functions, clique em a função desejada.
Clique em a aba Versions e depois em Publish Version.
No painel Publish Version, insira uma descrição da versão e clique em OK.
A nova versão aparece na aba Versions. A partir daí, exclua versões desnecessárias ou defina uma versão como principal ou canary de um alias.
Uma versão recém-publicada não possui gatilhos. Configure os gatilhos para a versão independentemente após a publicação.
Antes de excluir uma versão, remova todos os aliases e gatilhos associados a ela. Exclua uma versão remove apenas o código e a configuração da função; os aliases que apontam para a versão e seus gatilhos são mantidos. Chamar um alias que aponta para uma versão excluída retorna um erro.
Próximos passos
Para definir uma versão como destino de lançamento principal ou canary de um alias, consulte Gerencie aliases e Usar versões e aliases para implementar o lançamento canary.
Para publicar versões usando a CLI, consulte o Guia do usuário para versão na documentação do Serverless Devs.