Todos os produtos
Search
Central de documentação

Function Compute:Gerenciar aliases

Última atualização: Jun 29, 2026

No Function Compute, crie aliases para versões de funções. A combinação de aliases e versões permite implementar integração contínua e releases dentro de um Ciclo de Vida de Desenvolvimento de Software (SDLC). Este tópico descreve os aliases e explica como gerenciá-los no console do Function Compute.

O que é um alias?

No Function Compute, um alias funciona como um ponteiro para uma versão específica da função. Aliases facilitam a publicação de versões, a execução de rollbacks e a implementação de canary releases. Todo alias deve estar associado a uma função ou versão. Ao acessar uma função por meio de um alias, o Function Compute resolve o alias para a versão correspondente. Assim, o cliente que invoca a função não precisa conhecer a versão específica.

Considere, por exemplo, um gatilho HTTP. Sem um alias, atualize manualmente o número da versão associada ao gatilho sempre que publicar uma nova versão. Esse processo pode interromper os serviços dos clientes. O uso de um alias permite atualizações de versão graduais. Aponte um alias chamado PROD para a versão estável 1. Dessa forma, os clientes invocam a versão 1 da função usando o alias PROD (Figura 1). Ao publicar a versão 2, atualize o alias PROD para apontar para ela. Os clientes passam então a invocar a versão 2 da função utilizando o mesmo alias PROD (Figura 2).

Atualização gradual de versão

Figura 1. Publicar versão 1

image

Após publicar a versão 1, continue desenvolvendo novos recursos na versão LATEST. Como os clientes utilizam o alias para invocar a função, atualize o alias PROD para apontar para a versão 2 quando estiver pronto para publicá-la. Quando um cliente invoca a função usando o alias PROD, o Function Compute resolve o alias para a versão 2. Esse processo simplifica as atualizações e iterações de versão.

Figura 2. Publicar versão 2

image

Rollback rápido

Caso a versão 2 apresente problemas, aponte o alias PROD novamente para a versão 1 para reverter à versão anterior. Essa operação não afeta os clientes.

Canary release

Use um alias para controlar o tráfego em um canary release. Por exemplo, direcione 5% do tráfego de produção para a nova versão 2 para testes canary. Em seguida, transfira gradualmente todo o tráfego para a versão 2. Essa abordagem reduz os riscos associados à implantação de uma nova versão.

Figura 3. Canary release

image

Itens de configuração compatíveis com aliases

Os itens de configuração compatíveis com um alias são independentes do código e das configurações principais da função. Eles se relacionam apenas ao acionamento e à execução da função, como gatilhos, políticas de elasticidade e modos de tarefa. Um alias representa um ambiente diferente. Ao definir configurações em um alias, troque de versão sem alterar o código ou as configurações da função. Por exemplo, se configurar um gatilho em um alias, esse gatilho poderá invocar a versão da função para a qual o alias aponta.

Antes de começar

Criar um alias

  1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Functions.

  2. Na barra de navegação superior, selecione uma região. Na página Functions, clique em na função desejada.

  3. Na página de detalhes da função, clique em na aba Manage Aliases. Na página exibida, clique em Create Alias.

  4. No painel Create Alias, configure os parâmetros e clique em OK.

    A tabela a seguir descreve os parâmetros.

    Item de configuração

    Descrição

    Name

    Nome do alias a ser criado.

    Description

    Descrição do alias.

    Major Version

    Defina a versão principal para o alias.

    Enable Canary Release

    Especifica se uma versão de canary release deve ser ativada. Para ativar, configure os itens a seguir.

    Canary Release Version

    Defina a versão de canary release para o alias.

    Canary Release Version Weight

    Percentual de tráfego a ser direcionado para a versão de canary release. Por exemplo, se definir este parâmetro como 5%, 5% do tráfego será alocado para a versão canary e 95% para a versão principal.

    Na página Manage Aliases, visualize o alias criado. Edite aliases existentes ou exclua aqueles que não são mais necessários.

Nota

Ao excluir um alias, apenas o alias é removido. As versões e gatilhos aos quais o alias aponta não são excluídos.

Mais informações