Listar, atualizar e apagar recursos de galeria

  • Artigo
  • 7 minutos para ler

Pode gerir os seus recursos Azure Compute Gallery (anteriormente conhecido como Shared Image Gallery) utilizando o Azure CLI ou Azure PowerShell.

Galerias de listas partilhadas consigo

List Galleries compartilhado com a sua assinatura.

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

List Galleries compartilhados com o seu inquilino.

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

A saída conterá o público name e uniqueID a galeria que é partilhada consigo. Pode utilizar o nome da galeria para consultar imagens que estejam disponíveis através da galeria.

Aqui está a saída exemplo:

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

Atualizar recursos

Existem algumas limitações no que pode ser atualizado. Os seguintes itens podem ser atualizados:

Galeria Azure Compute:

  • Description

Definição de imagem:

  • VCPUs recomendados
  • Memória recomendada
  • Description
  • Data de fim de vida

Versão de imagem:

  • Contagem de réplicas regionais
  • Regiões-alvo
  • Exclusão das últimas
  • Data de fim de vida

Se planeia adicionar regiões réplicas, não elimine a imagem gerida pela fonte. A imagem gerida pela fonte é necessária para replicar a versão de imagem para regiões adicionais.

Atualize a descrição de uma galeria utilizando (atualização az sig.

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

Atualize a descrição de uma definição de imagem usando a atualização da definição de imagem az sig.

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

Atualize uma versão de imagem para adicionar uma região para replicar a utilização da atualização da versão de imagem az sig. Esta mudança levará algum tempo à medida que a imagem for replicada para a nova região.

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

Este exemplo mostra como utilizar a atualização da versão de imagem az sig para excluir que esta versão de imagem seja usada como a imagem mais recente .

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

Este exemplo mostra como usar a atualização de versão az sig para incluir esta versão de imagem em ser considerada para a imagem mais recente .

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

Eliminar recursos

Tem de apagar os recursos em ordem inversa, eliminando primeiro a versão de imagem. Depois de eliminar todas as versões de imagem, pode eliminar a definição de imagem. Depois de eliminar todas as definições de imagem, pode apagar a galeria.

Antes de apagar uma galeria partilhada pela comunidade, precisa de usar o reset da az sig share para parar de partilhar a galeria publicamente.

Elimine uma versão de imagem utilizando a versão az sig de imagem delete.

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

Elimine uma definição de imagem usando a definição de imagem az sig delete.

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

Elimine uma galeria usando az sig delete.

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

Galerias comunitárias

Importante

Azure Compute Gallery – galerias comunitárias está atualmente em PREVIEW e sujeita aos Termos de Pré-Visualização da Galeria Azure Compute – galeria comunitária.

Para listar as suas próprias galerias, e desemboar os nomes públicos para as suas galerias comunitárias:

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

Nota

Como utilizador final, para obter o nome público de uma galeria comunitária, atualmente precisa de usar o portal. Ir a máquinas> virtuaisCriar>máquina> virtual AzureImagem>Ver todas as imagens>Imagens> ComunidadeNome da galeria.

Lista todas as definições de imagem que estão disponíveis numa galeria comunitária usando a lista de definição de imagem az sig.

Neste exemplo, listamos todas as imagens na galeria ContosoImage no Oeste dos EUA e pelo nome, o ID único que é necessário para criar um estado VM, OS e OS.

 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

List as versões de imagem partilhadas numa galeria comunitária utilizando a lista de versão az sig:

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

Galerias partilhadas diretas

Importante

Azure Compute Gallery – galeria partilhada direta está atualmente em PREVIEW e sujeita aos Termos de Pré-Visualização da Galeria Azure Compute.

Para publicar imagens numa galeria partilhada direta durante a pré-visualização, tem de se registar em https://aka.ms/directsharedgallery-preview. A criação de VMs a partir de uma galeria partilhada direta está aberta a todos os utilizadores do Azure.

Durante a pré-visualização, você precisa criar uma nova galeria, com a propriedade sharingProfile.permissions definida para Groups. Quando utilizar o CLI para criar uma galeria, utilize o --permissions groups parâmetro. Não pode usar uma galeria existente, a propriedade não pode ser atualizada atualmente.

Para encontrar a uniqueID galeria que é partilhada consigo, use a lista az sig partilhada. Neste exemplo, procuramos galerias na região oeste dos EUA.

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

Enuse todas as definições de imagem que são partilhadas diretamente consigo, utilize a lista de definição de imagem az sig partilhada.

Neste exemplo, listamos todas as imagens na galeria no Oeste dos EUA e pelo nome, o ID único que é necessário para criar um estado VM, OS e SO.

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

Listar as versões de imagem partilhadas diretamente para você usando a lista de versão az sig partilhada:

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

Passos seguintes