Preferência de atualização da manutenção planejada do Ambiente do Serviço de Aplicativo
O Serviço de Aplicativo do Azure é atualizado regularmente para fornecer novos recursos, novas versões de runtime, aprimoramentos de desempenho e correções de bugs. Isso também é conhecido como manutenção planejada. A atualização acontece automaticamente. As atualizações são aplicadas progressivamente por meio das regiões que seguem as Práticas de Implantação Segura do Azure. Um Ambiente do Serviço de Aplicativo é um recurso do Serviço de Aplicativo do Azure que fornece um ambiente totalmente isolado e dedicado a executar os aplicativos do Serviço de Aplicativo com segurança em grande escala. Devido à natureza isolada do Ambiente do Serviço de Aplicativo, você tem a oportunidade de influenciar o processo de atualização.
Se você não tiver um Ambiente do Serviço de Aplicativo, consulte Como criar um Ambiente do Serviço de Aplicativo v3.
Observação
Este artigo aborda os recursos, benefícios e casos de uso do Ambiente do Serviço de Aplicativo v3, que é usado com os planos do Serviço do Aplicativo Isolado v2.
Com o Ambiente do Serviço de Aplicativo v3, você pode especificar suas preferências de quando e como aplicar a manutenção planejada. A atualização pode ser aplicada automaticamente ou manualmente. Mesmo se definir suas preferências como automáticas, você terá algumas opções para influenciar o tempo.
Preferência de atualização automática
Quando você usa a preferência de atualização automática, a plataforma atualiza sua instância do Ambiente do Serviço de Aplicativo tão logo a atualização seja disponibilizada na região em que a instância está implantada. É possível escolher entre as seguintes opções:
- Nenhum é a opção padrão. Essa opção aplica automaticamente a atualização durante o processo de atualização da região em questão.
- Early aplica a atualização automaticamente, mas prioriza a instância como uma das primeiras da região a ser atualizada.
- Late aplica a atualização automaticamente, mas deixa a instância como uma das últimas da região a ser atualizada.
Em regiões menores, as preferências de atualização Early e Late podem ter resultados bastante semelhantes na prática.
Preferência de atualização manual
A preferência de atualização manual oferece a opção de receber uma notificação quando houver uma atualização disponível. A disponibilidade também fica visível no portal do Azure. Depois que a atualização estiver disponível, você terá 15 dias para iniciar o processo de atualização. Se você não iniciar a atualização dentro de 15 dias, a atualização será processada com as atualizações automáticas restantes da região.
Importante
Em casos raros, você pode ver que uma atualização está disponível na página Configuração do Ambiente do Serviço de Aplicativo, mas não recebe uma notificação de Integridade do Serviço (se você configurar notificações). Se você não receber uma notificação de Integridade do Serviço, essa atualização disponível não será necessária e o limite de tempo de 15 dias não se aplicará. Esse é um bug conhecido que estamos trabalhando para corrigir.
Normalmente, as atualizações não afetam a disponibilidade dos seus aplicativos. A atualização adiciona instâncias extras para garantir que a mesma capacidade esteja disponível durante a atualização. As instâncias corrigidas e reiniciadas são readicionadas na rotação e, quando você tiver cargas de trabalho sensíveis às reinicializações, deverá planejar iniciar a manutenção durante o horário não comercial. Normalmente, o processo de atualização completo é concluído dentro de 18 horas, mas pode levar mais tempo. Depois que a atualização tiver sido iniciada, a atualização será executada até que ela seja concluída e não seja pausada durante o horário comercial padrão.
Observação
Em casos raros, a disponibilidade de atualização pode ser afetada por um hotfix de segurança que substitui a atualização planejada ou uma regressão encontrada na atualização planejada antes de ser aplicada à sua instância. Nesses casos raros, a atualização disponível será removida e passará para a atualização automática.
Configurar notificações
Quando uma atualização estiver disponível, o Azure adiciona um evento de manutenção planejada no painel Integridade do Serviço do Azure Monitor. Para ver notificações anteriores no portal do Azure, navegue até Página Inicial > Monitor > Integridade do Serviço > Manutenção planejada. Para facilitar a localização dos eventos relevantes, selecione a caixa Serviço e marque apenas o tipo Serviço de Aplicativo. Você também pode filtrar por assinatura e região.
Você pode configurar alertas para enviar uma mensagem ao seu endereço de email e/ou número de telefone de SMS quando um evento é gerado no Azure Monitor. Você também pode configurar um gatilho para sua Função do Azure ou para seu Aplicativo Lógico do Azure personalizado, a fim de executar ações automaticamente sobre seus recursos. Essas ações podem servir para desviar automaticamente o tráfego do seu Ambiente do Serviço de Aplicativo em uma região que será atualizada para um Ambiente do Serviço de Aplicativo em outra região. Em seguida, você pode alterar automaticamente o tráfego de volta ao normal quando a atualização for concluída.
Para configurar alertas de notificações de atualização, selecione Adicionar alerta de integridade de serviço, na parte superior do painel. Saiba mais sobre os Alertas do Azure Monitor. Este artigo de instruções orienta você na configuração de alertas para eventos de integridade de serviço. Por fim, você pode seguir este guia de instruções para saber como criar grupos de ações que são disparados com base no alerta.
Enviar notificações de teste
Depois de criar sua lógica de automação e notificação, você deve testá-la antes que a atualização real esteja disponível, pois essa atualização pode estar mais de um mês defasada. O portal do Azure consegue enviar uma notificação especial de atualização de teste disponível, que você pode usar para verificar sua lógica de automação. A mensagem é semelhante à notificação real, mas o título tem o prefixo "[Teste]", e a descrição é diferente. Você pode enviar notificações de teste depois de ter configurado sua preferência de atualização como Manual.
Para enviar uma notificação de teste, navegue até a página Configuração do seu Ambiente do Serviço de Aplicativo e selecione o link Enviar notificação de teste. As notificações de teste são enviadas em lotes a cada 15 minutos.
Use o portal do Azure para configurar sua preferência de atualização
- No portal do Azure, navegue até a página Configuração do seu Ambiente do Serviço de Aplicativo.
- Selecione uma preferência de atualização.
- Selecione "Salvar" no início da página.
Usar a CLI do Azure para configurar a preferência de atualização
A experiência recomendada para a atualização é usar o portal do Azure. Se você decidir usar a CLI do Azure para configurar e realizar a atualização, siga as etapas descritas aqui em ordem. Você pode executar os comandos localmente depois de instalar a CLI do Azure ou de usar o Azure Cloud Shell.
Substitua os espaço reservados do nome e do grupo de recursos pelos valores do Ambiente do Serviço de Aplicativo que você deseja configurar. Para ver a preferência de atualização atual:
ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-Resource-Group>
az resource show --name $ASE_NAME -g $ASE_RG --resource-type "Microsoft.Web/hostingEnvironments" --query properties.upgradePreference
Para alterar a preferência de atualização para Manual:
ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-Resource-Group>
az resource update --name $ASE_NAME -g $ASE_RG --resource-type "Microsoft.Web/hostingEnvironments" --set properties.upgradePreference=Manual
Usar o portal do Azure para atualizar o Ambiente do Serviço de Aplicativo
Quando há uma atualização disponível, uma faixa é mostrada no portal do Azure. Siga estas etapas para iniciar a atualização:
- No portal do Azure, navegue até a página Configuração do seu Ambiente do Serviço de Aplicativo.
- Selecione o botão Atualizar agora.
- Uma faixa de confirmação é exibida. Selecione Iniciar atualização para iniciar o processo de atualização. As notificações serão enviadas durante a atualização caso você as tenha configurado. Para obter mais informações, confira Configurar notificações.
Usar a CLI do Azure para atualizar o Ambiente do Serviço de Aplicativo
Execute estes comandos para obter sua ID do Ambiente do Serviço de Aplicativo e armazená-la como uma variável de ambiente. Substitua os espaço reservados para nome e grupo de recursos pelos valores do Ambiente do Serviço de Aplicativo que você deseja migrar.
ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-Resource-Group>
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)
Execute este comando para enviar uma notificação de atualização de teste:
az rest --method POST --uri "${ASE_ID}/testUpgradeAvailableNotification?api-version=2022-03-01"
Execute este comando para iniciar o processo de atualização:
az rest --method POST --uri "${ASE_ID}/upgrade?api-version=2022-03-01"