Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
APLICA-SE A: Básico | Standard | Premium
Este artigo mostra como definir as configurações de atualização de serviço (versão prévia) em sua instância de Gerenciamento de API. O Azure aplica periodicamente as 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ção para sua instância para que ele receba atualizações anteriores ou posteriores do que normalmente faria 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.
Atualizar grupo
Um grupo de atualizações (também chamado de canal de lançamento) é um conjunto de instâncias que recebem atualizações do serviço de Gerenciamento de API durante uma distribuição de produção, o que pode levar de vários dias a várias semanas para ser concluído.
| Atualizar grupo | Description |
|---|---|
| Gateway Inicial de IA (canal de lançamento GenAI) | Obtém acesso antecipado às funcionalidades e atualizações mais recentes do gateway de IA antes que elas cheguem a outros grupos de atualizações. Combina as atualizações de serviço principal mais estáveis com os recursos mais recentes específicos para IA. Recebe outras atualizações de serviço como parte do grupo de atualizações tardias , permitindo a implantação mais rápida de recursos relacionados à IA. |
| Antecipado | Recebe atualizações no início da distribuição, para teste e acesso antecipado a novos recursos. Essa opção não é recomendada para implantações de produção. |
| Default | Recebe atualizações como parte do ciclo de lançamento regular. Essa opção é recomendada para a maioria dos serviços, incluindo implantações de produção. |
| Atrasado | Recebe atualizações posteriores aos grupos anteriores, normalmente semanas após a distribuição inicial. Essa opção é recomendada apenas para implantações críticas. |
Observação
- O Azure implanta todas as atualizações usando uma estrutura SDP (práticas de implantação seguras). As atualizações lançadas no início de uma distribuição podem ser menos estáveis e substituídas posteriormente por versões estáveis. Todas as instâncias são eventualmente atualizadas para os builds de versão mais estáveis.
- Todos os grupos de atualizações podem incluir recursos na versão prévia. Os recursos em prévia são claramente especificados no portal e na documentação do Azure.
- Os recursos se propagam por meio de grupos de atualização nesta sequência: Gateway Inicial de IA (somente recursos de IA) → Antecipado → Padrão → Final.
Por exemplo, talvez você queira adicionar uma instância de teste ao grupo de atualização antecipada . Essa instância recebe atualizações antes das instâncias de produção, que você coloca no grupo de 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 implantações canárias com o Gerenciamento de API
Janela de manutenção
Uma 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.
Interrupções de serviço são raras durante uma atualização, mas talvez você queira reduzir o risco selecionando tempos de baixo uso do serviço. Por exemplo, para instâncias de produção, defina uma janela de manutenção durante as noites e as manhãs de fim de semana.
Definir configurações de atualização de serviço
- Entre no portal do Azure e vá para sua instância de Gerenciamento de API.
- No menu à esquerda, selecione Implantação + infraestrutura>Configurações de atualização do serviço.
- Em Atualizar grupo, examine a configuração atual e selecione Editar para alterá-la.
- Na janela Manutenção, examine 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.
Saber quando suas instâncias recebem atualizações
Veja como você pode aprender sobre as atualizações de serviço que são esperadas ou estão em andamento.
As atualizações do API Management são anunciadas no repositório do GitHub do API Management. Assine para receber notificações desse repositório para saber quando as distribuições de atualização começam.
Use o log de Atividades do Azure para monitorar as atualizações de serviço que ocorrem em sua instância de Gerenciamento de API. O evento "Manutenção agendada" é emitido quando uma atualização é iniciada.
Para receber notificações automaticamente, configure um alerta no Log de atividades.
Por padrão, as atualizações são distribuídas para regiões nas seguintes fases: regiões do Azure EUAP, seguidas pelo Centro-Oeste dos EUA, seguidas pelas regiões restantes em várias fases posteriores. A sequência de regiões atualizada nas fases de implantação posteriores é diferente de serviço para serviço. Você pode esperar pelo menos 24 horas entre cada fase da distribuição de produção.
Em uma região, as instâncias do API Management na camada Premium recebem atualizações várias horas depois daquelas que estão em outras camadas de serviço.
Dica
Se sua instância do API Management estiver implantada em vários locais (regiões), o momento das atualizações será determinado pelo local Primário da instância.
Estratégias de implantação canário
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 anteriores às instâncias de produção.
Adicionar instância ao grupo de atualização antecipada – use uma instância de Gerenciamento de API no grupo de atualização antecipada para validar as atualizações no início de uma distribuição de produção. Essa instância é efetivamente sua implantação canário.
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 liberadas para o 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 EUAP, talvez você não possa dimensionar as instâncias de API Management 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 usá-la em produção para tráfego de API não crítica. Embora essa região receba atualizações após as regiões EUAP, uma implantação ali é mais provável de identificar regressões específicas à configuração do seu 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 similar em uma camada inferior que receba atualizações antecipadas. 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 do API Management.
- Saiba mais sobre outras opções para monitorar sua instância do API Management.