Bagikan melalui

Mencantumkan, memperbarui, dan menghapus sumber daya galeri

  • Artikel

Anda dapat mengelola sumber daya Azure Compute Gallery (sebelumnya dikenal sebagai Shared Image Gallery) menggunakan CLI Azure atau Azure PowerShell.

Daftar galeri yang dibagikan dengan Anda

Daftar Galeri yang dibagikan dengan langganan Anda.

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

Daftar Galeri yang dibagikan dengan penyewa Anda.

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

Output akan berisi name dan uniqueID publik dari galeri yang dibagikan dengan Anda. Anda dapat menggunakan nama galeri untuk menanyakan gambar yang tersedia melalui galeri.

Berikut adalah contoh output:

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

Perbarui sumber daya

Ada beberapa batasan mengenai apa yang dapat diperbarui. Item berikut yang dapat diperbarui:

Azure Compute Gallery:

  • Deskripsi

Definisi gambar:

  • vCPU yang direkomendasikan
  • Memori yang direkomendasikan
  • Deskripsi
  • Tanggal akhir masa pakai

Versi gambar:

  • Jumlah replika wilayah
  • Wilayah target
  • Pengecualian dari yang terbaru
  • Tanggal akhir masa pakai

Perbarui deskripsi galeri menggunakan (perbaruan az sig.

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

Perbarui deskripsi definisi gambar menggunakan pembaruan definisi gambar az sig.

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

Perbarui versi gambar untuk menambahkan wilayah untuk direplikasi menggunakan pembaruan versi gambar az sig. Perubahan ini akan memakan waktu cukup lama karena gambar akan direplikasi ke wilayah baru.

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

Contoh ini menunjukkan cara menggunakan memperbarui versi gambar az sig untuk mengecualikan versi gambar ini agar digunakan sebagai gambar terbaru.

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

Contoh ini menunjukkan cara menggunakan pembaruan versi gambar az sig untuk menyertakan versi gambar ini untuk dipertimbangkan sebagai gambar terbaru.

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

Menghapus sumber daya

Anda harus menghapus sumber daya dalam urutan terbalik dengan menghapus versi gambar terlebih dahulu. Setelah menghapus semua versi gambar, Anda dapat menghapus definisi gambar. Setelah menghapus semua definisi gambar, Anda dapat menghapus galeri.

Sebelum dapat menghapus galeri bersama komunitas, Anda perlu menggunakan az sig share reset untuk berhenti berbagi galeri secara publik.

Hapus versi gambar menggunakan hapus versi gambar az sig.

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

Hapus definisi gambar menggunakan hapus definisi gambar az ig.

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

Hapus galeri menggunakan az sig delete.

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

Galeri komunitas

Penting

Azure Compute Gallery – galeri komunitas saat ini dalam PRATINJAU dan tunduk pada Ketentuan Pratinjau untuk Azure Compute Gallery - galeri komunitas.

Untuk menerbitkan galeri komunitas, Anda harus menyiapkan fitur pratinjau di langganan Azure Anda. Membuat VM dari gambar galeri komunitas terbuka untuk semua pengguna Azure.

Untuk mencantumkan galeri Anda sendiri, dan mengeluarkan nama publik untuk galeri komunitas Anda:

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

Catatan

Sebagai pengguna akhir, untuk mendapatkan nama publik galeri komunitas, Anda saat ini perlu menggunakan portal. Buka Mesin virtual>Buat>Mesin virtual Azure>Citra>Lihat semua citra>Citra Komunitas>Nama galeri publik.

Cantumkan semua definisi citra yang tersedia di galeri komunitas menggunakan az sig image-definition list-community.

Dalam contoh ini, kami mencantumkan semua citra di galeri ContosoImage di US Barat dan berdasarkan nama, ID unik yang diperlukan untuk membuat VM, OS, dan status 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

Cantumkan versi citra yang dibagikan di galeri komunitas menggunakan 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

Galeri bersama langsung

Penting

Azure Compute Gallery – galeri berbagi langsung saat ini dalam PREVIEW dan digunakan pada Ketentuan Pratinjau untuk Azure Compute Gallery.

Untuk menerbitkan gambar ke galeri bersama langsung selama pratinjau, Anda harus mendaftar di https://aka.ms/directsharedgallery-preview. Membuat mesin virtual dari galeri bersama langsung terbuka untuk semua pengguna Azure.

Selama pratinjau, Anda perlu membuat galeri baru, dengan properti sharingProfile.permissions diatur ke Groups. Saat menggunakan CLI untuk membuat galeri, gunakan parameter --permissions groups. Anda tidak dapat menggunakan galeri yang ada, properti saat ini tidak dapat diperbarui.

Untuk menemukan uniqueID galeri yang dibagikan dengan Anda, gunakan az sig list-shared. Dalam contoh ini, kita mencari galeri di wilayah AS Barat.

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

Cantumkan daftar semua definisi gambar yang dibagikan langsung dengan Anda, gunakan az sig image-definition list-shared.

Dalam contoh ini, kami mencantumkan semua gambar di galeri di US Barat dan berdasarkan nama, ID unik yang diperlukan untuk membuat status mesin virtual, OS, dan OS.

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

Cantumkan versi gambar yang dibagikan langsung kepada Anda menggunakan 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

Langkah berikutnya