Suchen nach Azure Marketplace-Imageinformationen mithilfe der Azure CLI

Achtung

Dieser Artikel bezieht sich auf CentOS, eine Linux-Distribution, die sich dem End-of-Life-Status (EOL) nähert. Sie sollten Ihre Nutzung entsprechend planen. Weitere Informationen finden Sie im CentOS End-of-Life-Leitfaden.

Gilt für: ✔️ Linux-VMs ✔️ Windows-VMs ✔️ Flexible Skalierungsgruppen

Dieses Thema beschreibt, wie Sie mit der Azure-Befehlszeilenschnittstelle im Azure Marketplace nach VM-Images suchen. Verwenden Sie diese Informationen, um ein Marketplace-Image anzugeben, wenn Sie einen virtuellen Computer programmgesteuert mit der Befehlszeilenschnittstelle, mit Resource Manager-Vorlagen oder anderen Tools erstellen.

Sie können verfügbare Images und Angebote auch über den Azure Marketplace oder Azure PowerShell durchsuchen.

Begriff

Ein Marketplace-Image in Azure hat die folgenden Attribute:

  • Publisher (Herausgeber): Die Organisation, die das Image erstellt hat. Beispiele: Canonical, RedHat, SUSE.
  • Offer (Angebot): Der Name einer Gruppe verwandter Images, die von einem Herausgeber erstellt wurden. Beispiele: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
  • SKU: Eine Instanz eines Angebots, etwa eine Hauptversion einer Distribution. Beispiele: 22_04-lts-gen2, 8-lvm-gen2, gen2.
  • Version: Die Versionsnummer einer Image-SKU.

Diese Werte können einzeln oder als Image-URN übergeben werden, wobei die Werte durch den Doppelpunkt (:) getrennt kombiniert werden. Beispiel: Herausgeber:Angebot:SKU:Version. Sie können die Versionsnummer im URN durch latest ersetzen, um die neueste Version des Images zu verwenden.

Wenn der Imageherausgeber zusätzliche Lizenz- und Kaufbedingungen angibt, müssen Sie diese akzeptieren, bevor Sie das Image verwenden können. Weitere Informationen finden Sie unter Überprüfen der Erwerbsplaninformationen.

Sie können den Befehl az vm image list --all ausführen, um alle verfügbaren Images einzusehen, aber das Erstellen der gesamten Liste kann einige Minuten dauern. Eine schnellere Möglichkeit ist die Verwendung von az vm image list ohne die Option --all, um eine Liste beliebter VM-Images in Azure Marketplace anzuzeigen. Führen Sie beispielsweise den folgenden Befehl aus, um eine zwischengespeicherte Liste beliebter Images im Tabellenformat anzuzeigen:

az vm image list --output table

Die Ausgabe enthält den Image-URN. Wenn Sie die Option --all weglassen, wird UrnAlias für jedes Bild angezeigt, sofern verfügbar. UrnAlias ist eine verkürzte Version, die für beliebte Images wie Ubuntu2204 erstellt wurde. Die Linux-Image-Aliasnamen und ihre Details, die von diesem Befehl ausgegeben werden, sind:

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

Die Windows-Image-Aliasnamen und ihre Details, die von diesem Befehl ausgegeben werden, sind:

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

Suchen nach bestimmten Images

Sie können die Liste der Images nach --publisher oder einem anderen Parameter filtern, um die Ergebnisse einzuschränken.

Der folgende Befehl zeigt beispielsweise alle Debian-Angebote an:

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

Sie können Ihre Ergebnisse auf eine einzelne Architektur beschränken, indem Sie den --architecture-Parameter hinzufügen. So zeigen Sie beispielsweise alle Arm64-Bilder an, die von Canonical verfügbar sind:

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

Betrachten Sie alle verfügbaren Images.

Eine weitere Möglichkeit für die Suche nach einem Image an einem Standort besteht darin, die Befehle az vm image list-publishers, az vm image list-offers und az vm image list-skus nacheinander auszuführen. Mit diesen Befehlen ermitteln Sie folgende Werte:

  1. Listet die Imageherausgeber für einen Standort auf. In diesem Beispiel betrachten wir die Region USA, Westen.

    az vm image list-publishers --location westus --output table
    
  2. Auflistung der Angebote eines bestimmten Anbieters In diesem Beispiel fügen wir RedHat als Herausgeber hinzu.

    az vm image list-offers --location westus --publisher RedHat --output table
    
  3. Auflistung der SKUs eines bestimmten Angebots In diesem Beispiel fügen wir RHEL als Angebot hinzu.

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

Hinweis

Canonical hat die Angebotsnamen geändert, die sie für die neuesten Versionen verwenden. Vor Ubuntu 20.04 lautet der Angebotsname „UbuntuServer“. Für Ubuntu 20.04 lautet der Angebotsname0001-com-ubuntu-server-focal, und für Ubuntu 22.04 lautet er 0001-com-ubuntu-server-jammy.

  1. Zeigen Sie für einen bestimmten Herausgeber, ein bestimmtes Angebot und eine bestimmte SKU alle Versionen des Images an. In diesem Beispiel fügen wir 9_1 als SKU hinzu.

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

Übergeben Sie diesen Wert der URN-Spalte mit dem Parameter --image, wenn Sie einen virtuellen Computer mit dem Befehl az vm create erstellen. Sie können auch die Versionsnummer im URN durch „latest“ ersetzen, um die aktuelle Version des Images zu verwenden.

Wenn Sie einen virtuellen Computer mithilfe einer Resource Manager-Vorlage bereitstellen, legen Sie die Imageparameter einzeln in den imageReference-Eigenschaften fest. Informationen finden Sie in der Vorlagenreferenz.

Überprüfen der Informationen zum Erwerbsplan

Für einige VM-Images im Azure Marketplace gelten zusätzliche Lizenz- und Kaufbedingungen, die Sie akzeptieren müssen, bevor Sie sie programmgesteuert bereitstellen können.

Wenn Sie einen virtuellen Computer aus einem solchen Image bereitstellen möchten, müssen Sie die Bedingungen des Images bei der ersten Verwendung übernehmen, einmal pro Abonnement. Sie müssen auch Parameter für den Erwerbsplan angeben, um einen virtuellen Computer aus diesem Image bereitzustellen.

Um die Erwerbsplaninformationen eines Images anzuzeigen, führen Sie den Befehl az vm image show mit dem Image-URN aus. Wenn die plan-Eigenschaft in der Ausgabe nicht null ist, sind für das Image Bedingungen festgelegt, die Sie vor der programmgesteuerten Bereitstellung akzeptieren müssen.

Das Image „Canonical Ubuntu Server 18.04 LTS“ verfügt beispielsweise nicht über zusätzliche Bedingungen, da null für plan angegeben ist:

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

Ausgabe:

{
  "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
}

Wenn Sie einen ähnlichen Befehl für das von Bitnami zertifizierte RabbitMQ-Image ausführen, werden die folgenden plan-Eigenschaften angezeigt: name, product und publisher. (Einige Images besitzen auch eine promotion code-Eigenschaft.)

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

Ausgabe:

{
  "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
}

Zum Bereitstellen dieses Images müssen Sie die Bedingungen akzeptieren und die Erwerbsplanparameter angeben, wenn Sie einen virtuellen Computer mit diesem Image bereitstellen.

Akzeptieren der Bedingungen

Verwenden Sie zum Anzeigen und Akzeptieren der Lizenzbedingungen den Befehl az vm image terms. Wenn Sie die Bedingungen akzeptieren, ermöglichen Sie die programmgesteuerte Bereitstellung in Ihrem Abonnement. Sie müssen für das Image die Bedingungen nur einmal pro Abonnement akzeptieren. Beispiel:

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

Die Ausgabe enthält ein licenseTextLink-Element für die Lizenzbedingungen und gibt an, dass für accepted der Wert true angegeben ist:

{
  "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"
}

Geben Sie Folgendes ein, um die Bedingungen zu akzeptieren:

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

Bereitstellen eines neuen virtuellen Computers unter Verwendung der Imageparameter

Mithilfe der Informationen zum Image können Sie es mit dem Befehl az vm create bereitstellen.

Zum Bereitstellen eines Images, das keine Planinformationen enthält, wie das neueste Ubuntu Server 18.04-Image von Canonical, übergeben Sie den URN für --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

Für ein Image mit Erwerbsplanparametern, wie das Image „RabbitMQ Certified by Bitnami“, übergeben Sie den URN für --image und geben auch die Erwerbsplanparameter an:

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

Wenn Sie eine Meldung zum Akzeptieren der Nutzungsbedingungen des Images erhalten, überprüfen Sie den Abschnitt Akzeptieren der Nutzungsbedingungen. Stellen Sie sicher, dass die Ausgabe von az vm image accept-terms den Wert "accepted": true, zurückgibt, der anzeigt, dass Sie die Bedingungen des Images akzeptiert haben.

Verwenden einer vorhandenen VHD mit Erwerbsplaninformationen

Wenn eine Ihrer virtuellen Festplatten eines virtuellen Computers mit einem kostenpflichtigen Azure Marketplace-Image erstellt wurde, müssen Sie beim Erstellen einer neuen VM auf der Grundlage dieser VHD möglicherweise die Informationen zu Ihrem Erwerbsplan angeben.

Wenn Sie noch über die ursprüngliche VM oder eine andere VM verfügen, die mit demselben Marketplace-Image erstellt wurde, können Sie den Plannamen, den Herausgeber und die Produktinformationen mithilfe von az vm get-instance-view abrufen. Dieses Beispiel ruft eine VM namens myVM in der Ressourcengruppe myResourceGroup ab und zeigt dann die Erwerbsplaninformationen an.

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

Wenn Sie die Planinformationen nicht vor dem Löschen der ursprünglichen VM abgerufen haben, können Sie eine Supportanfrage erstellen. Sie benötigen dazu den VM-Namen, die Abonnement-ID und den Zeitstempel des Löschvorgangs.

Wenn Sie die Planinformationen haben, können Sie die neue VM erstellen, indem Sie die VHD mit dem Parameter --attach-os-disk angeben.

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

Nächste Schritte

Um schnell mithilfe der Imageinformationen einen virtuellen Computer zu erstellen, lesen Sie die Informationen unter Erstellen und Verwalten virtueller Linux-Computer mit der Azure-Befehlszeilenschnittstelle.