Suchen nach Azure Marketplace-Imageinformationen mithilfe der Azure CLI
Achtung
Dieser Artikel bezieht sich auf CentOS, eine Linux-Distribution, deren Dienstende (End-of-Life, EOL) ansteht. 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.
Liste von beliebten Images
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-azure-edition MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition:latest Win2022AzureEdition 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:
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 tableAuflistung 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 tableAuflistung 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.
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 terms accept 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.