Créer une définition d’image et une version d’image

Article
09/20/2023

Attention

Cet article fait référence à CentOS, une distribution Linux proche de l’état EOL (End Of Life). Faites le point sur votre utilisation et organisez-vous en conséquence. Pour plus d’informations, consultez l’aide Fin de vie CentOS.

Une galerie Azure Compute Gallery (anciennement Shared Image Gallery) simplifie le partage d’images personnalisées dans votre organisation. Les images personnalisées sont comme des images de la Place de marché, sauf que vous les créez vous-même. Les images peuvent être créées à partir d’une machine virtuelle, d’un disque dur virtuel, d’un instantané, d’une image managée ou d’une autre version d’image.

La galerie Azure Compute Gallery vous permet de partager vos images de machine virtuelle personnalisées avec d’autres personnes de votre organisation, dans la même région ou des régions différentes, au sein d’un locataire Microsoft Entra, ou publiquement avec une galerie de la communauté. Choisissez les images à partager, les régions dans lesquelles vous souhaitez les rendre disponibles et les personnes avec lesquelles vous voulez les partager. Vous pouvez créer plusieurs galeries afin de regrouper logiquement les images. La plupart des nouvelles fonctionnalités comme ARM64, Performances réseau accélérées et TrustedVM ne sont prises en charge qu’à travers Azure Compute Gallery et ne sont pas disponibles pour les images managées.

La fonctionnalité Azure Compute Gallery présente plusieurs types de ressources :

Ressource	Description
Source d’image	Cette ressource peut être utilisée pour créer une version d’image dans une galerie. Une source d’image peut être une machine virtuelle Azure existante qui est généralisée ou spécialisée, une image managée, un instantané ou une version d’image dans une autre galerie.
Galerie	Tout comme la Place de marché Azure, une galerie est un dépôt permettant de gérer et partager des images et des applications VM, mais vous contrôlez les utilisateurs qui y ont accès.
Définition d'image	Les définitions d’image sont créées dans une galerie et contiennent des informations sur l’image et sur les exigences relatives à son utilisation en interne. Ces informations indiquent, par exemple, si l’image est Windows ou Linux, et comprennent les notes de publication et les exigences de mémoire maximale et minimale. Il s’agit d’une définition de type d’image.
Version de l’image	Une version d’image est ce qui vous permet de créer une machine virtuelle quand vous utilisez une galerie. Vous pouvez avoir plusieurs versions d’une image en fonction des besoins de votre environnement. Tout comme une image managée, quand vous utilisez une version d’image pour créer une machine virtuelle, la version d’image permet de créer des disques pour la machine virtuelle. Les versions d’image peuvent être utilisées plusieurs fois.

Avant de commencer

Pour suivre cet article, vous devez disposer d’une galerie Azure Compute Gallery existante et d’une source pour votre image disponible dans Azure. Les sources d’images peuvent être :

Une machine virtuelle dans votre abonnement. Vous pouvez capturer une image à partir de machines virtuelles spécialisées et généralisées.
Une image managée.
Des disques de système d’exploitation et de données managés.
Des disques de système d’exploitation et de données en tant que disques durs virtuels dans un compte de stockage.
D’autres versions de l’image, soit dans la même galerie, soit dans une autre galerie du même abonnement.

Si l’image contient des disques de données, la taille du disque de données ne peut pas être supérieure à 1 To.

Les noms de définition d’image peuvent contenir des lettres majuscules ou minuscules, des chiffres, des tirets et des points. Pour plus d’informations sur les valeurs que vous pouvez spécifier pour une définition d’image, consultez Définitions d’image.

Les caractères autorisés pour la version d’image sont les chiffres et les points. Les nombres doivent être un entier 32 bits. Format: MajorVersion.MinorVersion.Patch.

Dans cet article, remplacez les noms de ressources si nécessaire.

Pour les images généralisées, consultez les instructions spécifiques au système d’exploitation avant de capturer l’image :

Linux
- Procédure générique
- CentOS
- Debian
- Flatcar
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Si vous prévoyez d’exécuter Sysprep avant de charger votre disque dur virtuel sur Azure pour la première fois, vérifiez que vous avez préparé votre machine virtuelle.

Galerie de la communauté

Si vous partagez vos images à l’aide d’une galerie de la communauté, veillez à créer votre galerie, vos définitions d’images et vos versions d’image dans la même région.

Lorsque les utilisateurs recherchent des images de galerie de la communauté, seule la dernière version d’une image est affichée.

Important

Les informations de vos définitions d’image seront disponibles publiquement, comme celles que vous fournissez pour Publication, Offre et SKU.

Créer une image

Choisissez une option ci-dessous pour créer votre définition d’image et votre version d’image :

Pour créer une image à partir d’une machine virtuelle dans le portail, consultez Capturer une image d’une machine virtuelle.

Pour créer une image à l’aide d’une source autre qu’une machine virtuelle, procédez comme suit.

Accédez au portail Azure, puis recherchez et sélectionnez Azure Compute Gallery.
Sélectionnez la galerie à utiliser dans la liste.
Sur la page de votre nouvelle galerie d’images, sélectionnez Ajouter en haut de la page, puis Définition d’image de machine virtuelledans le menu déroulant.
Sur la page Ajouter une nouvelle définition d’image à Azure Compute Gallery, dans l’onglet Informations de base, sélectionnez une Région.
Pour Nom de la définition d’image, tapez un nom comme myImageDefinition.
Pour Système d’exploitation, sélectionnez l’option appropriée en fonction de votre source.
Pour Génération de machine virtuelle, sélectionnez l’option en fonction de votre source. Dans la plupart des cas, ce sera Gen 1. Pour plus d'informations, voir Prise en charge des machines virtuelles de 2e génération.
Pour État du système d’exploitation, sélectionnez l’option appropriée en fonction de votre source. Pour plus d’informations, voir Machines virtuelles généralisées et spécialisées.
Pour Éditeur, entrez un nom unique, par exemple myPublisher.
Pour Offre, saisissez un nom unique, par exemple myOffer.
Pour SKU, saisissez un nom unique, par exemple mySKU.
En bas de la page, sélectionnez Revoir + Créer.
Une fois la définition de l’image validée, sélectionnez Créer.
Une fois le déploiement terminé, sélectionnez Accéder à la ressource.
Dans la page de votre définition d’image, dans l’onglet Prise en main, sélectionnez Créer une version.
Dans Région, sélectionnez la région où créer l’image. Dans certains cas, la source doit se trouver dans la même région que celle où l’image est créée. Si votre source ne figure pas dans les listes déroulantes ultérieures, essayez de modifier la région de l’image. Vous pourrez toujours répliquer l’image dans d’autres régions par la suite.
Pour Numéro de version, tapez un nombre comme 1.0.0. Le nom de version d’image doit respecter le format version majeure.version mineure.correctif en utilisant des nombres entiers.

Dans Source, sélectionnez le type de fichier que vous utilisez pour votre source dans la liste déroulante. Consultez le tableau ci-dessous pour obtenir des détails spécifiques pour chaque type de source.

Source	Autres champs
Disques ou instantanés	- Pour Disque de système d’exploitation, sélectionnez le disque ou l’instantané dans la liste déroulante. - Pour ajouter un disque de données, tapez le numéro de LUN, puis sélectionnez le disque de données dans la liste déroulante.
Version d’image	- Sélectionnez la galerie source dans la liste déroulante. - Sélectionnez la définition d’image appropriée dans la liste déroulante. - Sélectionnez la version de l’image existante que vous souhaitez utiliser dans la liste déroulante.
Image managée	Sélectionnez l’image source dans la liste déroulante. L’image managée doit se trouver dans la même région que celle que vous avez choisie dans Détails de l’instance.
VHD dans un compte de stockage	Sélectionnez Parcourir pour choisir le compte de stockage du VHD.

Dans Exclure de la plus récente, laissez la valeur par défaut Non, sauf si vous ne souhaitez pas que cette version soit utilisée lors de la création d’une machine virtuelle à l’aide de latest au lieu d’un numéro de version.
Pour Date de fin de vie, sélectionnez dans le calendrier une date à laquelle vous pensez que cette version devrait cesser d’être utilisée.
Dans l’onglet Réplication, sélectionnez le type de stockage dans la liste déroulante.
Définissez le nombre de réplicas par défaut. Vous pouvez le remplacer pour chaque région que vous ajoutez.
Vous devez effectuer une réplication vers la région source, de sorte que le premier réplica de la liste sera dans la région où vous avez créé l’image. Vous pouvez ajouter d’autres réplicas en sélectionnant la région dans la liste déroulante et en ajustant le nombre de réplicas si nécessaire.
Quand vous avez terminé, sélectionnez Vérifier + créer. Azure validera la configuration.
Une fois la définition d’image validée, sélectionnez Créer.
Une fois le déploiement terminé, sélectionnez Accéder à la ressource.

La réplication de l’image à l’ensemble des régions cibles peut prendre un certain temps.

Vous pouvez également capturer une machine virtuelle existante sous forme d’image à partir du portail. Pour plus d’informations, consultez Créer une image d’une machine virtuelle dans le portail.

Les définitions d’image créent un regroupement logique des images. Elles sont utilisées pour gérer les informations sur les versions d’image créées au sein de celles-ci.

Créez une définition d’image dans une galerie avec la commande az sig image-definition create. Assurez-vous que le type de votre définition d’image est approprié. Si vous avez généralisé la machine virtuelle (avec waagent -deprovision pour Linux ou Sysprep pour Windows), vous devez créer une définition d’image généralisée à avec --os-state generalized. Si vous souhaitez utiliser la machine virtuelle sans supprimer de comptes d’utilisateur, créez une définition d’image spécialisée à l’aide de la commande --os-state specialized.

Pour plus d’informations sur les paramètres que vous pouvez spécifier pour une définition d’image, consultez Définitions d’image.

Dans cet exemple, la définition d’image est nommée myImageDefinition et est destinée à une image de système d’exploitation Linux spécialisée. Pour créer une définition pour des images utilisant un système d’exploitation Windows, utilisez --os-type Windows.

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

Notes

Pour les définitions d’images qui contiennent des images provenant d’images de marketplaces tierces, les informations de plan doivent correspondre exactement aux informations de plan de l’image tierce. Incluez les informations de plan dans la définition de l’image en ajoutant --plan-name, --plan-product et --plan-publisher lors de la création de la définition de l’image.

Créer la version de l’image

Créez une version de l’image avec az sig image version create.

La syntaxe de création de l’image change en fonction de la source que vous utilisez. Vous pouvez mélanger les types de sources, tant que vous n’avez qu’une seule source de système d’exploitation. Vous pouvez également avoir des sources différentes pour chaque disque de données.

Source	Jeu de paramètres
Disque du système d’exploitation :
Machine virtuelle utilisant l’ID de machine virtuelle	`--managed-image <Resource ID of the VM>`
Image managée ou une autre version de l’image	`--managed-image <Resource ID of the managed image or image version`
Instantané ou disque managé	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD dans un compte de stockage	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Disque de données :
Instantané ou disque managé	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD dans un compte de stockage	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Pour obtenir des exemples détaillés de la façon de spécifier différentes sources pour votre image, consultez les exemples de la commande az sig image-version create.

Dans l’exemple ci-dessous, nous créons une image à partir d’une machine virtuelle. La version de notre image est 1.0.0 et nous allons créer 2 réplicas dans la région USA Centre-Ouest, 1 réplica dans la région USA Centre Sud et 1 réplica dans la région USA Est 2 à l’aide du stockage redondant interzone. Les régions de réplication doivent inclure la région dans laquelle se trouve la machine virtuelle source.

Il est recommandé d’arrêter ou de désallouer la machine virtuelle avant de créer une image.

Remplacez la valeur --managed-image dans cet exemple par l’ID de votre machine virtuelle.

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --managed-image "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Notes

Vous devez attendre que la version d’image soit totalement intégrée et répliquée avant de pouvoir utiliser la même image managée pour créer une autre version d’image.

Vous pouvez également stocker votre image dans le Stockage Premium, en ajoutant --storage-account-type premium_lrs, ou dans le stockage redondant interzone, en ajoutant --storage-account-type standard_zrs, quand vous créez la version de l’image.

Les définitions d’image créent un regroupement logique des images. Lors de la définition de votre image, assurez-vous de disposer de toutes les informations correctes. Si vous avez généralisé la machine virtuelle source, vous devez alors créer une définition d'image en utilisant -OsState generalized. Si vous n’avez pas généralisé la source, créez une définition d’image à l’aide de -OsState specialized.

Pour plus d’informations sur les valeurs que vous pouvez spécifier pour une définition d’image, consultez Définitions d’image.

Créez la définition d’image à l’aide de New-AzGalleryImageDefinition.

Dans cet exemple, la définition d’image se nomme myImageDefinition et est destinée à une machine virtuelle spécialisée exécutant Windows. Pour créer une définition pour des images à l’aide de Linux, utilisez -OsType Linux.

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

Notes

Pour les définitions d’images qui contiennent des images provenant d’images tierces, les informations de plan doivent correspondre exactement aux informations de plan de l’image tierce. Incluez les informations de plan dans la définition de l’image en ajoutant -PurchasePlanName, -PurchasePlanProduct et -PurchasePlanPublisher lors de la création de la définition de l’image.

Créer une version d’image

Créez une version d’image à l’aide de New-AzGalleryImageVersion.

La syntaxe de création de l’image change en fonction de la source que vous utilisez.

Source	Jeu de paramètres
Disque du système d’exploitation
Machine virtuelle utilisant l’ID de machine virtuelle	`-SourceImageId <Resource ID of the VM>`
Image managée ou une autre version de l’image	`-SourceImageId <Resource ID of the managed image or image version`
Instantané ou disque managé	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disque de données
Instantané ou disque managé	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

Dans l’exemple ci-dessous, nous créons une version d’image à partir d’une machine virtuelle. Il est recommandé d’arrêter\désallouer la machine virtuelle avant de créer une image à l’aide de la commande Stop-AzVM.

Dans cet exemple, la version d'image, 1.0.0, elle est répliquée dans les deux centres de données USA Centre-Ouest et USA Centre Sud. Lors du choix des régions cibles pour la réplication, n’oubliez pas que vous devez également inclure la région source en tant que cible pour la réplication.

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob

La réplication de l'image dans toutes les régions cibles peut nécessiter un certain temps et nous avons donc créé une tâche pour en suivre la progression. Pour afficher la progression de la tâche, entrez $job.State.

$job.State

Notes

Vous devez attendre que la version d’image soit totalement intégrée et répliquée avant de pouvoir utiliser la même image managée pour créer une autre version d’image.

Vous pouvez également stocker votre image dans le Stockage Premium, en ajoutant -StorageAccountType Premium_LRS, ou dans le stockage redondant interzone, en ajoutant -StorageAccountType Standard_ZRS, quand vous créez la version de l’image.

Créez une définition d’image à l’aide de l’API REST.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

Créez une version d’image à l’aide de l’API REST. Dans cet exemple, nous créons une version d’image à partir d’une machine virtuelle. Pour utiliser une autre source, transmettez l’ID de ressource de la source (par exemple, transmettez l’ID de l’instantané du disque de système d’exploitation).

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

Créer une image dans un locataire en utilisant l’image source d’un autre locataire

Dans l’abonnement où l’image source existe, accordez des autorisations de lecteur à l’utilisateur. Une fois que l’utilisateur a des autorisations de lecteur sur l’image source, connectez-vous aux deux comptes (source et cible).

Vous aurez besoin du tenantID de l’image source, du subscriptionID de l’abonnement où la nouvelle image sera stockée (cible) et du resourceID de l’image source.

INTERFACE DE LIGNE DE COMMANDE
PowerShell

# Set some variables
tenantID="<tenant ID for the source image>"
subID="<subscription ID where the image will be creted>"
sourceImageID="<resource ID of the source image>"

# Login to the subscription where the new image will be created
az login

# Log in to the tenant where the source image is available
az login --tenant $tenantID

# Log back in to the subscription where the image will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image
az sig image-version create `
   --gallery-image-definition myImageDef `
   --gallery-image-version 1.0.0 `
   --gallery-name myGallery `
   --resource-group myResourceGroup `
   --image-version $sourceImageID

# Set variables 
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID where for the source image>"
$sourceImageID = "<resource ID of the source image>"

# Login to the tenant where the source image is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication 

# Login to the subscription where the new image will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID 

# Create the image version from another image version in a different tenant
New-AzGalleryImageVersion `
   -ResourceGroupName myResourceGroup -GalleryName myGallery `
   -GalleryImageDefinitionName myImageDef `
   -Location "West US 2" `
   -Name 1.0.0 `
   -SourceImageId $sourceImageID

Étapes suivantes

Pour savoir comment fournir des informations sur le plan d’achat, consultez Donner des informations sur le plan d’achat de la Place de marché Azure lors de la création d’images.

Créer une définition d’image et une version d’image

Avant de commencer

Galerie de la communauté

Créer une image

Créer une image dans un locataire en utilisant l’image source d’un autre locataire

Étapes suivantes

Ressources supplémentaires