Créer une image de machine virtuelle Azure Stack HCI à l’aide d’images Place de marché Azure
S’applique à : Azure Stack HCI, version 23H2
Cet article explique comment créer des images de machine virtuelle pour votre instance Azure Stack HCI à l’aide d’images sources de Place de marché Azure. Vous pouvez créer des images de machine virtuelle à l’aide du Portail Azure ou d’Azure CLI, puis utiliser ces images de machine virtuelle pour créer des machines virtuelles Arc sur votre instance Azure Stack HCI.
Prérequis
Avant de commencer, assurez-vous que les conditions préalables suivantes sont remplies.
Veillez à passer en revue et à remplir les conditions préalables.
Vous avez accès à un système Azure Stack HCI déployé, doté d’un pont de ressources Arc et d’un emplacement personnalisé.
Accédez à la page Serveur de vue d’ensemble > dans la ressource système Azure Stack HCI. Vérifiez qu’Azure Arc s’affiche comme connecté. Vous devez également voir un emplacement personnalisé et un pont de ressources Arc pour votre cluster.
- Si vous utilisez un client pour vous connecter à votre cluster Azure Stack HCI, consultez Se connecter à Azure Stack HCI via le client Azure CLI.
Ajouter une image de machine virtuelle à partir de Place de marché Azure
Vous créez une image de machine virtuelle à partir d’une image Place de marché Azure, puis utilisez cette image pour déployer des machines virtuelles sur votre cluster Azure Stack HCI.
Suivez ces étapes pour créer une image de machine virtuelle à l’aide d’Azure CLI.
Se connecter et définir un abonnement
Connectez-vous à un serveur sur votre système Azure Stack HCI.
Connectez-vous. Tapez :
az login --use-device-codeDéfinissez votre abonnement.
az account set --subscription <Subscription ID>
Définir les paramètres requis
Définissez les paramètres de votre abonnement, groupe de ressources, emplacement, type de système d’exploitation pour l’image. Remplacez les paramètres dans par
< >les valeurs appropriées.$subscription = "<Subscription ID>" $resource_group = "<Resource group>" $customLocationName = "<Custom location name>" $customLocationID /subscriptions/<Subscription ID>/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName $location = "<Location for your Azure Stack HCI cluster>" $osType = "<OS of source image>"Les paramètres sont décrits dans le tableau suivant :
Paramètre Description subscriptionAbonnement associé à votre cluster Azure Stack HCI. resource-groupGroupe de ressources pour le cluster Azure Stack HCI que vous associez à cette image. locationEmplacement de votre cluster Azure Stack HCI. Par exemple, il peut s’agir de eastus.os-typeSystème d’exploitation associé à l’image source. Il peut s’agir de Windows ou Linux. Voici un exemple de sortie :
PS C:\Users\azcli> $subscription = "<Subscription ID>" PS C:\Users\azcli> $resource_group = "myhci-rg" PS C:\Users\azcli> $customLocationName = "myhci-cl" PS C:\Users\azcli> $location = "eastus" PS C:\Users\azcli> $ostype = "Windows"
Créer une image de machine virtuelle à partir d’une image de la Place de marché
Sélectionnez un emplacement personnalisé pour déployer votre image de machine virtuelle. L’emplacement personnalisé doit correspondre à l’emplacement personnalisé de votre cluster Azure Stack HCI. Obtenez l’ID d’emplacement personnalisé pour votre cluster Azure Stack HCI. Exécutez la commande suivante :
$customLocationID=(az customlocation show --resource-group $resource_group --name "<custom location name for Azure Stack HCI cluster>" --query id -o tsv)Créez l’image de machine virtuelle en commençant par une image de place de marché spécifiée. Veillez à spécifier l’offre, l’éditeur, la référence SKU et la version pour l’image de la Place de marché. Utilisez le tableau suivant pour rechercher les images de la Place de marché disponibles et leurs valeurs d’attribut :
Nom Serveur de publication Offre SKU Numéro de version Windows 11 Entreprise multisession + Microsoft 365 Apps, version 21H2- Gen2 microsoftwindowsdesktop office-365 win10-21h2-avd-m365-g2 19044.3570.231010 Windows 10 Entreprise multisession, version 21H2 + Microsoft 365 Apps- Gen2 microsoftwindowsdesktop office-365 win11-21h2-avd-m365 22000.2538.231010 Windows 10 Entreprise multisession, version 21H2- Gen2 microsoftwindowsdesktop windows-10 win10-21h2-avd-g2 19044.3570.231001 Windows 11 Entreprise multisession, version 21H2- Gen2 microsoftwindowsdesktop windows-11 win11-21h2-avd 22000.2538.231001 Windows 11 Entreprise multisession, version 22H2 - Gen2 microsoftwindowsdesktop windows-11 win11-22h2-avd 22621.2428.231001 Windows 11, version 22H2 Entreprise multisession + Microsoft 365 Apps (préversion) - Gen2 microsoftwindowsdesktop windows11préview win11-22h2-avd-m365 22621.382.220810 Windows Server 2022 Datacenter : Azure Edition - Gen2 microsoftwindowsserver windowsserver 2022-datacenter-azure-edition 20348.2031.231006 Windows Server 2022 Datacenter : Azure Edition Core - Gen2 microsoftwindowsserver windowsserver 2022-datacenter-azure-edition-core 20348.2031.231006 Windows Server 2022 Datacenter : Hotpatch Édition Azure - Gen2 microsoftwindowsserver windowsserver 2022-datacenter-azure-edition-hotpatch 20348.2031.231006 az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --name "<VM image name>" --os-type $ostype --offer "windowsserver" --publisher "<Publisher name>" --sku "<SKU>" --version "<Version number>" --storage-path-id $storagepathidUn travail de déploiement démarre pour l’image de machine virtuelle.
Dans cet exemple, le chemin de stockage a été spécifié à l’aide de l’indicateur
--storage-path-idet a garanti que les données de charge de travail (y compris la machine virtuelle, l’image de machine virtuelle, le disque de données non du système d’exploitation) sont placées dans le chemin de stockage spécifié.Si l’indicateur n’est pas spécifié, les données de charge de travail sont automatiquement placées dans un chemin de stockage à haute disponibilité.
Le déploiement de l’image prend quelques minutes. Le temps nécessaire au téléchargement de l’image dépend de la taille de l’image de la Place de marché et de la bande passante réseau disponible pour le téléchargement.
Voici un exemple de sortie :
PS C:\Users\azcli> $customLocationID=(az customlocation show --resource-group $resource_group --name "myhci-cl" --query id -o tsv)
PS C:\Users\azcli> $customLocationID
/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl
PS C:\Users\azcli> az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --name "myhci-marketplaceimage" --os-type $ostype --offer "windowsserver" --publisher "microsoftwindowsserver" --sku "2022-datacenter-azure-edition-core" --version "20348.2031.231006" --storage-path-id $storagepathid
{
"extendedLocation": {
"name": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.ExtendedLocation/customLocations/myhci-cl",
"type": "CustomLocation"
},
"id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage",
"location": "eastus",
"name": "myhci-marketplaceimage",
"properties": {
"identifier": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2022-datacenter-azure-edition-core"
},
"imagePath": null,
"osType": "Windows",
"provisioningState": "Succeeded",
"status": {
"downloadStatus": {
"downloadSizeInMB": 6750
},
"progressPercentage": 98,
"provisioningStatus": {
"operationId": "13be90e0-a780-45bf-a84a-ae91b6e5e468*A380D53083FF6B0A3A157ED7DFD00D33F6B3D40D5559D11AEAED6AD68F7F1A4A",
"status": "Succeeded"
}
},
"storagepathId": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/storagecontainers/myhci-storagepath",
"version": {
"name": "20348.2031.231006",
"properties": {
"storageProfile": {
"osDiskImage": {
"sizeInMB": 130050
}
}
}
}
},
"resourceGroup": "myhci-rg",
"systemData": {
"createdAt": "2023-10-27T21:43:15.920502+00:00",
"createdBy": "guspinto@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2023-10-27T22:06:15.092321+00:00",
"lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
"lastModifiedByType": "Application"
},
"tags": null,
"type": "microsoft.azurestackhci/marketplacegalleryimages"
}
PS C:\Users\azcli>
Répertorier les images de machine virtuelle
Vous devez afficher la liste des images de machine virtuelle pour choisir une image à gérer.
Suivez ces étapes pour répertorier une image de machine virtuelle à l’aide d’Azure CLI.
Exécutez PowerShell ISE en tant qu’administrateur.
Définissez certains paramètres.
$subscription = "<Subscription ID associated with your cluster>" $resource_group = "<Resource group name for your cluster>"Répertoriez toutes les images de machine virtuelle associées à votre cluster. Exécutez la commande suivante :
az stack-hci-vm image list --subscription $subscription --resource-group $resource_groupSelon la commande utilisée, un ensemble d’images correspondant associé au cluster Azure Stack HCI est répertorié.
- Si vous spécifiez uniquement l’abonnement, la commande répertorie toutes les images de l’abonnement.
- Si vous spécifiez à la fois l’abonnement et le groupe de ressources, la commande répertorie toutes les images du groupe de ressources.
Ces images sont les suivantes :
- Images de machine virtuelle à partir d’images de la Place de marché.
- Images personnalisées qui résident dans votre compte Stockage Azure ou qui se trouvent dans un partage local sur votre cluster ou un client connecté au cluster.
Voici un exemple de sortie.
PS C:\Users\azcli> az stack-hci-vm image list --subscription "<Subscription ID>" --resource-group "myhci-rg"
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[
{
"extendedLocation": {
"name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl",
"type": "CustomLocation"
},
"id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/microsoft.azurestackhci/marketplacegalleryimages/w
inServer2022Az-01",
"location": "eastus",
"name": "winServer2022Az-01",
"properties": {
"hyperVGeneration": "V2",
"identifier": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2022-datacenter-azure-edition-core"
},
"imagePath": null,
"osType": "Windows",
"provisioningState": "Succeeded",
"status": {
"downloadStatus": {
"downloadSizeInMB": 6710
},
"progressPercentage": 100,
"provisioningStatus": {
"operationId": "19742d69-4a00-4086-8f17-4dc1f7ee6681*E1E9889F0D1840B93150BD74D428EAE483CB67B0904F9A198C161AD471F670ED",
"status": "Succeeded"
}
},
"storagepathId": null,
"version": {
"name": "20348.2031.231006",
"properties": {
"storageProfile": {
"osDiskImage": {
"sizeInMB": 130050
}
}
}
}
},
"resourceGroup": "myhci-rg",
"systemData": {
"createdAt": "2023-10-30T21:44:53.020512+00:00",
"createdBy": "guspinto@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2023-10-30T22:08:25.495995+00:00",
"lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
"lastModifiedByType": "Application"
},
"tags": {},
"type": "microsoft.azurestackhci/marketplacegalleryimages"
}
]
PS C:\Users\azcli>
Afficher les propriétés de l’image de machine virtuelle
Vous souhaiterez peut-être afficher les propriétés des images de machine virtuelle avant d’utiliser l’image pour créer une machine virtuelle. Pour afficher les propriétés de l’image, procédez comme suit :
Procédez comme suit pour utiliser Azure CLI pour afficher les propriétés d’une image :
Exécutez PowerShell ISE en tant qu’administrateur.
Définissez les paramètres suivants.
$subscription = "<Subscription ID>" $resource_group = "<Cluster resource group>" $mktplaceImage = "<Marketplace image name>"Vous pouvez afficher les propriétés de l’image de deux manières différentes : spécifier un ID ou spécifier un nom et un groupe de ressources. Effectuez les étapes suivantes lors de la spécification de l’ID d’image de la Place de marché :
Définissez le paramètre suivant.
$mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage"Exécutez la commande suivante pour afficher les propriétés.
az stack-hci-vm image show --ids $mktplaceImageIDVoici un exemple de sortie pour cette commande :
PS C:\Users\azcli> az stack-hci-vm image show --ids $mktplaceImageID Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus { "extendedLocation": { "name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl", "type": "CustomLocation" }, "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage", "location": "eastus", "name": "myhci-marketplaceimage", "properties": { "containerName": null, "hyperVGeneration": null, "identifier": null, "imagePath": null, "osType": "Windows", "provisioningState": "Succeeded", "status": null, "version": null }, "resourceGroup": "myhci-rg", "systemData": { "createdAt": "2022-08-05T20:52:38.579764+00:00", "createdBy": "guspinto@microsoft.com", "createdByType": "User", "lastModifiedAt": "2022-08-05T20:52:38.579764+00:00", "lastModifiedBy": "guspinto@microsoft.com", "lastModifiedByType": "User" }, "tags": null, "type": "microsoft.azurestackhci/galleryimages" } PS C:\Users\azcli>
Mettre à jour l’image de machine virtuelle
Lorsqu’une nouvelle image mise à jour est disponible dans Place de marché Azure, les images de machine virtuelle de votre cluster Azure Stack HCI deviennent obsolètes et doivent être mises à jour. L’opération de mise à jour n’est pas une mise à jour sur place de l’image. Au lieu de cela, vous pouvez voir pour quelles images de machine virtuelle une image mise à jour est disponible, et sélectionner des images à mettre à jour. Une fois la mise à jour effectuée, l’opération de création d’une image de machine virtuelle utilise la nouvelle image mise à jour.
Pour mettre à jour une image de machine virtuelle, procédez comme suit dans Portail Azure.
Pour voir si une mise à jour est disponible, sélectionnez une image de machine virtuelle dans la vue de liste.
Dans le panneau Vue d’ensemble , vous voyez une bannière qui affiche la nouvelle image de machine virtuelle disponible en téléchargement, le cas échéant. Pour effectuer une mise à jour vers la nouvelle image, sélectionnez l’icône de flèche.
Passez en revue les détails de l’image, puis sélectionnez Vérifier et créer. Par défaut, la nouvelle image utilise le même groupe de ressources et instance détails que l’image précédente.
Le nom de la nouvelle image est incrémenté en fonction du nom de l’image précédente. Par exemple, une image existante nommée winServer2022-01 aura une image mise à jour nommée winServer2022-02.
Pour terminer l’opération, sélectionnez Créer.
Une fois la nouvelle image de machine virtuelle créée, créez une machine virtuelle à l’aide de la nouvelle image et vérifiez que la machine virtuelle fonctionne correctement. Après vérification, vous pouvez supprimer l’ancienne image de machine virtuelle.
Notes
Dans cette version, vous ne pouvez pas supprimer une image de machine virtuelle si la machine virtuelle associée à cette image est en cours d’exécution. Arrêtez la machine virtuelle, puis supprimez l’image de machine virtuelle.
Supprimer une image de machine virtuelle
Vous pouvez supprimer une image de machine virtuelle si le téléchargement échoue pour une raison quelconque ou si l’image n’est plus nécessaire. Procédez comme suit pour supprimer les images de machine virtuelle.
Exécutez PowerShell ISE en tant qu’administrateur.
Définissez les paramètres suivants.
$subscription = "<Subscription ID>" $resource_group = "<Cluster resource group>" $galleryImageName = "<Gallery image name>"Supprimez une image de machine virtuelle existante. Exécutez la commande suivante :
az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes
Vous pouvez supprimer l’image de deux façons :
- Spécifiez le nom et le groupe de ressources.
- Spécifiez l’ID.
Une fois que vous avez supprimé une image, vous pouvez case activée que l’image est supprimée. Voici un exemple de sortie lorsque l’image a été supprimée en spécifiant le nom et le groupe de ressources.
PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "myhci-rg"
PS C:\Users\azcli> $mktplaceImage = "myhci-marketplaceimage"
PS C:\Users\azcli> az stack-hci-vm image delete --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Are you sure you want to perform this operation? (y/n): y
PS C:\Users\azcli> az stack-hci-vm image show --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
ResourceNotFound: The Resource 'Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage' under resource group 'myhci-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>
Étapes suivantes
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour