Répertorier, mettre à jour et supprimer des ressources de galerie

  • Article

Vous pouvez gérer votre galerie Azure Compute Gallery (anciennement appelée Shared Image Gallery) à l’aide de l’interface Azure CLI ou d’Azure PowerShell.

Lister les galeries partagées avec vous

Listez les galeries partagées avec votre abonnement.

region=westus
az sig list-shared --location $region

Listez les galeries partagées avec votre locataire.

region=westus
az sig list-shared --location $region --shared-to tenant

La sortie contient le name public et le uniqueID de la galerie qui est partagée avec vous. Vous pouvez utiliser le nom de la galerie pour rechercher des images disponibles par le biais de la galerie.

Voici un exemple de sortie :

[
  {
    "location": "westus",
    "name": "1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED",
    "uniqueId": "/SharedGalleries/1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED"
  }
]

Mettre à jour les ressources

Il existe certaines limitations concernant les éléments qui peuvent être mis à jour. Les éléments suivants peuvent être mis à jour :

Azure Compute Gallery :

  • Description

Définition d’image :

  • Processeurs virtuels recommandés
  • Mémoire recommandée
  • Description
  • Date de fin de vie

Version d’image :

  • Nombre de réplicas régionaux
  • Régions cibles
  • Exclusion du dernier
  • Date de fin de vie

Mettez à jour la description d’une galerie à l’aide de (az sig update.

az sig update \
   --gallery-name myGallery \
   --resource-group myGalleryRG \
   --set description="My updated description."

Mettez à jour la description d’une définition d’image à l’aide de az sig image-definition update.

az sig image-definition update \
   --gallery-name myGallery\
   --resource-group myGalleryRG \
   --gallery-image-definition myImageDefinition \
   --set description="My updated description."

Mettez à jour une version de l’image pour ajouter une région à répliquer à l’aide de az sig image-version update. Cette modification prendra un certain temps, puisque l’image est répliquée vers la nouvelle région.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --add publishingProfile.targetRegions  name=eastus

Cet exemple montre comment utiliser az sig image-version update pour empêcher l’utilisation de cette version de l’image comme image la plus récente.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=true

Cet exemple montre comment utiliser az sig image-version update pour que cette version de l’image soit considérée comme l’image la plus récente.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=false

Supprimer des ressources

Vous devez supprimer les ressources dans l’ordre inverse, en supprimant tout d’abord la version de l’image. Après avoir supprimé toutes les versions de l’image, vous pouvez supprimer la définition de l’image. Après avoir supprimé toutes les définitions de l’image, vous pouvez supprimer la galerie.

Avant de pouvoir supprimer une galerie partagée de la communauté, vous devez utiliser az sig share reset pour arrêter de partager la galerie publiquement.

Supprimez une version de l’image avec az sig image-version delete.

az sig image-version delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0

Supprimez une définition de l’image avec az sig image-definition delete.

az sig image-definition delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition

Supprimez une galerie à l’aide de az sig delete.

az sig delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery

Galeries de communauté

Important

Galerie de calcul Azure : les galeries de communauté sont actuellement en préversion et soumises aux Conditions d’évaluation de Azure Compute Gallery – Galerie de communauté.

Pour publier une galerie de communauté, vous devez configurer les fonctionnalités en préversion dans votre abonnement Azure. La création de machines virtuelles à partir d’images galerie de communauté est ouverte à tous les utilisateurs d’Azure.

Pour répertorier vos propres galeries et générer les noms publics de vos galeries de communauté :

az sig list --query [*]."{Name:name,PublicName:sharingProfile.communityGalleryInfo.publicNames}"

Notes

En tant qu’utilisateur final, pour obtenir le nom public d’une galerie de communauté, vous devez actuellement utiliser le portail. Accédez à Machines virtuelles>Créer>Machine virtuelle Azure>Image>Afficher toutes les images de machines virtuelles>Images de communauté>Nom de la galerie publique.

Répertoriez toutes les définitions d’images disponibles dans une galerie de communauté à l’aide de az sig image-definition list-community.

Dans cet exemple, nous dressons la liste de toutes les images de la galerie ContosoImage dans la région USA Ouest et par nom, l’ID unique nécessaire pour créer une machine virtuelle, un système d’exploitation et un état du système d’exploitation.

 az sig image-definition list-community \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --location westus \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Répertoriez les versions des images partagées dans une galerie de communauté en utilisant az sig image-version list-community :

az sig image-version list-community \
   --location westus \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --gallery-image-definition myImageDefinition \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Galeries partagées directes

Important

Galerie Azure Compute Gallery : la galerie partagée directe est en préversion et est soumise aux Conditions d’évaluation d’Azure Compute Gallery.

Pour publier des images dans une galerie partagée directe pendant la préversion, vous devez vous inscrire sur https://aka.ms/directsharedgallery-preview. La création de machines virtuelles à partir de la galerie partagée directe est ouverte à tous les utilisateurs d’Azure.

Pendant la préversion, vous devez créer une galerie, en définissant la propriété sharingProfile.permissions sur Groups. Quand vous utilisez l’interface CLI pour créer une galerie, utilisez le paramètre --permissions groups. Vous ne pouvez pas utiliser une galerie existante ; la propriété ne peut pas être mise à jour.

Pour rechercher le uniqueID d’une galerie partagée avec vous, utilisez az sig list-shared. Dans cet exemple, nous recherchons les galeries dans la région USA Ouest.

region=westus
az sig list-shared --location $region --query "[].uniqueId" -o tsv

Listez toutes les définitions d’image qui sont partagées directement avec vous ; utilisez az sig image-definition list-shared.

Dans cet exemple, nous dressons la liste de toutes les images de la galerie de la région USA Ouest et par nom, l’ID unique nécessaire pour créer une machine virtuelle, un système d’exploitation et un état du système d’exploitation.

name="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $name
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Listez les versions d’image directement partagées avec vous en utilisant az sig image-version list-shared :

imgDef="myImageDefinition"
az sig image-version list-shared \
   --location $region \
   --public-gallery-name $name \
   --gallery-image-definition $imgDef \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Étapes suivantes