Tworzenie definicji obrazu i wersji obrazu

Uwaga

W tym artykule odwołuje się do systemu CentOS — dystrybucji systemu Linux, która jest stanem End Of Life (EOL). Rozważ odpowiednie użycie i zaplanuj. Aby uzyskać więcej informacji, zobacz wskazówki dotyczące zakończenia życia systemu CentOS.

Galeria zasobów obliczeniowych platformy Azure (wcześniej znana jako galeria obrazów udostępnionych) upraszcza udostępnianie obrazów niestandardowych w całej organizacji. Obrazy niestandardowe są podobne do obrazów z platformy handlowej, ale tworzy się je samodzielnie. Obrazy można tworzyć na podstawie maszyny wirtualnej, wirtualnego dysku twardego, migawki, obrazu zarządzanego lub innej wersji obrazu.

Galeria zasobów obliczeniowych platformy Azure umożliwia udostępnianie niestandardowych obrazów maszyn wirtualnych innym osobom w organizacji w obrębie lub w różnych regionach w ramach dzierżawy firmy Microsoft Entra lub publicznie przy użyciu galerii społeczności. Wybierz obrazy, które chcesz udostępnić, a w których regionach chcesz je udostępnić, oraz do kogo chcesz je udostępnić. Można utworzyć wiele galerii, aby można było logicznie grupować obrazy. Wiele nowych funkcji, takich jak ARM64, przyspieszona sieć i trustedVM, są obsługiwane tylko za pośrednictwem galerii obliczeń platformy Azure i nie są dostępne dla obrazów zarządzanych.

Funkcja galerii obliczeń platformy Azure ma wiele typów zasobów:

Zasób	opis
Źródło obrazu	Jest to zasób, którego można użyć do utworzenia wersji obrazu w galerii. Źródłem obrazu może być istniejąca maszyna wirtualna platformy Azure, która jest uogólniona lub wyspecjalizowana, obraz zarządzany, migawka lub wersja obrazu w innej galerii.
Galeria	Podobnie jak w witrynie Azure Marketplace, galeria to repozytorium do zarządzania obrazami i udostępnianiem obrazów i aplikacji maszyn wirtualnych, ale kontrolujesz, kto ma dostęp.
Definicja obrazu	Definicje obrazów są tworzone w galerii i zawierają informacje o obrazie i wymaganiach dotyczących korzystania z niego wewnętrznie. Obejmuje to, czy obraz jest windows, czy Linux, informacje o wersji oraz minimalne i maksymalne wymagania dotyczące pamięci. Jest to definicja typu obrazu.
Wersja obrazu	Wersja obrazu służy do tworzenia maszyny wirtualnej podczas korzystania z galerii. Możesz mieć wiele wersji obrazu zgodnie z potrzebami w danym środowisku. Podobnie jak w przypadku obrazu zarządzanego , gdy używasz wersji obrazu do utworzenia maszyny wirtualnej, wersja obrazu jest używana do tworzenia nowych dysków dla maszyny wirtualnej. Wersje obrazów mogą być używane wiele razy.

Zanim rozpoczniesz

Aby ukończyć ten artykuł, musisz mieć istniejącą galerię obliczeń platformy Azure i źródło obrazu dostępnego na platformie Azure. Źródła obrazów mogą być następujące:

• Maszyna wirtualna w ramach subskrypcji. Obraz można przechwycić zarówno z wyspecjalizowanych, jak i uogólnionych maszyn wirtualnych.
• Obraz zarządzany,
• Zarządzane dyski systemu operacyjnego i danych.
• Dyski systemu operacyjnego i danych jako dyski VHD na koncie magazynu.
• Inne wersje obrazów w tej samej galerii lub w innej galerii w tej samej subskrypcji.

Jeśli obraz będzie zawierać dyski danych, rozmiar dysku danych nie może przekraczać 1 TB.

Nazwy definicji obrazów mogą składać się z wielkich lub małych liter, cyfr, kropek, kreski i kropek. Aby uzyskać więcej informacji na temat wartości, które można określić dla definicji obrazu, zobacz Definicje obrazów.

Dozwolone znaki dla wersji obrazu to liczby i kropki. Liczby muszą należeć do zakresu 32-bitowej liczby całkowitej. Format: MajorVersion.Wersja pomocnicza.Stosowanie poprawek.

Podczas pracy z tym artykułem zastąp nazwy zasobów w razie potrzeby.

Aby uzyskać uogólnione obrazy, zobacz wskazówki dotyczące systemu operacyjnego przed przechwyceniem obrazu:

• Linux

  • Ogólne kroki
  • CentOS
  • Debian
  • Flatcar
  • FreeBSD
  • Oracle Linux
  • OpenBSD
  • Red Hat
  • SUSE
  • Ubuntu

• Windows

  Jeśli planujesz uruchomić program Sysprep przed przekazaniem wirtualnego dysku twardego (VHD) na platformę Azure po raz pierwszy, upewnij się, że maszyna wirtualna jest przygotowana.

Galeria społeczności

Jeśli będziesz udostępniać obrazy przy użyciu galerii społeczności, upewnij się, że tworzysz galerię, definicje obrazów i wersje obrazów w tym samym regionie.

Gdy użytkownicy wyszukują obrazy galerii społeczności, wyświetlana jest tylko najnowsza wersja obrazu.

Ważne

Informacje z definicji obrazów będą publicznie dostępne, podobnie jak informacje dotyczące publikowania, oferty i jednostki SKU.

Tworzenie obrazu

Wybierz poniżej opcję tworzenia definicji obrazu i wersji obrazu:

Portal

Aby utworzyć obraz na podstawie maszyny wirtualnej w portalu, zobacz Przechwytywanie obrazu maszyny wirtualnej.

Aby utworzyć obraz przy użyciu źródła innego niż maszyna wirtualna, wykonaj następujące kroki.

1. Przejdź do witryny Azure Portal, a następnie wyszukaj i wybierz pozycję Galeria obliczeń platformy Azure.

2. Wybierz galerię, której chcesz użyć z listy.

3. Na stronie galerii wybierz pozycję Dodaj w górnej części strony, a następnie z listy rozwijanej wybierz pozycję Definicja obrazu maszyny wirtualnej.

4. na stronie Dodawanie nowej definicji obrazu do galerii obliczeń platformy Azure na karcie Podstawy wybierz pozycję Region.

5. W polu Nazwa definicji obrazu wpisz nazwę, taką jak myImageDefinition.

6. W polu System operacyjny wybierz poprawną opcję na podstawie źródła.

7. W przypadku generowania maszyn wirtualnych wybierz opcję opartą na źródle. W większości przypadków będzie to gen 1. Aby uzyskać więcej informacji, zobacz Obsługa maszyn wirtualnych generacji 2.

8. W obszarze Stan systemu operacyjnego wybierz opcję opartą na źródle. Aby uzyskać więcej informacji, zobacz Uogólnione i wyspecjalizowane.

9. W polu Publisher wpisz unikatową nazwę, taką jak myPublisher.

10. W polu Oferta wpisz unikatową nazwę, taką jak myOffer.

11. W polu Jednostka SKU wpisz unikatową nazwę, taką jak mySKU.

12. W dolnej części strony wybierz pozycję Przejrzyj i utwórz.

13. Po zakończeniu walidacji definicji obrazu wybierz pozycję Utwórz.

14. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

15. Na stronie definicji obrazu na karcie Wprowadzenie wybierz pozycję Utwórz wersję.

16. W obszarze Region wybierz region, w którym chcesz utworzyć obraz. W niektórych przypadkach źródło musi znajdować się w tym samym regionie, w którym jest tworzony obraz. Jeśli źródło nie jest widoczne na liście rozwijanej w kolejnych listach rozwijanych, spróbuj zmienić region obrazu. Zawsze można replikować obraz do innych regionów później.

17. W polu Numer wersji wpisz liczbę, na przykład 1.0.0. Nazwa wersji obrazu powinna być zgodna z główną nazwą.drobne.format poprawki przy użyciu liczb całkowitych.

18. W obszarze Źródło wybierz typ pliku, którego używasz dla źródła z listy rozwijanej. Zapoznaj się z poniższą tabelą, aby uzyskać szczegółowe informacje dotyczące każdego typu źródła.

    Źródło	Inne pola
    Dyski lub migawki	— W przypadku dysku systemu operacyjnego wybierz dysk lub migawkę z listy rozwijanej. — Aby dodać dysk danych, wpisz numer JEDNOSTKI LUN, a następnie wybierz dysk danych z listy rozwijanej.
    Wersja obrazu	— Wybierz galerię źródłową z listy rozwijanej. — Wybierz poprawną definicję obrazu z listy rozwijanej. — Wybierz istniejącą wersję obrazu, której chcesz użyć z listy rozwijanej.
    Obraz zarządzany	Wybierz obraz źródłowy z listy rozwijanej. Obraz zarządzany musi znajdować się w tym samym regionie, który został wybrany w obszarze Szczegóły wystąpienia.
    Wirtualny dysk twardy na koncie magazynu	Wybierz pozycję Przeglądaj , aby wybrać konto magazynu dla wirtualnego dysku twardego.

19. W obszarze Wyklucz z najnowszej pozostaw wartość domyślną Nie , chyba że nie chcesz, aby ta wersja była używana podczas tworzenia maszyny wirtualnej przy użyciu latest zamiast numeru wersji.

20. W obszarze Data zakończenia życia wybierz datę z kalendarza, dla której uważasz, że ta wersja powinna przestać być używana.

21. Na karcie Replikacja wybierz typ magazynu z listy rozwijanej.

22. Ustaw domyślną liczbę replik, możesz zastąpić ją dla każdego dodanego regionu.

23. Musisz replikować do regionu źródłowego, więc pierwsza replika na liście będzie znajdować się w regionie, w którym utworzono obraz. Możesz dodać więcej replik, wybierając region z listy rozwijanej i dostosowując liczbę replik zgodnie z potrzebami.

24. Po zakończeniu wybierz pozycję Przejrzyj i utwórz. Platforma Azure zweryfikuje konfigurację.

25. Gdy wersja obrazu przejdzie walidację, wybierz pozycję Utwórz.

26. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

Replikacja obrazu do wszystkich regionów docelowych może zająć trochę czasu.

Istniejącą maszynę wirtualną można również przechwycić jako obraz z portalu. Aby uzyskać więcej informacji, zobacz Tworzenie obrazu maszyny wirtualnej w portalu.

Interfejs wiersza polecenia

Definicje obrazów tworzą logiczne grupowanie obrazów. Są one używane do zarządzania informacjami o wersjach obrazów, które są w nich tworzone.

Utwórz definicję obrazu w galerii przy użyciu polecenia az sig image-definition create. Upewnij się, że definicja obrazu jest właściwym typem. Jeśli uogólniono maszynę wirtualną (w systemie waagent -deprovision Linux lub Sysprep dla systemu Windows), należy utworzyć uogólnioną definicję obrazu przy użyciu polecenia --os-state generalized. Jeśli chcesz użyć maszyny wirtualnej bez usuwania istniejących kont użytkowników, utwórz wyspecjalizowaną definicję obrazu przy użyciu polecenia --os-state specialized.

Aby uzyskać więcej informacji na temat parametrów, które można określić dla definicji obrazu, zobacz Definicje obrazów.

W tym przykładzie definicja obrazu nosi nazwę myImageDefinition i jest przeznaczony dla wyspecjalizowanego obrazu systemu operacyjnego Linux. Aby utworzyć definicję obrazów przy użyciu systemu operacyjnego Windows, użyj polecenia --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

Uwaga

W przypadku definicji obrazów, które będą zawierać obrazy pochodzące z obrazów z witryny Marketplace innych firm, informacje o planie muszą być zgodne dokładnie z informacjami o planie z obrazu innej firmy. Uwzględnij informacje o planie w definicji obrazu, dodając --plan-namewartości , --plan-producti --plan-publisher podczas tworzenia definicji obrazu.

Tworzenie wersji obrazu

Utwórz wersję obrazu przy użyciu polecenia az sig image version create.

Składnia tworzenia obrazu zmieni się w zależności od tego, czego używasz jako źródła. Można mieszać typy źródłowe, o ile masz tylko jedno źródło systemu operacyjnego. Można również mieć różne źródła dla każdego dysku danych.

Źródło	Zestaw parametrów
Dysk systemu operacyjnego:
Maszyna wirtualna używająca identyfikatora maszyny wirtualnej	--managed-image <Resource ID of the VM>
Obraz zarządzany lub inna wersja obrazu	--managed-image <Resource ID of the managed image or image version
Migawka lub dysk zarządzany	--os-snapshot <Resource ID of the snapshot or managed disk>
Wirtualny dysk twardy na koncie magazynu	--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>.
Dysk danych:
Migawka lub dysk zarządzany	--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>
Wirtualny dysk twardy na koncie magazynu	--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>

Aby uzyskać szczegółowe przykłady sposobu określania różnych źródeł obrazu, zobacz przykłady polecenia az sig image-version create.

W poniższym przykładzie tworzysz obraz na podstawie maszyny wirtualnej. Wersja naszego obrazu to 1.0.0 i utworzymy 2 repliki w regionie Zachodnie środkowe stany USA, 1 replika w regionie Południowo-środkowe stany USA i 1 replika w regionie Wschodnie stany USA 2 przy użyciu magazynu strefowo nadmiarowego. Regiony replikacji muszą obejmować region, w którym znajduje się źródłowa maszyna wirtualna.

Najlepszym rozwiązaniem jest zatrzymanie\cofnięcie przydziału maszyny wirtualnej przed utworzeniem obrazu.

Zastąp wartość w --managed-image tym przykładzie identyfikatorem maszyny wirtualnej.

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"

Uwaga

Musisz poczekać, aż wersja obrazu zostanie całkowicie skompilowana i zreplikowana, zanim będzie można użyć tego samego obrazu zarządzanego, aby utworzyć inną wersję obrazu.

Obraz można również przechowywać w usłudze Premium Storage, dodając --storage-account-type premium_lrsmagazyn strefowo nadmiarowy , dodając --storage-account-type standard_zrs podczas tworzenia wersji obrazu.

Program PowerShell

Definicje obrazów tworzą logiczne grupowanie obrazów. Podczas tworzenia definicji obrazu upewnij się, że zawiera on wszystkie poprawne informacje. W przypadku uogólnionej źródłowej maszyny wirtualnej należy utworzyć definicję obrazu przy użyciu polecenia -OsState generalized. Jeśli źródło nie zostało uogólnione, utwórz definicję obrazu przy użyciu polecenia -OsState specialized.

Aby uzyskać więcej informacji na temat wartości, które można określić dla definicji obrazu, zobacz Definicje obrazów.

Utwórz definicję obrazu przy użyciu polecenia New-AzGalleryImageDefinition.

W tym przykładzie definicja obrazu nosi nazwę myImageDefinition i jest przeznaczony dla wyspecjalizowanej maszyny wirtualnej z systemem Windows. Aby utworzyć definicję obrazów przy użyciu systemu Linux, użyj polecenia -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'

Uwaga

W przypadku definicji obrazów, które będą zawierać obrazy pochodzące z obrazów innych firm, informacje o planie muszą być zgodne dokładnie z informacjami o planie z obrazu innej firmy. Uwzględnij informacje o planie w definicji obrazu, dodając -PurchasePlanNamewartości , -PurchasePlanProducti -PurchasePlanPublisher podczas tworzenia definicji obrazu.

Tworzenie wersji obrazu

Utwórz wersję obrazu przy użyciu polecenia New-AzGalleryImageVersion.

Składnia tworzenia obrazu zmieni się w zależności od tego, czego używasz jako źródła.

Źródło	Zestaw parametrów
Dysk systemu operacyjnego
Maszyna wirtualna używająca identyfikatora maszyny wirtualnej	-SourceImageId <Resource ID of the VM>
Obraz zarządzany lub inna wersja obrazu	-SourceImageId <Resource ID of the managed image or image version
Migawka lub dysk zarządzany	-OSDiskImage <Resource ID of the snapshot or managed disk>
Dysk danych
Migawka lub dysk zarządzany	-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }

W poniższym przykładzie tworzysz wersję obrazu na podstawie maszyny wirtualnej. Najlepszym rozwiązaniem jest zatrzymanie\cofnięcie przydziału maszyny wirtualnej przed utworzeniem obrazu przy użyciu polecenia Stop-AzVM.

W tym przykładzie wersja obrazu to 1.0.0 i jest replikowana do centrów danych Zachodnio-środkowe stany USA i Południowo-środkowe stany USA . Podczas wybierania regionów docelowych na potrzeby replikacji należy również uwzględnić region źródłowy jako element docelowy replikacji.

   $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 

Replikacja obrazu do wszystkich regionów docelowych może zająć trochę czasu, więc utworzyliśmy zadanie, abyśmy mogli śledzić postęp. Aby wyświetlić postęp zadania, wpisz $job.State.

$job.State

Uwaga

Musisz poczekać, aż wersja obrazu zostanie całkowicie skompilowana i zreplikowana, zanim będzie można użyć tego samego obrazu zarządzanego, aby utworzyć inną wersję obrazu.

Obraz można również przechowywać w usłudze Premium Storage, dodając -StorageAccountType Premium_LRSmagazyn strefowo nadmiarowy , dodając -StorageAccountType Standard_ZRS podczas tworzenia wersji obrazu.

REST

Tworzenie definicji obrazu przy użyciu interfejsu 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",
    },
}

Utwórz wersję obrazu przy użyciu interfejsu API REST. W tym przykładzie tworzysz wersję obrazu na podstawie maszyny wirtualnej. Aby użyć innego źródła, przekaż identyfikator zasobu dla źródła (na przykład przekaż identyfikator migawki dysku systemu operacyjnego).

# @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}"
            }
        }
    }
}

Tworzenie obrazu w jednej dzierżawie przy użyciu obrazu źródłowego w innej dzierżawie

W subskrypcji, w której istnieje obraz źródłowy, przyznaj użytkownikowi uprawnienia czytelnika. Gdy użytkownik ma uprawnienie czytelnika do obrazu źródłowego, zaloguj się do obu kont (źródło i element docelowy).

Potrzebny tenantID będzie obraz źródłowy, subskrypcja, subscriptionID w której będzie przechowywany nowy obraz (element docelowy) i resourceID obraz źródłowy. Ponadto należy upewnić się, że region lub replika obrazu źródłowego i region docelowy są takie same.

Interfejs wiersza polecenia

# 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
   --location myLocation

Program PowerShell

# 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

Następne kroki

Aby uzyskać informacje o sposobie dostarczania informacji o planie zakupu, zobacz Dostarczanie informacji o planie zakupu w witrynie Azure Marketplace podczas tworzenia obrazów.