Clonagem de aplicativo do Serviço de Aplicativo do Azure usando o PowerShell

Artigo
06/03/2024

Nota

Recomendamos que utilize o módulo Azure Az do PowerShell para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.

Com o lançamento do Microsoft Azure PowerShell versão 1.1.0, foi adicionada uma nova opção que New-AzWebApp permite clonar um aplicativo do Serviço de Aplicativo existente para um aplicativo recém-criado em uma região diferente ou na mesma região. Essa opção permite que os clientes implantem vários aplicativos em diferentes regiões de forma rápida e fácil.

A clonagem de aplicações é suportada nos planos do Serviço de Aplicações Standard, Premium, Premium V2 e Isolado. O novo recurso usa as mesmas limitações do recurso Backup do Serviço de Aplicativo, consulte Fazer backup de um aplicativo no Serviço de Aplicativo do Azure.

Clonando um aplicativo existente

Cenário: Um aplicativo existente na região Centro-Sul dos EUA e você deseja clonar o conteúdo para um novo aplicativo na região Centro-Norte dos EUA. Isso pode ser feito usando a versão do Azure Resource Manager do cmdlet do PowerShell para criar um novo aplicativo com a -SourceWebApp opção.

Sabendo o nome do grupo de recursos que contém o aplicativo de origem, você pode usar o seguinte comando do PowerShell para obter as informações do aplicativo de origem (neste caso, chamado source-webapp):

$srcapp = Get-AzWebApp -ResourceGroupName SourceAzureResourceGroup -Name source-webapp

Para criar um novo Plano do Serviço de Aplicativo, você pode usar New-AzAppServicePlan o comando como no exemplo a seguir

New-AzAppServicePlan -Location "North Central US" -ResourceGroupName DestinationAzureResourceGroup -Name DestinationAppServicePlan -Tier Standard

Usando o New-AzWebApp comando, você pode criar o novo aplicativo na região Centro-Norte dos EUA e vinculá-lo a um Plano de Serviço de Aplicativo existente. Além disso, você pode usar o mesmo grupo de recursos que o aplicativo de origem ou definir um novo grupo de recursos, conforme mostrado no comando a seguir:

$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-webapp -Location "North Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcapp

Para clonar um aplicativo existente, incluindo todos os slots de implantação associados, você precisa usar o IncludeSourceWebAppSlots parâmetro. Observe que o IncludeSourceWebAppSlots parâmetro só é suportado para clonar um aplicativo inteiro, incluindo todos os seus slots. O comando PowerShell a seguir demonstra o uso desse parâmetro com o New-AzWebApp comando:

$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-webapp -Location "North Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcapp -IncludeSourceWebAppSlots

Para clonar um aplicativo existente na mesma região, você precisa criar um novo grupo de recursos e um novo plano de serviço de aplicativo na mesma região e, em seguida, usar o seguinte comando do PowerShell para clonar o aplicativo:

$destapp = New-AzWebApp -ResourceGroupName NewAzureResourceGroup -Name dest-webapp -Location "South Central US" -AppServicePlan NewAppServicePlan -SourceWebApp $srcapp

Clonando um aplicativo existente em um ambiente do Serviço de Aplicativo

Cenário: um aplicativo existente na região Centro-Sul dos EUA e você deseja clonar o conteúdo para um novo aplicativo para um ambiente de serviço de aplicativo (ASE) existente.

$srcapp = Get-AzWebApp -ResourceGroupName SourceAzureResourceGroup -Name source-webapp

Sabendo o nome do ASE e o nome do grupo de recursos ao qual o ASE pertence, você pode criar o novo aplicativo no ASE existente, conforme mostrado no comando a seguir:

$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-webapp -Location "North Central US" -AppServicePlan DestinationAppServicePlan -ASEName DestinationASE -ASEResourceGroupName DestinationASEResourceGroupName -SourceWebApp $srcapp

O Location parâmetro é necessário devido ao motivo herdado, mas é ignorado quando você cria o aplicativo em um ASE.

Clonando um slot de aplicativo existente

Cenário: você deseja clonar um slot de implantação existente de um aplicativo para um novo aplicativo ou um novo slot. O novo aplicativo pode estar na mesma região do slot de aplicativo original ou em uma região diferente.

Sabendo o nome do grupo de recursos que contém o aplicativo de origem, você pode usar o seguinte comando do PowerShell para obter as informações do slot do aplicativo de origem (neste caso, chamado source-appslot) vinculadas a source-app:

$srcappslot = Get-AzWebAppSlot -ResourceGroupName SourceAzureResourceGroup -Name source-app -Slot source-appslot

O comando a seguir demonstra a criação de um clone do aplicativo de origem para um novo aplicativo:

$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-app -Location "North Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcappslot

Configurando o Gerenciador de Tráfego ao clonar um aplicativo

Criar aplicativos de várias regiões e configurar o Gerenciador de Tráfego do Azure para rotear o tráfego para todos esses aplicativos é um cenário importante para garantir que os aplicativos dos clientes estejam altamente disponíveis. Ao clonar um aplicativo existente, você tem a opção de conectar ambos os aplicativos a um novo perfil de gerenciador de tráfego ou a um perfil existente. Apenas a versão do Azure Resource Manager do Traffic Manager é suportada.

Criando um novo perfil do Gerenciador de Tráfego ao clonar um aplicativo

Cenário: você deseja clonar um aplicativo para outra região, enquanto configura um perfil de gerenciador de tráfego do Azure Resource Manager que inclui ambos os aplicativos. O comando a seguir demonstra a criação de um clone do aplicativo de origem para um novo aplicativo ao configurar um novo perfil do Gerenciador de Tráfego:

$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-webapp -Location "South Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcapp -TrafficManagerProfileName newTrafficManagerProfile

Adicionar novo aplicativo clonado a um perfil existente do Gerenciador de Tráfego

Cenário: você já tem um perfil de gerenciador de tráfego do Azure Resource Manager e deseja adicionar ambos os aplicativos como pontos de extremidade. Para fazer isso, primeiro você precisa montar o ID de perfil do gerenciador de tráfego existente. Você precisa da ID da assinatura, do nome do grupo de recursos e do nome do perfil do gerenciador de tráfego existente.

$TMProfileID = "/subscriptions/<Your subscription ID goes here>/resourceGroups/<Your resource group name goes here>/providers/Microsoft.TrafficManagerProfiles/ExistingTrafficManagerProfileName"

Depois de ter o ID da manjedoura de tráfego, o comando a seguir demonstra a criação de um clone do aplicativo de origem para um novo aplicativo enquanto os adiciona a um perfil existente do Gerenciador de Tráfego:

$destapp = New-AzWebApp -ResourceGroupName <Resource group name> -Name dest-webapp -Location "South Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcapp -TrafficManagerProfileId $TMProfileID

Nota

Se você estiver recebendo um erro informando "A validação SSL no nome do host do gerenciador de tráfego está falhando", sugerimos que você use o atributo -IgnoreCustomHostNames no cmdlet powershell ao executar a operação de clone ou use o portal.

Restrições atuais

Veja a seguir as restrições conhecidas da clonagem de aplicações:

As definições de dimensionamento automático não são clonadas
As definições de agendamento de cópias definição não são clonadas
As definições da VNET não são clonadas
As Informações da Aplicação não são automaticamente configuradas na aplicação de destino
As configurações Easy Auth não são clonadas
A Extensão do Kudu não é clonada
As regras do TiP não são clonadas
O conteúdo da base de dados não é clonado
Os Endereços IP de Saída são alterados quando a clonagem é realizada para uma unidade de escala diferente
Não disponível para Aplicações Linux
As identidades geridas não são clonadas
Não disponível para as Aplicações de Funções

Partilhar via