Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez utiliser le script PowerShell du réplicateur d’abonnement Azure Stack Hub pour copier des ressources entre des abonnements Azure Stack Hub, entre Azure Stack Hub tampons ou entre Azure Stack Hub et Azure. Le script réplicateur lit et reconstruit les ressources Azure Resource Manager à partir de différents abonnements Azure et Azure Stack Hub. Cet article explique comment fonctionne le script, comment vous pouvez utiliser le script et fournit une référence pour les opérations de script.
Vous trouverez les scripts utilisés dans cet article dans le référentiel GitHub modèles Intelligent Edge Azure. Les scripts se trouvent dans le dossier réplicateur d’abonnement .
Vue d’ensemble du réplica d’abonnement
Le réplica d’abonnement Azure est modulaire. Cet outil utilise un processeur de base qui orchestre la réplication des ressources. En outre, l’outil prend en charge les processeurs personnalisables qui agissent comme des modèles pour copier différents types de ressources.
Le processeur principal se compose des trois scripts suivants :
resource_retriever.ps1
Génère des dossiers pour stocker les fichiers de sortie.
Définit le contexte sur l’abonnement source.
Récupère les ressources et les transmet à resource_processor.ps1.
resource_processor.ps1
Traite la ressource transmise par resource_retriever.ps1.
Détermine le processeur personnalisé à utiliser et transmet les ressources.
post_process.ps1
Publiez la sortie générée par le processeur personnalisé pour la préparer à être déployée dans l’abonnement cible.
Génère du code de déploiement pour déployer les ressources dans l’abonnement cible.
Les trois scripts contrôlent le flux d’informations d’une manière standard pour permettre une plus grande flexibilité. L’ajout de la prise en charge de ressources supplémentaires, par exemple, ne nécessite pas de modification de code dans le processeur principal.
Les processeurs personnalisés, mentionnés précédemment, sont ps1 des fichiers qui déterminent la façon dont un certain type de ressource doit être traité. Le nom d’un processeur personnalisé utilise toujours les données de type dans une ressource. Par exemple, en supposant qu’un $vm objet de machine virtuelle est conservé, en cours d’exécution $vm. Le type génère des résultats Microsoft.Compute/virtualMachines. Cela signifie qu’un processeur pour une machine virtuelle est nommé virtualMachines_processor.ps1. Le nom doit être exactement tel qu’il apparaît dans les métadonnées de ressource, car le processeur principal l’utilise pour déterminer le processeur personnalisé à utiliser.
Un processeur personnalisé détermine la façon dont une ressource doit être répliquée en déterminant les informations importantes et en dictant la façon dont ces informations doivent être extraites des métadonnées de ressource. Le processeur personnalisé prend ensuite toutes les données extraites et l’utilise pour générer un fichier de paramètres qui fonctionne avec un modèle Azure Resource Manager pour déployer la ressource dans l’abonnement cible. Le script post_process.ps1 stocke ce fichier de paramètres dans le dossier Parameter_Files une fois qu’il est post-traité.
Il existe un dossier dans la structure de fichiers replicator nommée Standardized_ARM_Templates. Selon l’environnement source, les déploiements utilisent l’un de ces modèles de Resource Manager standardisés, ou vous devrez peut-être générer un modèle de Resource Manager personnalisé. Dans ce cas, un processeur personnalisé doit appeler un générateur de modèle de modèle Resource Manager. Dans l’exemple démarré précédemment, le nom d’un générateur de modèles Resource Manager pour les machines virtuelles est virtualMachines_ARM_Template_Generator.ps1. Le générateur de modèles Resource Manager est chargé de créer un modèle de Resource Manager personnalisé en fonction des informations contenues dans les métadonnées d’une ressource. Par exemple, si la ressource de machine virtuelle a des métadonnées spécifiant qu’elle est membre d’un groupe à haute disponibilité, le générateur de modèles Resource Manager crée un modèle Resource Manager avec du code spécifiant l’ID du groupe à haute disponibilité dont la machine virtuelle fait partie. De cette façon, lorsque la machine virtuelle est déployée sur le nouvel abonnement, elle est automatiquement ajoutée au groupe à haute disponibilité lors du déploiement. Ces modèles de Resource Manager personnalisés sont stockés dans le dossier Custom_ARM_Templates situé dans le dossier Standardized_ARM_Templates. Le script post_processor.ps1 est chargé de déterminer si un déploiement est censé utiliser un modèle de Resource Manager standardisé ou un modèle personnalisé et générer le code de déploiement correspondant.
Le script post-process.ps1 est chargé de nettoyer les fichiers de paramètres et de créer les scripts utilisés par l’utilisateur pour déployer les nouvelles ressources. Pendant la phase de nettoyage, le script remplace toutes les références à l’ID d’abonnement source, à l’ID de locataire et à l’emplacement par les valeurs cibles correspondantes. Il génère ensuite le fichier de paramètres dans le dossier Parameter_Files . Il détermine ensuite si la ressource en cours de traitement utilise un modèle de Resource Manager personnalisé ou non et génère le code de déploiement correspondant, qui utilise l’applet de commande New-AzResourceGroupDeployment. Le code de déploiement est ensuite ajouté au fichier nommé DeployResources.ps1 stocké dans le dossier Deployment_Files . Enfin, le script détermine le groupe de ressources auquel appartient la ressource et vérifie le script DeployResourceGroups.ps1 pour voir si le code de déploiement pour déployer ce groupe de ressources existe déjà. Si ce n’est pas le cas, le script ajoute du code à ce script pour déployer le groupe de ressources. Si c’est le cas, le script ne fait rien.
Récupération d’API dynamique
L’outil inclut la récupération d’API dynamique, de sorte qu’il utilise la version la plus récente de l’API du fournisseur de ressources disponible dans l’abonnement source pour déployer les ressources dans l’abonnement cible :
Toutefois, l’abonnement cible peut avoir une version antérieure de l’API du fournisseur de ressources qui ne prend pas en charge la version que fournit l’abonnement source. Dans ce cas, une erreur se produit lorsque vous exécutez le déploiement. Pour résoudre cette erreur, mettez à jour les fournisseurs de ressources de l’abonnement cible pour qu’ils correspondent à ceux de l’abonnement source.
Déploiements parallèles
L’outil nécessite un paramètre nommé parallèle. Ce paramètre prend une valeur booléenne qui spécifie s’il faut déployer les ressources récupérées en parallèle. Si vous définissez la valeur sur true, chaque appel à New-AzResourceGroupDeployment inclut l’indicateur -asJob . Le processus ajoute des blocs de code qui attendent que les travaux parallèles se terminent entre les ensembles de déploiements de ressources en fonction des types de ressources. Elle garantit que toutes les ressources d’un type sont déployées avant de déployer le type de ressource suivant. Si vous définissez la valeur du paramètre parallèle sur false, les ressources sont déployées en série.
Ajouter des types de ressources supplémentaires
L’ajout de nouveaux types de ressources est simple. Créez un processeur personnalisé et un modèle Resource Manager ou un générateur de modèles Resource Manager. Une fois ces étapes terminées, ajoutez le type de ressource au validateSet pour le paramètre $resourceType et le tableau $resourceTypes dans resource_retriever.ps1. Lorsque vous ajoutez le type de ressource au tableau $resourceTypes , ajoutez-le dans l’ordre approprié. L’ordre du tableau détermine l’ordre dans lequel les ressources sont déployées. Gardez donc les dépendances à l’esprit. Enfin, si le processeur personnalisé utilise un générateur de modèles Resource Manager, ajoutez le nom du type de ressource au tableau $customTypes dans post_process.ps1.
Exécuter Azure réplica d’abonnement
Pour exécuter l’outil réplica d’abonnement Azure (v3), démarrez resource_retriever.ps1 et fournissez tous les paramètres. Pour le paramètre resourceType , vous pouvez choisir Tout plutôt qu’un type de ressource. Si vous sélectionnez Tout, resource_retriever.ps1 traite toutes les ressources dans un ordre afin que lorsque le déploiement s’exécute, les ressources dépendantes sont déployées en premier. Par exemple, les réseaux virtuels sont déployés avant que les machines virtuelles en tant que machines virtuelles nécessitent qu’un réseau virtuel soit en place pour qu’ils soient déployés correctement.
Une fois le script exécuté, il existe trois nouveaux dossiers : Deployment_Files, Parameter_Files et Custom_ARM_Templates.
Note
Avant d’exécuter l’un des scripts générés, définissez l’environnement approprié et connectez-vous à l’abonnement cible (dans la nouvelle Azure Stack Hub, par exemple). Définissez le répertoire de travail sur le dossier Deployment_Files .
Deployment_Files contient deux fichiers : DeployResourceGroups.ps1 et DeployResources.ps1. Lorsque vous exécutez DeployResourceGroups.ps1, il déploie les groupes de ressources. Lorsque vous exécutez DeployResources.ps1, il déploie toutes les ressources qui ont été traitées. Si vous exécutez l’outil avec Tout ou Microsoft. Calcul/virtualMachines comme type de ressource, DeployResources.ps1 vous invite à entrer un mot de passe d’administrateur de machine virtuelle qu’il utilise pour créer toutes les machines virtuelles.
Exemple
Exécutez le script.
Note
N’oubliez pas de configurer l’environnement source et le contexte d’abonnement pour l’instance PS.
Passez en revue les dossiers nouvellement créés :
Définissez le contexte sur l’abonnement cible, remplacez le dossier par Deployment_Files, déployez les groupes de ressources (exécutez le
DeployResourceGroups.ps1script), puis démarrez le déploiement de ressources (exécutez leDeployResources.ps1script).Exécutez
Get-Jobpour vérifier l’état. Get-Job | Receive-Job retourne les résultats.
Nettoyage
Dans le replicatorV3 dossier, le fichier cleanup_generated_items.ps1 supprime les dossiers Deployment_Files, Parameter_Files et Custom_ARM_Templates ainsi que tout leur contenu.
Opérations de réplica d’abonnement
Le réplica d’abonnement Azure (v3) peut actuellement répliquer les types de ressources suivants :
Microsoft.Compute/availabilitySets
Microsoft.Compute/MachinesVirtuelles
Microsoft.Network/loadBalancers
Microsoft.Network/networkSecurityGroups
Microsoft.Network/publicIPAddresses
Microsoft.Network/routeTables
Microsoft.Network/virtualNetworks
Microsoft.Network/virtualNetworkGateways
Microsoft.Storage/storageAccounts
Lorsque vous exécutez l’outil avec Tous comme type de ressource, il suit l’ordre dans la liste suivante lors de la réplication et du déploiement. Dans la liste suivante, toutes les ressources ont leur configuration répliquée, comme la référence SKU, l’offre et d’autres paramètres :
Microsoft.Network/virtualNetworks
- Réplique : - Tous les espaces d’adressage - Tous les sous-réseaux
Microsoft.Network/virtualNetworkGateways
- Réplique : - Configuration IP publique - Configuration du sous-réseau - Type VPN - Type de passerelle
Microsoft.Network/routeTables
Microsoft.Network/networkSecurityGroups
- Réplique : - Toutes les règles de sécurité entrantes et sortantes
Microsoft.Network/publicIPAddresses
Microsoft.Network/loadBalancers
- Réplique : - Adresses IP privées - Configuration de l’adresse IP publique - Configuration du sous-réseau
Microsoft.Compute/availabilitySets
- Réplique : - Nombre de domaines d’erreur - Nombre de domaines de mise à jour
Microsoft.Storage/storageAccounts
Microsoft.Compute/MachinesVirtuelles
- Réplique :
- Disques de données (sans données)
- Taille de la machine virtuelle
- Système d’exploitation
- Configuration du compte de stockage de diagnostic
- Configuration d’adresses IP publiques
- Interface réseau
- Adresse IP privée de l’interface réseau
- Configuration du groupe de sécurité réseau
- Configuration du groupe à haute disponibilité
- Réplique :
Note
Ce processus crée uniquement des disques managés pour les disques de système d’exploitation et les disques de données. Actuellement, il ne prend pas en charge l’utilisation de comptes de stockage.
Limitations
L’outil peut répliquer des ressources d’un abonnement à un autre tant que l’abonnement cible prend en charge tous les types de ressources et options que vous répliquez à partir de l’abonnement source. Pour garantir la réussite de la réplication, assurez-vous que les versions du fournisseur de ressources de l’abonnement cible correspondent à celles de l’abonnement source.
Pour garantir la réussite de la réplication, assurez-vous que les versions du fournisseur de ressources de l’abonnement cible correspondent à celles de l’abonnement source.
Lorsque vous répliquez des ressources de Azure commerciales vers des Azure commerciales ou d’un abonnement dans Azure Stack Hub à un autre abonnement dans le même Azure Stack Hub, vous rencontrez des problèmes lors de la réplication des comptes de stockage. Ce problème se produit, car les noms de compte de stockage doivent être uniques dans toutes les Azure commerciales ou sur tous les abonnements d’une région ou d’une instance Azure Stack Hub. Vous pouvez répliquer des comptes de stockage sur différentes instances de Azure Stack Hub, car les piles sont des régions ou des instances distinctes.
Étapes suivantes
Différences et considérations relatives à la mise en réseau Azure Stack Hub