Troca de blocos de implementação

  • 3 minutos

Você pode trocar slots de implantação na página Slots de implantação do seu aplicativo e na página Visão geral. Antes de trocar um aplicativo de um slot de implantação para a produção, verifique se a produção é o slot de destino e se todas as configurações no slot de origem estão configuradas exatamente como você deseja que elas estejam em produção.

Trocando slots de implantação manualmente

Para trocar slots de implantação:

  1. Vá para a página Slots de implantação do seu aplicativo e selecione Trocar. A caixa de diálogo Trocar mostra as configurações nos slots de origem e destino selecionados que serão alterados.

  2. Selecione os slots de origem e destino desejados. Normalmente, o alvo é o slot de produção. Além disso, selecione as guias Alterações de origem e Alterações de destino e verifique se as alterações de configuração são esperadas. Quando terminar, você pode trocar os slots imediatamente selecionando Trocar.

    Para ver como seu slot de destino seria executado com as novas configurações antes que a troca realmente aconteça, não selecione Trocar, mas siga as instruções em Trocar com visualização abaixo.

  3. Quando terminar, feche a caixa de diálogo selecionando Fechar.

Troca com visualização (troca multifásica)

Antes de trocar para a produção como o slot de destino, valide se o aplicativo é executado com as configurações trocadas. O slot de origem também é aquecido antes da conclusão da troca, o que é desejável para aplicativos de missão crítica.

Quando você executa uma troca com visualização, o Serviço de Aplicativo executa a mesma operação de troca, mas pausa após a primeira etapa. Em seguida, você pode verificar o resultado no slot de preparo antes de concluir a troca.

Se você cancelar a troca, o Serviço de Aplicativo reaplicará os elementos de configuração ao slot de origem.

Para trocar com a visualização:

  1. Siga as etapas acima em Trocar slots de implantação, mas selecione Executar troca com visualização. A caixa de diálogo mostra como a configuração no slot de origem muda na fase 1 e como o slot de origem e de destino muda na fase 2.

  2. Quando estiver pronto para iniciar a troca, selecione Iniciar troca.

    Quando a fase 1 terminar, você será notificado na caixa de diálogo. Visualize a troca no slot de origem indo para https://<app_name>-<source-slot-name>.azurewebsites.net.

  3. Quando estiver pronto para concluir a troca pendente, selecione Concluir troca na ação Troca e selecione Concluir troca.

    Para cancelar um swap pendente, selecione Cancelar swap .

  4. Quando terminar, feche a caixa de diálogo selecionando Fechar.

Configurar a troca automática

A troca automática simplifica os cenários dos Serviços de DevOps do Azure em que você deseja implantar seu aplicativo continuamente com zero arranques a frio e zero tempo de inatividade para os clientes do aplicativo. Quando a troca automática é habilitada de um slot para a produção, sempre que você envia as alterações de código para esse slot, o Serviço de Aplicativo troca automaticamente o aplicativo para produção depois que ele é aquecido no slot de origem.

Nota

Atualmente, a troca automática não é suportada em aplicativos Web no Linux e no Web App for Containers.

Para configurar a troca automática:

  1. Vá para a página de recursos do seu aplicativo e selecione o slot de implantação que você deseja configurar para a troca automática. A configuração está na página Configurações > gerais .

  2. Defina a opção Troca automática ativada como Ativado. Em seguida, selecione o slot de destino desejado para o slot de implantação de troca automática e selecione Salvar na barra de comandos.

  3. Execute um envio de código para o slot de origem. A troca automática acontece após um curto período de tempo e a atualização é refletida no URL do slot de destino.

Especificar aquecimento personalizado

Alguns aplicativos podem exigir ações de aquecimento personalizadas antes da troca. O applicationInitialization elemento de configuração em web.config permite especificar ações de inicialização personalizadas. A operação de troca aguarda o término desse aquecimento personalizado antes de trocar com o slot de destino. Aqui está um exemplo de fragmento web.config.

<system.webServer>
    <applicationInitialization>
        <add initializationPage="/" hostName="[app hostname]" />
        <add initializationPage="/Home/About" hostName="[app hostname]" />
    </applicationInitialization>
</system.webServer>

Para obter mais informações sobre como personalizar o applicationInitialization elemento, consulte Falhas de troca de slot de implantação mais comuns e como corrigi-las.

Você também pode personalizar o comportamento de aquecimento com uma ou ambas as seguintes configurações do aplicativo:

  • WEBSITE_SWAP_WARMUP_PING_PATH: O caminho para o ping para aquecer seu site. Adicione esta configuração de aplicativo especificando um caminho personalizado que começa com uma barra como valor. Um exemplo é /statuscheck. O valor predefinido é /.
  • WEBSITE_SWAP_WARMUP_PING_STATUSES: Códigos de resposta HTTP válidos para a operação de aquecimento. Adicione esta configuração de aplicativo com uma lista separada por vírgulas de códigos HTTP. Um exemplo é 200,202 . Se o código de status retornado não estiver na lista, as operações de aquecimento e troca serão interrompidas. Por padrão, todos os códigos de resposta são válidos.
  • WEBSITE_WARMUP_PATH: Um caminho relativo no site que deve ser pingado sempre que o site for reiniciado (não apenas durante trocas de slots). Exemplos de valores incluem /statuscheck ou o caminho raiz, /.

Reverter e monitorar uma troca

Se ocorrer algum erro no slot de destino (por exemplo, o slot de produção) após uma troca de slot, restaure os slots para seus estados de pré-troca trocando os mesmos dois slots imediatamente.

Se a operação de swap demorar muito tempo para ser concluída, você poderá obter informações sobre a operação de swap no registro de atividades.

Na página de recursos do seu aplicativo no portal, no painel esquerdo, selecione Registro de atividades.

Uma operação de permuta aparece na consulta de log como Swap Web App Slots. Você pode expandi-lo e selecionar uma das suboperações ou erros para ver os detalhes.