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 atualizará 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 aplicará 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 enviar a você uma notificação quando houver uma atualização disponível. A disponibilidade também ficará 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, após esse período a atualização será processada com as atualizações automáticas restantes da regiã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 adicionará 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 orientará 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 serão disparados com base no alerta.
Enviar notificações de teste
Ao criar sua lógica de automação e notificação, talvez seja prudente testá-la antes que a atualização real esteja disponível, pois essa atualização pode estar a mais de um mês do término. O portal do Azure tem a capacidade de enviar uma notificação de atualização de teste especial disponível, que você pode usar para verificar sua lógica de automação. A mensagem será semelhante à notificação real, mas o título terá o prefixo "[Teste]" e a descrição será diferente. Você pode enviar notificações de teste depois de configurar 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 será exibida. Selecione Iniciar atualização para iniciar o processo de atualização. Você receberá notificações durante a atualização houver 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"