Znajdowanie informacji o obrazie witryny Azure Marketplace przy użyciu interfejsu wiersza polecenia platformy Azure

Uwaga

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

Dotyczy: ✔️ Maszyny wirtualne z systemem Linux Maszyny wirtualne z systemem Windows — elastyczne zestawy ✔️ ✔️ skalowania

W tym temacie opisano, jak używać interfejsu wiersza polecenia platformy Azure do znajdowania obrazów maszyn wirtualnych w witrynie Azure Marketplace. Te informacje umożliwiają określenie obrazu witryny Marketplace podczas programowego tworzenia maszyny wirtualnej przy użyciu interfejsu wiersza polecenia, szablonów usługi Resource Manager lub innych narzędzi.

Możesz również przeglądać dostępne obrazy i oferty przy użyciu witryny Azure Marketplace lub programu Azure PowerShell.

Terminologia

Obraz witryny Marketplace na platformie Azure ma następujące atrybuty:

  • Wydawca: organizacja, która utworzyła obraz. Przykłady: Canonical, RedHat, SUSE.
  • Oferta: nazwa grupy powiązanych obrazów utworzonych przez wydawcę. Przykłady: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
  • Jednostka SKU: wystąpienie oferty, takie jak główna wersja dystrybucji. Przykłady: 22_04-lts-gen2, 8-lvm-gen2, gen2.
  • Wersja: numer wersji jednostki SKU obrazu.

Te wartości można przekazać pojedynczo lub jako nazwę URN obrazu, łącząc wartości rozdzielone dwukropkiem (:). Na przykład: Publisher:Offer:Sku:Version. Numer wersji w identyfikatorze URN latest można zastąpić, aby użyć najnowszej wersji obrazu.

Jeśli wydawca obrazów udostępnia dodatkową licencję i postanowienia zakupu, musisz zaakceptować te warunki, zanim będzie można użyć obrazu. Aby uzyskać więcej informacji, zobacz Sprawdzanie informacji o planie zakupu.

Możesz uruchomić polecenie az vm image list --all , aby wyświetlić wszystkie dostępne obrazy, ale tworzenie całej listy może potrwać kilka minut. Szybszą opcją jest użycie elementu az vm image listbez --all opcji , aby wyświetlić listę popularnych obrazów maszyn wirtualnych w witrynie Azure Marketplace. Na przykład uruchom następujące polecenie, aby wyświetlić w pamięci podręcznej listę popularnych obrazów w formacie tabeli:

az vm image list --output table

Dane wyjściowe zawierają adres URL obrazu. Jeśli pominięto --all tę opcję, możesz zobaczyć wartości UrnAlias dla każdego obrazu, jeśli są dostępne. UrnAlias to skrócona wersja utworzona dla popularnych obrazów, takich jak Ubuntu2204. Nazwy aliasów obrazów systemu Linux i ich szczegóły wyjściowe w tym poleceniu to:

Architecture    Offer                         Publisher               Sku                                 Urn                                                                             UrnAlias                 Version
--------------  ----------------------------  ----------------------  ----------------------------------  ------------------------------------------------------------------------------  -----------------------  ---------
x64             CentOS                        OpenLogic               8_5-gen2                            OpenLogic:CentOS:8_5-gen2:latest                                                CentOS85Gen2             latest
x64             Debian11                      Debian                  11-backports-gen2                   Debian:debian-11:11-backports-gen2:latest                                       Debian-11                latest
x64             flatcar-container-linux-free  kinvolk                 stable-gen2                         kinvolk:flatcar-container-linux-free:stable-gen2:latest                         FlatcarLinuxFreeGen2     latest
x64             opensuse-leap-15-4            SUSE                    gen2                                SUSE:opensuse-leap-15-4:gen2:latest                                             OpenSuseLeap154Gen2      latest
x64             RHEL                          RedHat                  8-lvm-gen2                          RedHat:RHEL:8-lvm-gen2:latest                                                   RHELRaw8LVMGen2          latest
x64             sles-15-sp3                   SUSE                    gen2                                SUSE:sles-15-sp3:gen2:latest                                                    SLES                     latest
x64             0001-com-ubuntu-server-jammy  Canonical               22_04-lts-gen2                      Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest                    Ubuntu2204               latest

Nazwy aliasów obrazu systemu Windows i ich szczegóły wyjściowe w tym poleceniu są następujące:

Architecture    Offer                         Publisher               Sku                                 Urn                                                                            Alias                    Version
--------------  ----------------------------  ----------------------  ----------------------------------  ------------------------------------------------------------------------------ -----------------------  ---------
x64             WindowsServer                 MicrosoftWindowsServer  2022-Datacenter                     MicrosoftWindowsServer:WindowsServer:2022-Datacenter:latest                    Win2022Datacenter         latest
x64             WindowsServer                 MicrosoftWindowsServer  2022-datacenter-azure-edition-core  MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest Win2022AzureEditionCore   latest
x64             WindowsServer                 MicrosoftWindowsServer  2019-Datacenter                     MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest                    Win2019Datacenter         latest
x64             WindowsServer                 MicrosoftWindowsServer  2016-Datacenter                     MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest                    Win2016Datacenter         latest
x64             WindowsServer                 MicrosoftWindowsServer  2012-R2-Datacenter                  MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest                 Win2012R2Datacenter       latest
x64             WindowsServer                 MicrosoftWindowsServer  2012-Datacenter                     MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest                    Win2012Datacenter         latest

Znajdowanie określonych obrazów

Listę obrazów można filtrować według --publisher lub innego parametru, aby ograniczyć wyniki.

Na przykład następujące polecenie wyświetla wszystkie oferty Debiana:

az vm image list --offer Debian --all --output table

Wyniki można ograniczyć do pojedynczej architektury, dodając --architecture parametr . Aby na przykład wyświetlić wszystkie obrazy Arm64 dostępne w witrynie Canonical:

az vm image list --architecture Arm64 --publisher Canonical --all --output table

Przyjrzyj się wszystkim dostępnym obrazom

Innym sposobem znalezienia obrazu w lokalizacji jest uruchomienie poleceń az vm image list-publishers, az vm image list-offers i az vm image list-skus w sekwencji. Za pomocą tych poleceń można określić następujące wartości:

  1. Wyświetl listę wydawców obrazów dla lokalizacji. W tym przykładzie przyjrzymy się regionowi Zachodnie stany USA .

    az vm image list-publishers --location westus --output table
    
  2. Dla danego wydawcy wyświetl listę ofert. W tym przykładzie dodamy narzędzie RedHat jako wydawcę.

    az vm image list-offers --location westus --publisher RedHat --output table
    
  3. Dla danej oferty wyświetl listę wersji SKU. W tym przykładzie dodamy RHEL jako ofertę.

    az vm image list-skus --location westus --publisher RedHat --offer RHEL --output table
    

Uwaga

Firma Canonical zmieniła nazwy ofert , których używają dla najnowszych wersji. Przed systemem Ubuntu 20.04 nazwa oferty to UbuntuServer. W systemie Ubuntu 20.04 nazwa oferty to 0001-com-ubuntu-server-focal i dla systemu Ubuntu 22.04 to 0001-com-ubuntu-server-jammy.

  1. W przypadku danego wydawcy, oferty i jednostki SKU pokaż wszystkie wersje obrazu. W tym przykładzie dodamy wartość 9_1 jako jednostkę SKU.

    az vm image list \
        --location westus \
        --publisher RedHat \
        --offer RHEL \
        --sku 9_1 \
        --all --output table
    

Przekaż tę wartość kolumny URN za pomocą parametru --image podczas tworzenia maszyny wirtualnej za pomocą polecenia az vm create . Możesz również zastąpić numer wersji w identyfikatorze URN ciągiem "latest", aby użyć najnowszej wersji obrazu.

W przypadku wdrażania maszyny wirtualnej przy użyciu szablonu usługi Resource Manager należy ustawić parametry obrazu indywidualnie we właściwościach imageReference . Zobacz dokumentację szablonu.

Sprawdzanie informacji o planie zakupu

Niektóre obrazy maszyn wirtualnych w witrynie Azure Marketplace mają dodatkową licencję i postanowienia zakupu, które należy zaakceptować, zanim będzie można je wdrożyć programowo.

Aby wdrożyć maszynę wirtualną na podstawie takiego obrazu, musisz zaakceptować warunki obrazu przy pierwszym użyciu, raz na subskrypcję. Należy również określić parametry planu zakupu, aby wdrożyć maszynę wirtualną z tego obrazu

Aby wyświetlić informacje o planie zakupu obrazu, uruchom polecenie az vm image show z identyfikatorem URI obrazu. plan Jeśli właściwość w danych wyjściowych nie nulljest , obraz zawiera terminy, które należy zaakceptować przed wdrożeniem programowym.

Na przykład obraz Canonical Ubuntu Server 18.04 LTS nie ma dodatkowych terminów, ponieważ plan informacje są następujące null:

az vm image show --location westus --urn Canonical:UbuntuServer:18.04-LTS:latest

Dane wyjściowe:

{
  "dataDiskImages": [],
  "id": "/Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/Canonical/ArtifactTypes/VMImage/Offers/UbuntuServer/Skus/18.04-LTS/Versions/18.04.201901220",
  "location": "westus",
  "name": "18.04.201901220",
  "osDiskImage": {
    "operatingSystem": "Linux"
  },
  "plan": null,
  "tags": null
}

Uruchomienie podobnego polecenia dla obrazu RabbitMQ Certified by Bitnami przedstawia następujące plan właściwości: name, producti publisher. (Niektóre obrazy mają promotion code również właściwość ).

az vm image show --location westus --urn bitnami:rabbitmq:rabbitmq:latest

Dane wyjściowe:

{
  "dataDiskImages": [],
  "id": "/Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/bitnami/ArtifactTypes/VMImage/Offers/rabbitmq/Skus/rabbitmq/Versions/3.7.1901151016",
  "location": "westus",
  "name": "3.7.1901151016",
  "osDiskImage": {
    "operatingSystem": "Linux"
  },
  "plan": {
    "name": "rabbitmq",
    "product": "rabbitmq",
    "publisher": "bitnami"
  },
  "tags": null
}

Aby wdrożyć ten obraz, musisz zaakceptować warunki i podać parametry planu zakupu podczas wdrażania maszyny wirtualnej przy użyciu tego obrazu.

Zaakceptuj warunki

Aby wyświetlić i zaakceptować postanowienia licencyjne, użyj polecenia az vm image terms . Po zaakceptowaniu warunków włączysz wdrażanie programowe w ramach subskrypcji. Musisz zaakceptować warunki tylko raz na subskrypcję dla obrazu. Na przykład:

az vm image terms show --urn bitnami:rabbitmq:rabbitmq:latest

Dane wyjściowe zawierają wartość licenseTextLink do postanowień licencyjnych i wskazują, że wartość accepted to true:

{
  "accepted": true,
  "additionalProperties": {},
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.MarketplaceOrdering/offertypes/bitnami/offers/rabbitmq/plans/rabbitmq",
  "licenseTextLink": "https://storelegalterms.blob.core.windows.net/legalterms/3E5ED_legalterms_BITNAMI%253a24RABBITMQ%253a24RABBITMQ%253a24IGRT7HHPIFOBV3IQYJHEN2O2FGUVXXZ3WUYIMEIVF3KCUNJ7GTVXNNM23I567GBMNDWRFOY4WXJPN5PUYXNKB2QLAKCHP4IE5GO3B2I.txt",
  "name": "rabbitmq",
  "plan": "rabbitmq",
  "privacyPolicyLink": "https://bitnami.com/privacy",
  "product": "rabbitmq",
  "publisher": "bitnami",
  "retrieveDatetime": "2019-01-25T20:37:49.937096Z",
  "signature": "XXXXXXLAZIK7ZL2YRV5JYQXONPV76NQJW3FKMKDZYCRGXZYVDGX6BVY45JO3BXVMNA2COBOEYG2NO76ONORU7ITTRHGZDYNJNXXXXXX",
  "type": "Microsoft.MarketplaceOrdering/offertypes"
}

Aby zaakceptować warunki, wpisz:

az vm image terms accept --urn bitnami:rabbitmq:rabbitmq:latest

Wdrażanie nowej maszyny wirtualnej przy użyciu parametrów obrazu

Korzystając z informacji o obrazie, można wdrożyć go za pomocą az vm create polecenia .

Aby wdrożyć obraz, który nie zawiera informacji o planie, na przykład najnowszy obraz systemu Ubuntu Server 18.04 z witryny Canonical, przekaż identyfikator URI dla elementu --image:

az group create --name myURNVM --location westus
az vm create \
   --resource-group myURNVM \
   --name myVM \
   --admin-username azureuser \
   --generate-ssh-keys \
   --image Canonical:UbuntuServer:18.04-LTS:latest

W przypadku obrazu z parametrami planu zakupu, takimi jak obraz RabbitMQ Certified by Bitnami, przekazujesz identyfikator URIN, --image a także podaj parametry planu zakupu:

az group create --name myPurchasePlanRG --location westus

az vm create \
   --resource-group myPurchasePlanRG \
   --name myVM \
   --admin-username azureuser \
   --generate-ssh-keys \
   --image bitnami:rabbitmq:rabbitmq:latest \
   --plan-name rabbitmq \
   --plan-product rabbitmq \
   --plan-publisher bitnami

Jeśli otrzymasz komunikat o zaakceptowaniu warunków obrazu, zapoznaj się z sekcją Zaakceptuj warunki. Upewnij się, że dane wyjściowe az vm image accept-terms zwraca wartość "accepted": true, pokazującą, że zaakceptowano warunki obrazu.

Używanie istniejącego wirtualnego dysku twardego z informacjami o planie zakupu

Jeśli masz istniejący wirtualny dysk twardy z maszyny wirtualnej utworzonej przy użyciu płatnego obrazu witryny Azure Marketplace, może być konieczne podanie informacji o planie zakupu podczas tworzenia nowej maszyny wirtualnej na podstawie tego wirtualnego dysku twardego.

Jeśli nadal masz oryginalną maszynę wirtualną lub inną maszynę wirtualną utworzoną przy użyciu tego samego obrazu z witryny Marketplace, możesz uzyskać z niej informacje o planie, wydawcy i produkcie przy użyciu polecenia az vm get-instance-view. Ten przykład pobiera maszynę wirtualną o nazwie myVM w grupie zasobów myResourceGroup , a następnie wyświetla informacje o planie zakupu.

az vm get-instance-view -g myResourceGroup -n myVM --query plan

Jeśli nie otrzymasz informacji o planie przed usunięciem oryginalnej maszyny wirtualnej, możesz zgłosić wniosek o pomoc techniczną. Będą potrzebować nazwy maszyny wirtualnej, identyfikatora subskrypcji i sygnatury czasowej operacji usuwania.

Po utworzeniu informacji o planie możesz utworzyć nową maszynę wirtualną przy użyciu parametru --attach-os-disk w celu określenia dysku VHD.

az vm create \
  --resource-group myResourceGroup \
  --name myNewVM \
  --nics myNic \
  --size Standard_DS1_v2 --os-type Linux \
  --attach-os-disk myVHD \
  --plan-name planName \
  --plan-publisher planPublisher \
  --plan-product planProduct

Następne kroki

Aby szybko utworzyć maszynę wirtualną przy użyciu informacji o obrazie, zobacz Tworzenie maszyn wirtualnych z systemem Linux i zarządzanie nimi przy użyciu interfejsu wiersza polecenia platformy Azure.