Partilhar via

Definir configurações de atualização de serviço para suas instâncias de Gerenciamento de API

APLICA-SE A: BÁSICO | Padrão | Prémio

Este artigo mostra como definir as configurações de atualização de serviço (visualização) em sua instância de Gerenciamento de API. O Azure aplica periodicamente atualizações de serviço automaticamente às instâncias de Gerenciamento de API, usando uma abordagem de distribuição em fases. Essas atualizações incluem novos recursos, aprimoramentos de segurança e melhorias de confiabilidade.

Você não pode controlar exatamente quando o Azure atualiza cada instância de Gerenciamento de API, mas em camadas de serviço selecionadas você pode escolher um grupo de atualizações (também chamado de canal de versão) para sua instância para que ela receba atualizações mais cedo ou mais tarde do que normalmente receberia durante uma distribuição de atualização. Você também pode configurar uma janela de manutenção durante o dia quando quiser que sua instância receba atualizações.

  • Grupo de atualizações - Um conjunto de instâncias que recebem atualizações do serviço de Gerenciamento de API durante uma distribuição de produção, que pode levar de vários dias a várias semanas para ser concluída.

    Escolha entre:

    • Antecipado - Receba atualizações no início da implantação, para testes e acesso antecipado a novos recursos. Essa opção não é recomendada para implantações de produção.
    • Padrão - Receba atualizações regularmente, como parte da distribuição habitual. Essa opção é recomendada para a maioria dos serviços, incluindo implantações de produção.
    • Atrasado - Receba atualizações mais tarde do que os grupos anteriores, normalmente semanas após a distribuição inicial. Essa opção é recomendada apenas para implantações de missão crítica.
    • AI Gateway Early (canal de lançamento do GenAI) - Obtenha acesso antecipado às funcionalidades e atualizações mais recentes do portal de IA antes que cheguem a outros grupos de atualização. Receba outras atualizações de serviço como parte do grupo Lançamento Posterior.

    Observação

    O Azure implanta todas as atualizações usando uma estrutura de práticas de implantação segura (SDP). As atualizações lançadas no início de uma distribuição podem ser menos estáveis e substituídas mais tarde por versões estáveis. Todas as instâncias acabam por ser atualizadas para as versões mais estáveis.

    Por exemplo, talvez você queira adicionar uma instância de teste ao grupo Atualização antecipada . Essa instância recebe atualizações antes das instâncias de produção, que você coloca no grupo Atualização padrão ou tardia . Você pode monitorar a instância de teste para quaisquer problemas causados pelas atualizações antes que elas cheguem às instâncias de produção. Saiba mais sobre implementações canary com a Gestão de API

  • Janela de manutenção - Um período diário de 8 horas quando você deseja que sua instância receba atualizações. Por padrão, a janela de manutenção é das 22h às 6h no fuso horário da instância.

    As interrupções de serviço são raras durante uma atualização, mas convém reduzir o risco selecionando horários de baixo uso do serviço. Por exemplo, para instâncias de produção, defina uma janela de manutenção durante as noites de dias úteis e manhãs de fim de semana.

Definir configurações de atualização de serviço

  1. Entre no portal do Azure e vá para sua instância de Gerenciamento de API.
  2. No menu à esquerda, selecione Implantação + infraestrutura>Configurações de atualização do serviço.
  3. Em Atualizar grupo, revise a configuração atual e selecione Editar para alterá-la.
  4. Na janela Manutenção, revise as configurações atuais e selecione Editar para alterá-las. Para cada dia, você pode selecionar a janela padrão, uma janela padrão diferente ou uma janela personalizada por dia.

Saiba quando suas instâncias estão recebendo atualizações

Veja como saber sobre atualizações de serviço esperadas ou em andamento.

  • As atualizações do Gerenciamento de API são anunciadas no repositório GitHub de Gerenciamento de API. Inscreva-se para receber notificações deste repositório para saber quando as distribuições de atualizações começam.

  • Monitore as atualizações de serviço que estão ocorrendo em sua instância de Gerenciamento de API usando o log de Atividades do Azure. O evento "Manutenção programada" é emitido quando uma atualização começa.

    Evento de manutenção programada no log de atividades no portal.

    Para receber notificações automaticamente, configure um alerta no registro de atividades.

  • Por padrão, as atualizações são distribuídas para regiões nas seguintes fases: regiões do Azure EUAP, seguidas por regiões Centro-Oeste dos EUA, seguidas por regiões restantes em várias fases posteriores. A sequência de regiões atualizadas nas fases de implantação posteriores difere de serviço para serviço. Pode-se esperar pelo menos 24 horas entre cada fase do lançamento de produção.

  • Dentro de uma região, as instâncias de Gerenciamento de API na camada Premium recebem atualizações várias horas depois daquelas em outras camadas de serviço.

Sugestão

Se sua instância de Gerenciamento de API for implantada em vários locais (regiões), o tempo das atualizações será determinado pelo local Principal da instância.

Estratégias de implantação das Canárias

Você pode usar uma instância de Gerenciamento de API atribuída a um grupo de atualização específico (se essa opção estiver disponível) ou implantada em uma região específica do Azure como uma implantação canária que recebe atualizações antes de suas instâncias de produção.

  • Adicionar instância ao grupo de atualização antecipada - Use uma instância de gerenciamento de API no grupo Atualização antecipada para validar atualizações no início de uma distribuição de produção. Esta instância é efetivamente a sua implementação canária.

  • Implantar na região canária - Se você tiver acesso a uma região do Azure EUAP, use uma instância lá para validar as atualizações assim que elas forem lançadas no pipeline de produção. Saiba mais sobre o processo de solicitação de acesso à região do Azure.

    Observação

    Devido a restrições de capacidade em regiões de EUAP, talvez não seja possível dimensionar instâncias de Gerenciamento de API conforme necessário.

  • Implantar na região piloto - Use uma instância no Centro-Oeste dos EUA para simular seu ambiente de produção ou use-a na produção para tráfego de API não crítico. Embora essa região receba atualizações após as regiões EUAP, é mais provável que uma implantação identifique regressões específicas para sua configuração de serviço.

  • Implantar instâncias duplicadas em uma região - Se sua carga de trabalho de produção for uma instância de camada Premium em uma região específica, considere implantar uma instância configurada de forma semelhante em uma camada inferior que receba atualizações anteriormente. Por exemplo, configure uma instância de pré-produção na camada Desenvolvedor para validar atualizações.

Conteúdo relacionado

  • Saiba como monitorar sua instância de Gerenciamento de API.
  • Saiba mais sobre outras opções para observar sua instância de Gerenciamento de API.