Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 Gestão de APIs, utilizando uma abordagem de implementação faseada. Essas atualizações incluem novos recursos, aprimoramentos de segurança e melhorias de confiabilidade.
Não podes controlar exatamente quando o Azure atualiza cada instância de Gestão de API, mas em certos níveis de serviço podes escolher um grupo de atualizações para a tua instância para que esta receba atualizações mais cedo ou mais tarde do que normalmente faria durante uma implementaçã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ção (também chamado de canal de lançamento) é um conjunto de instâncias que recebem atualizações do serviço de Gestão de APIs durante uma implementação de produção, a qual pode demorar de vários dias a várias semanas para ser concluída.
| Atualizar grupo | Description |
|---|---|
| AI Gateway Early (canal de lançamento GenAI) | Obtém acesso antecipado às funcionalidades e atualizações mais recentes do gateway de IA antes de chegarem a outros grupos de atualizações. Combina as atualizações de serviço principal mais estáveis com as mais recentes funcionalidades específicas de IA. Recebe outras atualizações de serviço como parte do grupo de atualizações tardias , permitindo uma implementação mais rápida de capacidades relacionadas com IA. |
| Cedo | Recebe atualizações no início do lançamento, para testes e acesso antecipado a novas funcionalidades. Esta opção não é recomendada para implementações em produção. |
| Predefinição | Recebe atualizações como parte da distribuição regular. Essa opção é recomendada para a maioria dos serviços, incluindo implantações de produção. |
| Atrasada | Recebe atualizações mais tarde do que os grupos anteriores, normalmente semanas após o lançamento inicial. Essa opção é recomendada apenas para implantações de missão crítica. |
Observação
- O Azure implementa todas as atualizações utilizando um framework de práticas de implementaçã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.
- Todos os grupos de atualizações podem incluir funcionalidades na pré-visualização. As funcionalidades de pré-visualização estão claramente indicadas no portal Azure e na documentação.
- As funcionalidades propagam-se através dos grupos de atualização nesta sequência: AI Gateway Early (apenas funcionalidades de IA) → Early → Default → Late.
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
Uma janela de manutenção é um período diário de 8 horas em que quer que a 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
- 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, revise a configuração atual e selecione Editar para alterá-la.
- Na janela Manutenção, revise as configurações atuais e selecione Editar para alterá-las. Para cada dia, pode selecionar a janela predefinida, uma janela padrão diferente ou uma janela personalizada por dia.
Saiba quando as suas instâncias recebem atualizações
Veja como pode aprender sobre as atualizações de serviço que são esperadas ou estão em progresso.
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.
Use o registo de atividades do Azure para monitorizar as atualizações de serviço que ocorrem na sua instância de Gestão de APIs. O evento "Manutenção programada" é emitido quando uma atualização começa.
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.