Trovare informazioni sull'immagine di Azure Marketplace usando l'interfaccia della riga di comando di Azure
Attenzione
Questo articolo fa riferimento a CentOS, una distribuzione Linux prossima allo stato EOL (End of Life, fine del ciclo di vita). Prendere in considerazione l'uso e il piano di conseguenza. Per altre informazioni, vedere le linee guida per la fine della vita di CentOS.
Si applica a: ✔️ macchine virtuali Linux ✔️ macchine virtuali Windows ✔️ set di scalabilità flessibili
Questo argomento descrive come usare l'interfaccia della riga di comando di Azure per trovare immagini di macchine virtuali in Azure Marketplace. Usare queste informazioni per specificare un'immagine del Marketplace quando si crea una macchina virtuale a livello di codice mediante l'interfaccia della riga di comando, modelli di Resource Manager o altri strumenti.
È anche possibile esplorare le immagini e le offerte disponibili usando Azure Marketplace o Azure PowerShell.
Terminologia
Un'immagine del Marketplace in Azure ha gli attributi seguenti:
- Editore: organizzazione che ha creato l'immagine. Esempi: Canonical, RedHat, SU edizione Standard.
- Offerta: nome di un gruppo di immagini correlate create da un editore. Esempi: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
- SKU: istanza di un'offerta, ad esempio una versione principale di una distribuzione. Esempi: 22_04-lts-gen2, 8-lvm-gen2, gen2.
- Versione: numero di versione di uno SKU immagine.
Questi valori possono essere passati singolarmente o come URN immagine, combinando i valori separati dai due punti (:). Ad esempio: Publisher:Offer:Sku:Version. È possibile sostituire il numero di versione nell'URN con latest per usare la versione più recente dell'immagine.
Se l'editore di immagini fornisce condizioni di licenza e acquisto aggiuntive, è necessario accettare tali condizioni prima di poter usare l'immagine. Per altre informazioni, vedere Controllare le informazioni sul piano di acquisto.
Elencare immagini popolari
È possibile eseguire az vm image list --all per visualizzare tutte le immagini disponibili, ma possono essere necessari alcuni minuti per produrre l'intero elenco. Un'opzione più rapida è l'uso az vm image listdi , senza l'opzione --all , per visualizzare un elenco di immagini di macchine virtuali più diffuse in Azure Marketplace. Ad esempio, eseguire il comando seguente per visualizzare un elenco memorizzato nella cache di immagini popolari in formato tabella:
az vm image list --output table
L'output include l'URN dell'immagine. Se si omette l'opzione--all, è possibile visualizzare urnAlias per ogni immagine, se disponibile. UrnAlias è una versione abbreviata creata per immagini popolari come Ubuntu2204.
I nomi degli alias dell'immagine Linux e i relativi dettagli restituiti da questo comando sono:
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
I nomi degli alias di immagine di Windows e i relativi dettagli restituiti da questo comando sono:
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
Trovare immagini specifiche
È possibile filtrare l'elenco di immagini in base --publisher a o a un altro parametro per limitare i risultati.
Ad esempio, il comando seguente visualizza tutte le offerte Debian:
az vm image list --offer Debian --all --output table
È possibile limitare i risultati a una singola architettura aggiungendo il --architecture parametro . Ad esempio, per visualizzare tutte le immagini arm64 disponibili da Canonical:
az vm image list --architecture Arm64 --publisher Canonical --all --output table
Esaminare tutte le immagini disponibili
Un altro modo per trovare un'immagine in una posizione è l'esecuzione in sequenza dei comandi az vm image list-publishers, az vm image list-offers e az vm image list-skus . Con questi comandi si determinano questi valori:
Elencare gli autori di immagini per un percorso. In questo esempio viene esaminata l'area Stati Uniti occidentali.
az vm image list-publishers --location westus --output tableElencando le offerte di un determinato editore. In questo esempio viene aggiunto RedHat come editore.
az vm image list-offers --location westus --publisher RedHat --output tableElencando le SKU di una determinata offerta. In questo esempio si aggiunge RHEL come offerta.
az vm image list-skus --location westus --publisher RedHat --offer RHEL --output table
Nota
Canonical ha modificato i nomi offerta usati per le versioni più recenti. Prima di Ubuntu 20.04, il nome offerta è UbuntuServer. Per Ubuntu 20.04 il nome offerta è 0001-com-ubuntu-server-focal e per Ubuntu 22.04 è 0001-com-ubuntu-server-jammy.
Per un determinato editore, offerta e SKU, visualizzare tutte le versioni dell'immagine. In questo esempio viene aggiunto 9_1 come SKU.
az vm image list \ --location westus \ --publisher RedHat \ --offer RHEL \ --sku 9_1 \ --all --output table
Passare questo valore della colonna URN con il --image parametro quando si crea una macchina virtuale con il comando az vm create . È anche possibile sostituire il numero di versione nell'URN con "latest" per usare la versione più recente dell'immagine.
Se si distribuisce una macchina virtuale con un modello di Resource Manager, impostare singolarmente i parametri dell'immagine nelle proprietà imageReference. Vedere le informazioni di riferimento sul modello.
Controllare le informazioni sul piano di acquisto
Alcune immagini di macchine virtuali in Azure Marketplace hanno condizioni di licenza e acquisto aggiuntive che è necessario accettare prima di poterle distribuire a livello di codice.
Per distribuire una macchina virtuale da tale immagine, è necessario accettare le condizioni dell'immagine la prima volta che viene usata, una volta per ogni sottoscrizione. È anche necessario specificare i parametri del piano di acquisto per distribuire una macchina virtuale da tale immagine
Per visualizzare le informazioni sul piano di acquisto di un'immagine, eseguire il comando az vm image show con l'URN dell'immagine. Se la plan proprietà nell'output non nullè , l'immagine contiene termini che è necessario accettare prima della distribuzione a livello di codice.
Ad esempio, l'immagine Canonical Ubuntu Server 18.04 LTS non ha termini aggiuntivi, perché le plan informazioni sono null:
az vm image show --location westus --urn Canonical:UbuntuServer:18.04-LTS:latest
Output:
{
"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
}
Eseguendo un comando analogo per l'immagine RabbitMQ certificata da Bitnami vengono mostrate le proprietà plan seguenti: name, product e publisher. (Alcune immagini hanno anche una proprietà promotion code.)
az vm image show --location westus --urn bitnami:rabbitmq:rabbitmq:latest
Output:
{
"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
}
Per distribuire questa immagine, è necessario accettare le condizioni e specificare i parametri del piano di acquisto quando si distribuisce una macchina virtuale usando tale immagine.
Accettare le condizioni
Per visualizzare e accettare le condizioni di licenza, usare il comando az vm image terms.To view and accept the license terms, use the az vm image terms command. Quando si accettano le condizioni, si abilita la distribuzione a livello di codice nella sottoscrizione. È sufficiente accettare le condizioni per l'immagine una sola volta per ogni sottoscrizione. Ad esempio:
az vm image terms show --urn bitnami:rabbitmq:rabbitmq:latest
L'output include un licenseTextLink alle condizioni di licenza e indica che il valore di accepted è 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"
}
Per accettare i termini, digitare:
az vm image terms accept --urn bitnami:rabbitmq:rabbitmq:latest
Distribuire una nuova macchina virtuale usando i parametri dell'immagine
Con informazioni sull'immagine, è possibile distribuirla usando il az vm create comando .
Per distribuire un'immagine che non dispone di informazioni sul piano, ad esempio l'immagine Ubuntu Server 18.04 più recente di Canonical, passare l'URN per --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
Per un'immagine con parametri del piano di acquisto, ad esempio l'immagine RabbitMQ Certified by Bitnami, si passa l'URN per --image e si specificano anche i parametri del piano di acquisto:
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
Se viene visualizzato un messaggio relativo all'accettazione delle condizioni dell'immagine, vedere la sezione Accettare le condizioni. Assicurarsi che l'output di az vm image accept-terms restituisca il valore "accepted": true, che mostra che sono state accettate le condizioni dell'immagine.
Uso di un disco rigido virtuale esistente con informazioni sul piano di acquisto
Se si dispone di un disco rigido virtuale esistente da una macchina virtuale creata usando un'immagine di Azure Marketplace a pagamento, potrebbe essere necessario fornire le informazioni sul piano di acquisto durante la creazione di una nuova macchina virtuale da tale disco rigido virtuale.
Se la macchina virtuale originale o un'altra macchina virtuale creata usando la stessa immagine del marketplace, è possibile ottenere il nome del piano, l'editore e le informazioni sul prodotto usando az vm get-instance-view. Questo esempio ottiene una macchina virtuale denominata myVM nel gruppo di risorse myResourceGroup e quindi visualizza le informazioni sul piano di acquisto.
az vm get-instance-view -g myResourceGroup -n myVM --query plan
Se non sono state recuperate le informazioni sul piano prima dell'eliminazione della macchina virtuale originale, è possibile inviare una richiesta di supporto. Saranno necessari il nome della macchina virtuale, l'ID sottoscrizione e il timestamp dell'operazione di eliminazione.
Dopo aver ottenuto le informazioni sul piano, è possibile creare la nuova macchina virtuale usando il --attach-os-disk parametro per specificare il disco rigido virtuale.
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
Passaggi successivi
Per creare rapidamente una macchina virtuale usando le informazioni relative all'immagine, vedere Creare e gestire VM Linux con l'interfaccia della riga di comando di Azure.