Todos os produtos
Search
Central de documentação

Function Compute:Gerencie aliases

Última atualização: Sep 17, 2026

No Function Compute, você pode criar aliases para versões de funções. A combinação de aliases e versões permite implementar integração contínua e lançamentos 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 ponteiro para uma versão específica da função. Aliases facilitam a publicação de versões, rollbacks e canary releases. Todo alias deve associar-se a uma função ou versão. Ao usar um alias para acessar uma função, 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, você precisa atualizar manualmente o número da versão associada ao gatilho sempre que publicar uma nova versão. Esse processo pode interromper os serviços do cliente. O uso de um alias permite atualizações de versão transparentes. Por exemplo, defina um alias chamado PROD para apontar para a versão estável 1. Os clientes invocam a versão 1 da função usando o alias PROD (Figura 1). Ao publicar a versão 2, basta atualizar o alias PROD para apontar para ela. Dessa forma, os clientes passam a invocar a versão 2 da função utilizando o mesmo alias PROD (Figura 2).

Atualização transparente 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 usam o alias para invocar a função, basta atualizar o alias PROD para apontar para a versão 2 quando estiver pronto para publicá-la. Quando um cliente invoca a função pelo 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

Você também pode usar 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 canário. 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, você troca 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.

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

support

unsupport

Runtime

support

unsupport

Instance specifications, instance concurrency, instance lifecycle hook

support

unsupport

Auto scaling policy

unsupport

support

Trigger

support

support

Asynchronous task

support

support

Layer, environment variable, logging, network, storage, health check, custom DNS, permissões (função)

support

unsupport

Antes de começar

Crie 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 deve ativar uma versão de canary release. Para ativar, defina os seguintes itens de configuração.

    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 de canary release e 95% para a versão principal.

    Na página Manage Aliases, visualize o alias criado. Você também pode editar aliases existentes ou excluir aliases desnecessários.

Nota

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

Mais informações