Tworzenie definicji obrazu i wersji obrazu

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 portalu Azure, a następnie wyszukaj i wybierz Azure Galerię obliczeń.

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 Dodaj nową definicję obrazu do Galerii Obliczeniowej Azure, na karcie Podstawy, wybierz 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. Dla generacji VM wybierz opcję w oparciu o Twoje źródło. W większości przypadków będzie 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 Ogólne i wyspecjalizowane.

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

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

11. W polu SKU wpisz unikalną 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 nie widzisz swojego źródła na późniejszych listach rozwijanych, spróbuj zmienić region dla obrazu. Zawsze możesz później replikować obraz do innych regionów.

17. W polu Numer wersji wpisz liczbę, na przykład 1.0.0. Nazwa wersji obrazu powinna być zgodna z formatem major.minor.patch 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 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 wybrałeś w Szczegóły instancji.
    Wirtualny dysk twardy VHD na koncie magazynowym	Wybierz pozycję Przeglądaj, aby wybrać konto magazynu dla VHD.

19. W obszarze Wyklucz z najnowszej pozostaw wartość domyślną Nie, chyba że nie chcesz użyć tej wersji podczas tworzenia maszyny wirtualnej za pomocą 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ę Przegląd i utwórz. 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.

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

Aby utworzyć obraz przy użyciu Azure CLI, najpierw musisz utworzyć definicję obrazu. 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 masz uprościłeś maszynę wirtualną (przy użyciu waagent -deprovision dla systemu Linux lub Sysprep dla Windows), należy utworzyć uogólnioną definicję obrazu maszyny przy użyciu --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 --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

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.

Aby uzyskać szczegółowe przykłady, jak określić różne źródła dla swojego obrazu, zobacz przykłady polecenia az sig image-version create.

W poniższym przykładzie tworzymy obraz z maszyny wirtualnej. Wersja naszego obrazu to 1.0.0 i zamierzamy utworzyć 2 repliki w regionie West Central US, 1 replikę w regionie South Central US oraz 1 replikę w regionie East US 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 lub dezaktywacja maszyny wirtualnej przed utworzeniem obrazu.

Zastąp wartość w --virtual-machine 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 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Aby utworzyć obraz przy użyciu programu PowerShell, należy najpierw utworzyć definicję obrazu. Definicje obrazów tworzą logiczne grupowanie obrazów. Podczas tworzenia definicji obrazu upewnij się, że zawiera on wszystkie poprawne informacje. Jeśli uogólniłeś źródłową maszynę wirtualną, 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'

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.

W poniższym przykładzie tworzymy wersję obrazu z maszyny wirtualnej. Najlepiej zatrzymać oraz zdealokować maszynę wirtualną 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 Stanów Zjednoczonych Zachodnio-środkowych oraz Stanów Zjednoczonych Południowo-środkowych. 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

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 tworzymy wersję obrazu z maszyny wirtualnej. Aby użyć innego źródła, podaj identyfikator zasobu dla źródła (na przykład podaj 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}"
            }
        }
    }
}

Użyj Azure CLI, aby utworzyć wersję obrazu w jednej dzierżawie przy użyciu wersji obrazu źródłowego w innej dzierżawie.

# 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

Użyj programu PowerShell, aby utworzyć wersję obrazu w jednej dzierżawie przy użyciu wersji obrazu źródłowego w innej dzierżawie.

# 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