Divisão de tráfego

O Cloud Functions (2a geração) é compatível com várias revisões de cada função, o que permite dividir o tráfego entre revisões diferentes ou reverter a função para uma revisão anterior.

Cada vez que você implanta ou reimplanta uma função, uma nova revisão do serviço subjacente do Cloud Run é criada automaticamente. As revisões são imutáveis e não podem ser modificadas depois que são criadas. Para fazer alterações em uma função, é necessário reimplantá-la.

Por padrão, o tráfego para uma função é encaminhado para a revisão mais recente. É possível alterar esse comportamento definindo uma configuração de tráfego personalizada, conforme mostrado na próxima seção.

Definir uma configuração de tráfego

É possível gerenciar como o tráfego é encaminhado entre as revisões de função usando o serviço subjacente do Cloud Run da função.

gcloud

Para gerenciar o tráfego usando a CLI gcloud:

  1. Implante a função mais de uma vez para criar várias revisões. Use o Cloud Functions (2a geração).

  2. Encontre os IDs de revisão do serviço do Cloud Run em que está a função:

    gcloud run revisions list --service YOUR_FUNCTION_NAME \
    --region YOUR_FUNCTION_REGION \
    --format 'value(REVISION)'
    

    A saída será semelhante a esta:

    YOUR_FUNCTION_NAME-00002-xyz
    YOUR_FUNCTION_NAME-00001-abc
    
  3. Use o comando gcloud run services update-traffic com seus IDs de revisão para alterar a configuração de tráfego. Por exemplo, o comando a seguir divide o tráfego 50/50 entre duas revisões:

    gcloud run services update-traffic YOUR_FUNCTION_NAME \
    --region YOUR_FUNCTION_REGION \
    --to-revisions YOUR_FUNCTION_NAME-00001-abc=50,YOUR_FUNCTION_NAME-00002-xyz=50
    

Console

Para gerenciar o tráfego usando o console do Google Cloud, faça o seguinte:

  1. Implante a função mais de uma vez para criar várias revisões. Use o Cloud Functions (2a geração).
  2. Acesse a página de visão geral do Cloud Functions no console do Google Cloud.
  3. Clique no nome da função para acessar a página Detalhes da função.
  4. No painel Com tecnologia do Cloud Run, clique no nome da sua função para acessar a página Detalhes do serviço do serviço do Cloud Run.
  5. Clique na guia Revisões para ver a lista de revisões.
  6. Na guia Revisão, clique em Gerenciar tráfego.
  7. Insira a configuração de tráfego desejada e clique em Salvar.

Consulte Reversões, lançamentos graduais e migração de tráfego na documentação do Cloud Run para mais detalhes sobre como gerenciar o tráfego entre revisões do Cloud Run.