Partage via


Déployer ASDK à partir de la ligne de commande à l’aide de PowerShell

Le Kit de développement Azure Stack (ASDK) est un environnement de développement et de test que vous pouvez déployer pour évaluer et présenter les fonctionnalités et services Azure Stack. Pour l’installer et le rendre opérationnel, vous devez préparer l’environnement matériel nécessaire et exécuter plusieurs scripts. L’exécution des scripts prend plusieurs heures. Une fois que vous aurez effectué ces étapes préalables, vous pourrez vous connecter aux portails de l’administrateur et de l’utilisateur pour commencer à utiliser Azure Stack.

Prérequis

Préparer l’ordinateur hôte du kit ASDK. Planifiez votre matériel, vos logiciels et votre réseau. Vérifiez que l’ordinateur prévu pour héberger le kit ASDK a la configuration matérielle, logicielle et réseau requise. Choisissez entre utiliser Microsoft Entra ID ou services de fédération Active Directory (AD FS) (AD FS). Veillez à respecter ces prérequis avant de démarrer votre déploiement, assurez-vous que tous ces prérequis sont remplis pour que le processus d’installation s’exécute correctement.

Avant de déployer l’ASDK, assurez-vous que le matériel de l’ordinateur hôte du kit ASDK, le système d’exploitation, le compte et les configurations réseau répondent à la configuration minimale requise pour l’installation de l’ASDK.

Consultez la configuration requise et les considérations à prendre en compte concernant le déploiement du kit ASDK.

Téléchargez et extrayez le package de déploiement

Après vous être assuré que votre ordinateur hôte du kit ASDK répond aux exigences de base pour l’installation du kit de développement Azure Stack, il vous faut télécharger et extraire le package de déploiement du Kit de développement Azure Stack. Le package de déploiement contient le fichier Cloudbuilder.vhdx, un disque dur virtuel qui contient un système d’exploitation démarrable et les fichiers d’installation d’Azure Stack.

Vous pouvez télécharger le package de déploiement sur l’hôte du kit ASDK ou sur un autre ordinateur. Une fois extraits, les fichiers de déploiement occupent jusqu’à 60 Go d’espace disque. L’utilisation d’un autre ordinateur peut vous permettre d’avoir une configuration matérielle moins exigeante pour l’hôte du kit ASDK.

Télécharger et extraire le Kit de développement Azure Stack (ASDK)

Préparer l’ordinateur hôte du Kit de développement logiciel (SDK) Azure Stack

Avant de pouvoir installer le Kit de développement Azure Stack sur l’ordinateur hôte, l’environnement doit être préparé et le système doit être configuré pour démarrer à partir du disque dur virtuel. Après cette étape, l’hôte ASDK démarrera sur Cloudbuilder.vhdx (disque dur virtuel qui contient un système d’exploitation démarrable et les fichiers d’installation d’Azure Stack).

Utilisez PowerShell pour configurer l’ordinateur hôte ASDK pour qu’il démarre à partir de CloudBuilder.vhdx. Ces commandes configurent votre ordinateur hôte ASDK pour qu’il démarre à partir du disque dur virtuel Azure Stack téléchargé et extrait (CloudBuilder.vhdx). Après avoir effectué ces étapes, redémarrez l’ordinateur hôte ASDK.

Pour configurer l’ordinateur hôte ASDK pour qu’il démarre à partir de CloudBuilder.vhdx :

  1. Lancez une invite de commandes en tant qu’administrateur.
  2. Exécutez bcdedit /copy {current} /d "Azure Stack".
  3. Copiez (CTRL+C) la valeur CLSID retournée, y compris les accolades requises ({}) . Cette valeur correspond à {CLSID} et devra être collée (CTRL+V ou clic droit) dans les étapes restantes.
  4. Exécutez bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
  5. Exécutez bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
  6. Exécutez bcdedit /set {CLSID} detecthal on.
  7. Exécutez bcdedit /default {CLSID}.
  8. Pour vérifier les paramètres de démarrage, exécutez bcdedit.
  9. Vérifiez que le fichier CloudBuilder.vhdx a été déplacé à la racine du lecteur C:\ (C:\CloudBuilder.vhdx) et redémarrez l’ordinateur hôte ASDK. Une fois redémarré, l’ordinateur hôte ASDK démarre à partir du disque dur de la machine virtuelle CloudBuilder.vhdx pour que vous puissiez commencer le déploiement du Kit.

Important

Assurez-vous d’avoir un accès physique direct ou un accès à KVM à l’ordinateur hôte du kit ASDK avant de le redémarrer. Au premier démarrage de l’ordinateur virtuel, vous êtes invité à exécuter le programme d’installation de Windows Server. Fournissez les mêmes informations d’identification d’administrateur que celles utilisées pour vous connecter à l’ordinateur hôte du kit ASDK.

Préparer l’hôte ASDK à l’aide de PowerShell

Une fois que l’ordinateur hôte ASDK démarre dans l’image CloudBuilder.vhdx, connectez-vous avec les mêmes informations d'identification locales que celles utilisées pour se connecter à l’ordinateur hôte ASDK. Il s’agit également des mêmes informations d’identification que celles que vous avez fournies dans le cadre de la procédure d’installation de Windows Server lorsque l’ordinateur hôte a démarré à partir du disque dur virtuel.

Remarque

Si vous voulez, vous pouvez aussi configurer les Paramètres de télémétries Azure Stackavant l’installation du Kit de développement Azure Stack.

Ouvrez une console PowerShell avec élévation de privilèges et exécutez les commandes de cette section pour déployer l’ASDK sur l’hôte d’ASDK.

Important

L’installation d’ASDK prend en charge une seule carte réseau de mise en réseau. Si vous avez plusieurs cartes réseau, vérifiez qu’une seule d’entre elles est activée (et que toutes les autres sont désactivées) avant d’exécuter le script de déploiement.

Vous pouvez déployer Azure Stack avec Microsoft Entra ID ou Windows Server AD FS en tant que fournisseur d’identité. Azure Stack, les fournisseurs de ressources et les autres applications fonctionnent de la même façon avec les deux.

Conseil

Si vous ne fournissez aucun paramètre de configuration (reportez-vous aux exemples et paramètres facultatifs InstallAzureStackPOC.ps1 ci-dessous), vous êtes invité à entrer les paramètres requis.

Déployer Azure Stack à l’aide de l’ID Microsoft Entra

Pour déployer Azure Stack à l’aide de Microsoft Entra ID comme fournisseur d’identité, vous devez disposer d’une connectivité Internet directement ou via un proxy transparent.

Exécutez les commandes PowerShell suivantes pour déployer le SDK ASDK à l’aide de l’ID Microsoft Entra :

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator     
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password

Quelques minutes après l’installation d’ASDK, vous êtes invité à entrer les informations d’identification Microsoft Entra. Fournissez les informations d’identification d’administrateur général pour votre locataire Microsoft Entra.

Après le déploiement, l’autorisation d’administrateur général Microsoft Entra n’est pas nécessaire. Cependant, certaines opérations peuvent nécessiter les informations d'identification d’administrateur global. De telles opérations sont, par exemple, le script d’installation d’un fournisseur de ressources ou une nouvelle fonctionnalité nécessitant une autorisation spécifique. Vous pouvez temporairement réactiver les autorisations d’administrateur général du compte ou utiliser un compte d’administrateur général distinct qui est propriétaire de l’abonnement de fournisseur par défaut.

Déployer Azure Stack à l’aide d’AD FS

Pour déployer le kit ASDK avec AD FS comme fournisseur d’identité, exécutez les commandes PowerShell suivantes (vous avez simplement besoin d’ajouter le paramètre -UseADFS) :

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -UseADFS

Dans les déploiements AD FS, le service d’annuaire de marquage par défaut est utilisé comme fournisseur d’identité. Le compte par défaut avec lequel se connecter est azurestackadmin@azurestack.local et le mot de passe défini est celui que vous avez fourni dans le cadre des commandes de configuration PowerShell.

Le processus de déploiement peut prendre quelques heures, au cours desquelles le système ne redémarre automatiquement qu’une seule fois. Quand le déploiement est terminé, la console PowerShell affiche le message suivant : TERMINÉ : Action « Déploiement ». Si le déploiement échoue, essayez d’exécuter à nouveau le script en utilisant le paramètre -rerun. Vous pouvez aussi redéployer ASDK à partir de zéro.

Important

Si vous voulez surveiller la progression du déploiement, après le redémarrage de l’hôte ASDK, vous pouvez vous connecter en tant que AzureStack\AzureStackAdmin. Si vous vous connectez en tant qu’administrateur local une fois que l’ordinateur hôte est redémarré (et joint au domaine azurestack.local), vous ne verrez pas la progression du déploiement. Ne réexécutez pas le déploiement : au lieu de cela, connectez-vous en tant que AzureStack\AzureStackAdmin avec le mot de passe de l’administrateur local pour vérifier que l’installation est en cours d’exécution.

Exemples de script de déploiement Microsoft Entra

Vous pouvez scripter l’intégralité du déploiement De Microsoft Entra. Voici quelques exemples commentés qui incluent certains paramètres facultatifs.

Si votre identité Microsoft Entra n’est associée qu’à un seul annuaire Microsoft Entra :

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 52.168.138.145 #Example time server IP address.

Si votre identité Microsoft Entra est associée à un répertoire Microsoft Entra supérieur à un répertoire Microsoft Entra :

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" #Example: user@AADDirName.onmicrosoft.com 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -InfraAzureDirectoryTenantName "<Azure AD directory in the form of domainname.onmicrosoft.com or an Azure AD verified custom domain name>" -TimeServer 52.168.138.145 #Example time server IP address.

Si votre environnement n’a pas de DHCP activé, vous devez inclure les paramètres supplémentaires suivants à l’une des options ci-dessus (exemple d’utilisation fourni) :

.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26

Paramètres facultatifs InstallAzureStackPOC.ps1 ASDK

Paramètre Obligatoires/facultatif Description
AdminPassword Requis Définit le compte d’administrateur local et tous les autres comptes d’utilisateur sur toutes les machines virtuelles créées dans le cadre du déploiement du kit ASDK. Ce mot de passe doit correspondre au mot de passe d’administrateur local actuel sur l’hôte.
InfraAzureDirectoryTenantName Requis Définit le répertoire du locataire. Utilisez ce paramètre pour spécifier un répertoire spécifique dans lequel le compte Microsoft Entra dispose des autorisations nécessaires pour gérer plusieurs répertoires. Nom complet d’un locataire Microsoft Entra au format .onmicrosoft.com ou nom de domaine personnalisé vérifié par Microsoft Entra ID.
TimeServer Requis Utilisez ce paramètre pour spécifier un serveur de temps spécifique. Ce paramètre doit être fourni sous la forme d’une adresse IP de serveur temps valide. Les noms des serveurs ne sont pas pris en charge.
InfraAzureDirectoryTenantAdminCredential Facultatif Définit le nom d’utilisateur et le mot de passe Microsoft Entra. Ces informations d’identification Azure doivent être un ID org.
InfraAzureEnvironment Facultatif Sélectionnez l’environnement Azure avec lequel vous souhaitez enregistrer ce déploiement Azure Stack. Les options incluent Azure mondial, Azure Chine, Azure US Government.
DNSForwarder Facultatif Un serveur DNS est créé dans le cadre du déploiement Azure Stack. Pour permettre aux ordinateurs de la solution de résoudre les noms en dehors du marquage, spécifiez le serveur DNS de votre infrastructure existante. Le serveur DNS couvert par le marquage transfère les demandes de résolution de noms inconnus à ce serveur.
Rerun Facultatif Utilisez cet indicateur pour réexécuter le déploiement. Toutes les entrées précédentes sont utilisées. Une nouvelle saisie des données précédemment fournies n’est pas prise en charge, car plusieurs valeurs uniques sont générées et utilisées pour le déploiement.

Effectuer des configurations post-déploiement

Après avoir installé le Kit de développement Azure Stack, nous vous recommandons d’effectuer quelques vérifications post-installation et des modifications de configuration. Validez votre installation à l’aide de la cmdlet test-AzureStack, puis installez les outils Azure Stack PowerShell et GitHub.

Nous vous recommandons de réinitialiser la stratégie d’expiration du mot de passe pour faire en sorte que le mot de passe de l’hôte du kit ASDK n’expire pas avant la fin de la période d’expiration.

Remarque

Si vous voulez, vous pouvez aussi configurer les Paramètres de télémétries Azure Stackaprès l’installation du Kit de développement Azure Stack.

Tâches post-déploiement du Kit de développement Azure Stack

Inscription auprès d’Azure

Vous devez inscrire Azure Stack auprès d’Azure pour pouvoir ensuite télécharger des éléments de la Place de marché Azure dans Azure Stack.

Inscrire Azure Stack auprès d’Azure

Étapes suivantes

Félicitations ! Une fois toutes ces étapes effectuées, l’environnement pour le kit ASDK est prêt, avec les portails de l’administrateur https://adminportal.local.azurestack.external et de l’utilisateur https://portal.local.azurestack.external.

Tâches de configuration après l’installation du kit ASDK