Hitta Azure Marketplace-avbildningsinformation med hjälp av Azure CLI

Varning

Den här artikeln refererar till CentOS, en Linux-distribution som närmar sig EOL-status (End Of Life). Överväg att använda och planera i enlighet med detta. Mer information finns i CentOS End Of Life-vägledningen.

Gäller för: ✔️ Virtuella Linux-datorer ✔️ med virtuella Windows-datorer ✔️ – flexibla skalningsuppsättningar

Det här avsnittet beskriver hur du använder Azure CLI för att hitta VM-avbildningar på Azure Marketplace. Använd den här informationen om du vill ange en Marketplace-avbildning när du skapar en virtuell dator programmatiskt med CLI, Resource Manager-mallar eller andra verktyg.

Du kan också bläddra bland tillgängliga bilder och erbjudanden med hjälp av Azure Marketplace eller Azure PowerShell.

Terminologi

En Marketplace-avbildning i Azure har följande attribut:

  • Utgivare: Den organisation som skapade avbildningen. Exempel: Canonical, RedHat, SUSE.
  • Erbjudande: Namnet på en grupp relaterade bilder som skapats av en utgivare. Exempel: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
  • SKU: En instans av ett erbjudande, till exempel en större distributionsversion. Exempel: 22_04-lts-gen2, 8-lvm-gen2, gen2.
  • Version: Versionsnumret för en avbildnings-SKU.

Dessa värden kan skickas individuellt eller som en avbildnings-URN och kombinera värdena avgränsade med kolonet (:). Exempel: Publisher:Offer:Sku:Version. Du kan ersätta versionsnumret i URN med latest för att använda den senaste versionen av avbildningen.

Om bildutgivaren tillhandahåller extra licens- och köpvillkor måste du godkänna dessa villkor innan du kan använda avbildningen. Mer information finns i Kontrollera köpplansinformationen.

Du kan köra az vm image list - all för att se alla avbildningar som är tillgängliga för dig, men det kan ta flera minuter att skapa hela listan. Ett snabbare alternativ är att använda az vm image list, utan --all alternativet, för att se en lista över populära VM-avbildningar på Azure Marketplace. Kör till exempel följande kommando för att visa en cachelagrad lista över populära bilder i tabellformat:

az vm image list --output table

Utdata innehåller bild-URN. Om du utelämnar alternativet --all kan du se UrnAlias för varje bild, om det är tillgängligt. UrnAlias är en förkortad version som skapats för populära bilder som Ubuntu2204. Namn på Linux-avbildningsalias och deras information som matas ut av det här kommandot är:

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

Windows-avbildningens aliasnamn och deras information som matas ut av det här kommandot är:

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

Söka efter specifika avbildningar

Du kan filtrera listan med bilder efter --publisher eller en annan parameter för att begränsa resultatet.

Följande kommando visar till exempel alla Debian-erbjudanden:

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

Du kan begränsa dina resultat till en enda arkitektur genom att lägga till parametern --architecture . Om du till exempel vill visa alla Arm64-bilder som är tillgängliga från Canonical:

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

Titta på alla tillgängliga bilder

Ett annat sätt att hitta en avbildning på en plats är att köra az vm image list-publishers, az vm image list-offers och az vm image list-skus commands in sequence. Med dessa kommandon bestämmer du följande värden:

  1. Visa en lista över avbildningsutfärdare för en plats. I det här exemplet tittar vi på regionen USA , västra.

    az vm image list-publishers --location westus --output table
    
  2. Visa en lista över erbjudanden från en viss utgivare. I det här exemplet lägger vi till RedHat som utgivare.

    az vm image list-offers --location westus --publisher RedHat --output table
    
  3. Visa en lista över SKU:er för ett visst erbjudande. I det här exemplet lägger vi till RHEL som erbjudande.

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

Kommentar

Canonical har ändrat de erbjudandenamn som de använder för de senaste versionerna. Före Ubuntu 20.04 är erbjudandenamnet UbuntuServer. För Ubuntu 20.04 är 0001-com-ubuntu-server-focal erbjudandenamnet och för Ubuntu 22.04 är 0001-com-ubuntu-server-jammydet .

  1. För en viss utgivare, erbjudande och SKU visar du alla versioner av avbildningen. I det här exemplet lägger vi till 9_1 som SKU.

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

Skicka det här värdet för KOLUMNEN URN med parametern --image när du skapar en virtuell dator med kommandot az vm create . Du kan också ersätta versionsnumret i URN med "senaste" för att använda den senaste versionen av avbildningen.

Om du distribuerar en virtuell dator med en Resource Manager-mall anger du avbildningsparametrarna individuellt i imageReference egenskaperna. Se mallreferensen.

Kontrollera köpplansinformationen

Vissa VM-avbildningar på Azure Marketplace har extra licens- och inköpsvillkor som du måste godkänna innan du kan distribuera dem programmatiskt.

Om du vill distribuera en virtuell dator från en sådan avbildning måste du godkänna avbildningens villkor första gången du använder den, en gång per prenumeration. Du måste också ange köpplansparametrar för att distribuera en virtuell dator från avbildningen

Om du vill visa en bilds köpplansinformation kör du kommandot az vm image show med URN för avbildningen. Om egenskapen plan i utdata inte nullär har avbildningen villkor som du måste acceptera före programmatisk distribution.

Till exempel har den kanoniska Ubuntu Server 18.04 LTS-avbildningen plan inte extra villkor, eftersom informationen är null:

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

Utdata:

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

Om du kör ett liknande kommando för RabbitMQ Certified by Bitnami-avbildningen visas följande plan egenskaper: name, productoch publisher. (Vissa bilder har också en promotion code egenskap.)

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

Utdata:

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

För att distribuera den här avbildningen måste du godkänna villkoren och ange parametrarna för inköpsplanen när du distribuerar en virtuell dator med den avbildningen.

Acceptera villkoren

Om du vill visa och acceptera licensvillkoren använder du kommandot az vm image terms . När du godkänner villkoren aktiverar du programmatisk distribution i din prenumeration. Du behöver bara acceptera villkor en gång per prenumeration för avbildningen. Till exempel:

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

Utdata innehåller en licenseTextLink till licensvillkoren och anger att värdet accepted för är 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"
}

Om du vill acceptera villkoren skriver du:

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

Distribuera en ny virtuell dator med avbildningsparametrarna

Med information om avbildningen kan du distribuera den med hjälp av az vm create kommandot .

Om du vill distribuera en avbildning som inte har planinformation, som den senaste Ubuntu Server 18.04-avbildningen från Canonical, skickar du 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 en avbildning med köpplansparametrar, till exempel RabbitMQ Certified by Bitnami-avbildningen, skickar du URN för och anger även parametrarna för --image inköpsplanen:

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

Om du får ett meddelande om att acceptera villkoren för avbildningen läser du avsnittet Acceptera villkoren. Kontrollera att utdata az vm image accept-terms från returnerar värdet "accepted": true, som visar att du har accepterat villkoren för bilden.

Använda en befintlig virtuell hårddisk med köpplansinformation

Om du har en befintlig virtuell hårddisk från en virtuell dator som skapades med en betald Azure Marketplace-avbildning kan du behöva ge inköpsplansinformationen när du skapar en ny virtuell dator från den virtuella hårddisken.

Om du fortfarande har den ursprungliga virtuella datorn eller en annan virtuell dator som skapats med samma marketplace-avbildning kan du hämta plannamnet, utgivaren och produktinformationen från den med hjälp av az vm get-instance-view. Det här exemplet hämtar en virtuell dator med namnet myVM i resursgruppen myResourceGroup och visar sedan köpplansinformationen.

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

Om du inte fick planinformationen innan den ursprungliga virtuella datorn togs bort kan du skicka en supportbegäran. De behöver vm-namnet, prenumerations-ID:t och tidsstämpeln för borttagningsåtgärden.

När du har planinformationen kan du skapa den nya virtuella datorn med hjälp av parametern --attach-os-disk för att ange den virtuella hårddisken.

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ästa steg

Information om hur du snabbt skapar en virtuell dator med hjälp av avbildningsinformationen finns i Skapa och hantera virtuella Linux-datorer med Azure CLI.