Partager via

Cloner une application Azure App Service à l’aide de PowerShell

Remarque

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour bien démarrer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Cet article explique comment cloner une application App Service existante pour créer une application dans une autre région ou dans la même région. Vous pouvez déployer plusieurs applications dans différentes régions rapidement et facilement.

Le clonage d’application est pris en charge dans les niveaux Standard et supérieurs, et dans les niveaux isolés. La fonctionnalité présente les mêmes limitations que la fonctionnalité Sauvegarde App Service, consultez Sauvegarder une application dans Azure App Service.

Cloner une application existante

Scénario : vous souhaitez cloner le contenu d’une application existante dans la région USA Centre Sud vers une nouvelle application dans la région USA Centre Nord. Vous pouvez utiliser la version Azure Resource Manager de l’applet de commande PowerShell pour créer une application à l’aide de l’option -SourceWebApp .

Lorsque vous connaissez le nom du groupe de ressources qui contient l’application source, vous pouvez utiliser la commande PowerShell suivante pour obtenir les informations de l’application source, dans ce cas nommée source-webapp:

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

Pour créer un plan App Service, vous pouvez utiliser la New-AzAppServicePlan commande indiquée dans l’exemple suivant :

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

À l’aide de la New-AzWebApp commande, vous pouvez créer la nouvelle application dans la région USA Centre Nord et la lier à un plan App Service existant. En outre, vous pouvez utiliser le même groupe de ressources que l’application source ou définir un nouveau groupe de ressources. Consultez la commande suivante :

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

Pour cloner une application existante, y compris tous les emplacements de déploiement associés, vous devez utiliser le IncludeSourceWebAppSlots paramètre. Ce paramètre est pris en charge uniquement pour le clonage d’une application entière, y compris tous ses emplacements. La commande PowerShell suivante illustre l’utilisation de ce paramètre avec la New-AzWebApp commande :

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

Pour cloner une application existante dans la même région, créez un groupe de ressources et un nouveau plan App Service dans la même région. Utilisez ensuite la commande PowerShell suivante pour cloner l’application :

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

Cloner une application existante dans un environnement App Service

Scénario : vous souhaitez cloner le contenu d’une application existante dans la région USA Centre Sud vers une nouvelle application dans un environnement App Service existant.

Lorsque vous connaissez le nom du groupe de ressources qui contient l’application source, vous pouvez utiliser la commande PowerShell suivante pour obtenir les informations de l’application source, dans ce cas nommée source-webapp:

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

Avec le nom de l’environnement App Service et le nom du groupe de ressources auquel appartient l’environnement App Service, vous pouvez créer la nouvelle application dans l’environnement App Service existant. Le processus est illustré dans la commande suivante :

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

Le Location paramètre est requis pour des raisons héritées, mais il est ignoré lorsque vous créez l’application dans un environnement App Service.

Cloner un emplacement d’application existant

Scénario : vous souhaitez cloner un emplacement de déploiement existant d’une application sur une nouvelle application ou un nouvel emplacement. La nouvelle application peut se trouver dans la même région que l’emplacement d’application d’origine ou dans une autre région.

Lorsque vous connaissez le nom du groupe de ressources qui contient l’application source, vous pouvez utiliser la commande PowerShell suivante pour obtenir les informations de l’emplacement de l’application source (dans ce cas nommée source-appslot) liées à source-app:

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

La commande suivante montre comment créer un clone de l’application source sur une nouvelle application :

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

Configurer Traffic Manager lors du clonage d’une application

Lorsque vous créez des applications multirégions et configurez Azure Traffic Manager pour acheminer le trafic vers ces applications, nous vous recommandons d’utiliser des applications clientes hautement disponibles. Lorsque vous clonez une application existante, vous pouvez connecter les deux applications à un nouveau profil Traffic Manager ou à une application existante. Seule la version d’Azure Resource Manager de Traffic Manager est prise en charge.

Créer un profil Traffic Manager lors du clonage d’une application

Scénario : Vous souhaitez cloner une application dans une autre région, tout en configurant un profil Azure Resource Manager Traffic Manager qui inclut les deux applications. La commande suivante montre comment créer un clone de l’application source sur une nouvelle application lors de la configuration d’un nouveau profil Traffic Manager :

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

Ajouter une nouvelle application cloné à un profil Traffic Manager existant

Scénario : Vous disposez déjà d’un profil Azure Resource Manager Traffic Manager et souhaitez ajouter les deux applications en tant que points de terminaison. Tout d’abord, assemblez l’ID de profil Traffic Manager existant. Vous avez besoin de l’ID d’abonnement, du nom du groupe de ressources et du nom de profil Traffic Manager existant.

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

Une fois que vous avez l’ID Traffic Manager, la commande suivante montre comment créer un clone de l’application source dans une nouvelle application tout en les ajoutant à un profil Traffic Manager existant :

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

Remarque

Si vous recevez une erreur indiquant que la validation SSL sur le nom d’hôte traffic Manager échoue, nous vous suggérons d’utiliser l’attribut -IgnoreCustomHostNames dans l’applet de commande PowerShell pendant que vous effectuez l’opération clone. Vous pouvez également utiliser le portail Azure.

Restrictions actuelles

Voici les restrictions connues du clonage d’application :

  • Les paramètres de mise à l’échelle automatique ne sont pas clonés.
  • Les paramètres de planification de sauvegarde ne sont pas clonés.
  • Les paramètres de réseau virtuel ne sont pas clonés.
  • Application Insights n’est pas configuré automatiquement sur l’application de destination.
  • Les paramètres d’authentification simples ne sont pas clonés.
  • Les extensions Kudu ne sont pas clonées.
  • Les règles tiP ne sont pas clonées.
  • Le contenu de la base de données n’est pas cloné.
  • Les adresses IP sortantes changent si vous clonez vers une autre unité d’échelle.
  • Les applications Linux ne sont pas disponibles.
  • Les identités managées ne sont pas clonées.
  • Les applications de fonctions ne sont pas disponibles.

Contenu connexe