Todos os produtos
Search
Central de documentação

Platform For AI:Manage releases, canary deployments, and version rollbacks

Última atualização: Aug 26, 2026

O EAS oferece estratégias de release, deslocamento de tráfego canário e gerenciamento de versões para implantar alterações de service com segurança, validar novas versões em tráfego de produção e reverter rapidamente quando surgem problemas.

Visão geral

O gerenciamento de releases abrange o processo de implantação de alterações de service — novas imagens, parâmetros, modelos, entre outros — em produção. Esse recurso inclui três capacidades:

  • Publicar alterações em produção: Controle o ritmo das atualizações com estratégias de release (contínua, em lotes ou pausada) para evitar interrupções nas requisições. Por padrão, as atualizações contínuas substituem gradualmente as réplicas, enquanto o encerramento graceful drena as requisições em andamento. Para services com dezenas ou centenas de réplicas que exigem implantações faseadas com pontos de verificação, utilize planos de atualização para obter um controle mais refinado.

  • Validar em tráfego de produção: Atribua services de produção e canário ao mesmo grupo de services, divida o tráfego real entre eles por proporção e transfira gradualmente todo o tráfego para o canário após confirmar sua integridade.

  • Visualizar histórico e reverter: Cada atualização cria um snapshot de versão. Visualize o histórico de implantação, compare versões e reverta para qualquer versão anterior caso ocorram problemas.

Publicar alterações em produção

Escolha uma estratégia de release conforme o nível de risco da alteração:

  • Atualização contínua (padrão): Mecanismo base de todas as atualizações. O sistema cria gradualmente novas réplicas e substitui as antigas com base em max_surge (réplicas permitidas acima da contagem desejada) e max_unavailable (máximo de réplicas indisponíveis). As réplicas antigas são encerradas de forma graceful após a drenagem das requisições em andamento. Este é o comportamento padrão para reinicializações de service e atualizações de parâmetros. Para obter detalhes, consulte Rolling updates and graceful shutdown.

  • Plano de atualização: Adiciona recursos de divisão em lotes e pausa às atualizações contínuas. Utilize planos de atualização quando o service possuir dezenas ou centenas de réplicas e for necessário avançar em etapas, verificando métricas de negócio entre os lotes. Há suporte aos modos de loteamento manual e automático, permitindo pausar, ajustar ou reverter a qualquer momento. Para obter detalhes, consulte Update plan.

Nota

Utilize a estratégia contínua padrão para atualizações de rotina. Em implantações de grande escala, alto risco ou faseadas, adicione um plano de atualização.

Validar em tráfego de produção

As releases canário funcionam por meio de grupos de services: um service de produção e um service canário compartilham um único endpoint de acesso que distribui o tráfego por contagem de réplicas ou peso personalizado. Direcione inicialmente uma pequena parcela do tráfego para o canário, verifique sua integridade e aumente gradualmente a proporção até que ele processe todo o tráfego. Para obter detalhes, consulte Service groups.

Visualizar histórico e reverter

Na lista de services de inferência, localize o service desejado e clique em na versão atual na coluna Version para abrir a lista de versões. A lista de versões oferece os seguintes recursos:

  • Visualizar configuração de implantação: Consulte os parâmetros de implantação de uma versão, incluindo imagem, especificações de recursos, variáveis de ambiente e comando de inicialização.

  • Identificar o criador: Saiba quem fez cada alteração para fins de auditoria.

  • Comparar versões: Selecione duas versões e compare suas configurações de implantação para identificar exatamente o que mudou. Isso ajuda a avaliar o impacto antes de uma reversão ou a solucionar problemas após uma atualização.

  • Reverter para esta versão: Restaure o service para a configuração de implantação de uma versão selecionada. O botão fica desabilitado para a versão atual.

Dois pontos importantes sobre reversões:

  • Compatibilidade entre versões: Uma reversão exige que a imagem, os arquivos de modelo, as variáveis de ambiente e outros recursos da versão de destino ainda estejam disponíveis. Se a imagem tiver sido excluída ou se dependências externas tiverem mudado, a reversão poderá falhar ou causar problemas no service.

  • Escolha entre dois métodos de reversão:

    • Se a atualização foi totalmente concluída e você precisa retornar a uma versão mais antiga, use a reversão pela lista de versões. Ela segue a estratégia de atualização contínua e não é afetada por planos de atualização.

    • Se a atualização ainda estiver em andamento (algumas réplicas foram atualizadas, mas não todas) e o service tiver um plano de atualização ativado, prefira a reversão pelo plano de atualização (loteamento manual com contagem de réplicas de destino definida como 0). As réplicas já atualizadas revertem gradualmente, o que torna o processo mais rápido.