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

Une galerie de calcul Azure simplifie le partage d’images personnalisées au sein de 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 de calcul Azure vous permet de partager vos images de machine virtuelle personnalisées avec d’autres membres de votre organisation, au sein ou dans plusieurs régions, au sein d’un locataire Microsoft Entra, ou publiquement à l’aide d’une galerie community. 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. De nombreuses nouvelles fonctionnalités telles que ARM64, La mise en réseau accélérée et TrustedVM sont uniquement prises en charge via Azure Galerie de calcul et non disponibles pour les images managées.

La fonctionnalité Azure Galerie de calcul a 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 generalisée ou spécialisée, une image managée, un instantané ou une version d’image dans une autre galerie.
Galerie	Comme le Place de marché Azure, un gallery est un référentiel permettant de gérer et de partager des images et des applications VM mais vous contrôlez qui a 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. Cela inclut si l’image est Windows ou Linux, les notes de publication et les exigences minimales et maximales en mémoire. 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.

Prerequisites

Pour suivre cet article, vous devez disposer d’une galerie de calcul Azure 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 compris dans la plage d'un entier de 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 envisagez d’exécuter Sysprep avant de charger votre disque dur virtuel (VHD) sur Azure pour la première fois, vérifiez que vous avez preparé 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 Galerie de calcul.
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.
dans la page Ajouter une nouvelle définition d'image à la Galerie de calcul Azure, dans l’onglet 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 Généralisées et spécialisées.
Pour Publisher, tapez un nom unique tel que 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 géré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.

Pour créer une image à l’aide de l’Azure CLI, vous devez d’abord créer une définition d’image. 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éré la machine virtuelle (à l’aide de waagent -deprovision pour Linux ou sysprep pour Windows), vous devez créer une définition d’image généralisée à l’aide de --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 les images à l’aide d’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

Note

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 géré	`--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 géré	`--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 --virtual-machine 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 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Note

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.

Pour créer une image à l’aide de PowerShell, vous devez d’abord créer une définition d’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 est nommée myImageDefinition et concerne 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'

Note

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 géré	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disque de données
Instantané ou disque géré	`-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 est 1.0.0 et elle est répliquée dans les centres de données West Central US et South Central US. 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

Note

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 version d’image dans un locataire à l’aide de la version d’image source d’un autre locataire

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

Vous aurez besoin de la version tenantID de l’image source, de l’subscriptionID de l’abonnement où la nouvelle version de l’image sera stockée (cible), et de la version resourceID de l’image source. La définition d’image de la galerie cible doit déjà exister avant de créer la version de l’image avec az sig image-version create ou New-AzGalleryImageVersion. En outre, vérifiez que la région ou le réplica de la version d’image source et la région cible sont identiques.

INTERFACE DE LIGNE DE COMMANDE (CLI)
PowerShell

Utilisez l'Azure CLI pour créer une version d'image dans un abonnement à l'aide de la version d'image source dans un autre abonnement.

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

# Sign in to the subscription where the new image version will be created
az login

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

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

# Create the image version from the source image version
az sig image-version create \
   --gallery-image-definition myImageDef \
   --gallery-image-version 1.0.0 \
   --gallery-name myGallery \
   --resource-group myResourceGroup \
   --image-version $sourceImageVersionID \
   --location myLocation

Utilisez PowerShell pour créer une version d’image dans un client à l’aide de la version d’image source d’un autre client.

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

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

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

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

Étapes suivantes

Pour plus d’informations sur la façon de fournir des informations sur le plan d’achat, consultez Supply Place de marché Azure informations sur le plan d’achat lors de la création d’images.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-04-10

Partager via

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

Prerequisites

Galerie de la communauté

Créer une image

Créer une version d’image dans un locataire à l’aide de la version d’image source d’un autre locataire

Étapes suivantes

Commentaires

Ressources supplémentaires