Zoek informatie over Azure Marketplace-installatiekopieën met de Azure CLI

Let op

Dit artikel verwijst naar CentOS, een Linux-distributie met de EOL-status (End Of Life). Houd rekening met uw gebruik en plan dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.

Van toepassing op: ✔️ Linux-VM's ✔️ Windows-VM's ✔️ Flexibele schaalsets

In dit onderwerp wordt beschreven hoe u de Azure CLI gebruikt om VM-installatiekopieën te vinden in Azure Marketplace. Gebruik deze informatie om een Marketplace-installatiekopie te specificeren wanneer u bij het programmatisch maken van een VM de CLI, Resource Manager-sjablonen of andere hulpprogramma's gebruikt.

U kunt ook beschikbare installatiekopieën en aanbiedingen bekijken via de Azure Marketplace of Azure PowerShell.

Terminologie

Een Marketplace-installatiekopie in Azure heeft de volgende kenmerken:

  • Uitgever: de organisatie die de installatiekopieën heeft gemaakt. Voorbeelden: Canonical, RedHat, SUSE.
  • Aanbod: De naam van een groep verwante installatiekopieën die door een uitgever zijn gemaakt. Voorbeelden: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
  • SKU: een variant van een aanbod, zoals een belangrijke release van een distributie. Voorbeelden: 22_04-lts-gen2, 8-lvm-gen2, gen2.
  • Versie: Het versienummer van een image-SKU.

Deze waarden kunnen afzonderlijk of als een image-URN worden doorgegeven, waarbij de waarden worden gecombineerd en gescheiden door een dubbele punt (:). Bijvoorbeeld: Uitgever:Aanbieding:SKU:Versie. U kunt het versienummer in de URN vervangen door latest om de nieuwste versie van de installatiekopie te gebruiken.

Als de uitgever van de installatiekopieën extra licentie- en aankoopvoorwaarden biedt, moet u deze voorwaarden accepteren voordat u de installatiekopieën kunt gebruiken. Zie De informatie over het aankoopplan controleren voor meer informatie.

Voer az vm image list --all uit om alle installatiekopieën te bekijken die voor u beschikbaar zijn, maar het kan enkele minuten duren voordat de volledige lijst wordt weergegeven. Een snellere optie is om az vm image list te gebruiken, zonder de optie --all, om een lijst in de cache met populaire VM-installatiekopieën in Azure Marketplace weer te geven. Voer bijvoorbeeld de volgende opdracht uit om de lijst weer te geven in tabelindeling:

az vm image list --output table

De uitvoer bevat de URN van de afbeelding. Als u de --all optie weglaat, kunnen de resultaten ook UrnAlias-waarden bevatten voor populaire afbeeldingen, zoals Ubuntu2204. De exacte lijst met caches varieert per Azure CLI versie en cloud.

Het volgende niet-uitputtende voorbeeld toont enkele aliassen van Linux-installatiekopieën die worden geretourneerd door Azure CLI 2.87.0, waaronder aliassen voor Azure Linux 4.0:

Architecture    Offer                         Publisher               Sku                                 Urn                                                                             UrnAlias                 Version
--------------  ----------------------------  ----------------------  ----------------------------------  ------------------------------------------------------------------------------  -----------------------  ---------
x64             azurelinux-4                  microsoftazurelinux     4                                   microsoftazurelinux:azurelinux-4:4:latest                                       AzureLinux4              latest
Arm64           azurelinux-4                  microsoftazurelinux     4-arm64                             microsoftazurelinux:azurelinux-4:4-arm64:latest                                 AzureLinux4Arm64         latest
x64             azurelinux-4                  microsoftazurelinux     4-gen1                              microsoftazurelinux:azurelinux-4:4-gen1:latest                                  AzureLinux4Gen1          latest
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

De volgende Windows afbeeldingsaliassen zijn een ander niet-volledig voorbeeld van wat met deze opdracht kan worden geretourneerd:

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

Specifieke afbeeldingen zoeken

U kunt de lijst met afbeeldingen filteren op --publisher of een andere parameter om de resultaten te beperken.

Met de volgende opdracht worden bijvoorbeeld alle Debian-aanbiedingen weergegeven:

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

U kunt uw resultaten beperken tot één architectuur door de --architecture parameter toe te voegen. Als u bijvoorbeeld alle Arm64-afbeeldingen wilt weergeven die beschikbaar zijn via Canonical:

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

Bekijk alle beschikbare afbeeldingen

Een andere manier om een image op een locatie te vinden, is door de opdrachten az vm image list-publishers, az vm image list-offers en az vm image list-skus achtereenvolgens uit te voeren. Met deze opdrachten bepaalt u deze waarden:

  1. Geef de image-uitgevers voor een locatie weer. In dit voorbeeld kijken we naar de regio VS - west.

    az vm image list-publishers --location westus --output table
    
  2. Geef de aanbiedingen voor een bepaalde uitgever weer. In dit voorbeeld voegen we RedHat toe als uitgever.

    az vm image list-offers --location westus --publisher RedHat --output table
    
  3. Geef de SKU's voor een bepaalde aanbieding weer. In dit voorbeeld voegen we RHEL toe als aanbieding.

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

Notitie

Canonical heeft de namen van aanbiedingen gewijzigd die ze gebruiken voor de meest recente versies. Vóór Ubuntu 20.04 is de naam voor Offer UbuntuServer. Voor Ubuntu 20.04 is de naam van het aanbod0001-com-ubuntu-server-focal en voor Ubuntu 22.04 is dit 0001-com-ubuntu-server-jammy.

  1. Geef voor een bepaalde uitgever, aanbod en SKU alle versies van de images weer. In dit voorbeeld voegen we 9_1 toe als de SKU.

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

Geef deze waarde van de URN-kolom door met de --image parameter wanneer u een virtuele machine maakt met de opdracht az vm create . U kunt ook het versienummer in de URN vervangen door "latest", zodat u de nieuwste versie van de image gebruikt.

Als u een VM met een Resource Manager-sjabloon implementeert, stelt u de imageparameters afzonderlijk in de eigenschappen van imageReference in. Zie de sjabloonverwijzing.

De informatie over het aankoopplan controleren

Sommige VM-installatiekopieën in Azure Marketplace hebben extra licentie- en aankoopvoorwaarden die u moet accepteren voordat u ze programmatisch kunt implementeren.

Als u een virtuele machine vanuit een dergelijke installatiekopieën wilt implementeren, moet u de voorwaarden van de installatiekopieën accepteren wanneer u deze voor het eerst gebruikt, eenmaal per abonnement. U moet ook de parameters van het aankoopplan opgeven om een virtuele machine uit te rollen op basis van die installatiekopie

Als u informatie over het aankoopplan van een installatiekopie wilt weergeven, voert u de opdracht az vm image show uit met de URN van de installatiekopie. Als de eigenschap plan in de uitvoer niet null is, bevat de installatiekopie voorwaarden die u moet accepteren voordat u deze programmatisch kunt implementeren.

Bijvoorbeeld, de Canonical Ubuntu Server 18.04 LTS-image heeft geen extra voorwaarden, omdat de informatie plan is null:

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

Uitvoer:

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

Als u een vergelijkbare opdracht uitvoert voor de RabbitMQ Certified by Bitnami-afbeelding, ziet u de volgende plan eigenschappen: name, producten publisher. (Sommige afbeeldingen hebben ook een promotion code eigenschap.)

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

Uitvoer:

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

Als u deze installatiekopieën wilt implementeren, moet u de voorwaarden accepteren en de parameters voor het aankoopplan opgeven wanneer u een VIRTUELE machine implementeert met die installatiekopieën.

Accepteer de voorwaarden

Gebruik de opdracht az vm image terms om de licentievoorwaarden weer te geven en te accepteren. Wanneer u de voorwaarden accepteert, schakelt u programmatische implementatie in uw abonnement in. U hoeft de voorwaarden maar één keer per abonnement voor de image te accepteren. Voorbeeld:

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

De uitvoer bevat een licenseTextLink naar de licentievoorwaarden en geeft aan dat de waarde van acceptedtrue is:

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

Als u de voorwaarden wilt accepteren, typt u:

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

Een nieuwe VM implementeren met de parameters van de installatiekopie

Met informatie over de installatiekopie kunt u deze implementeren met de opdracht az vm create.

Als u een installatiekopie wilt implementeren die geen plangegevens bevat, zoals de meest recente Ubuntu Server 18.04-installatiekopie van Canonical, geeft u de URN door voor --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

Voor een image met aankoopplanparameters, zoals de RabbitMQ Certified by Bitnami-image, geeft u de URN voor --image door en geeft u ook de aankoopplanparameters op:

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

Als u een bericht krijgt over het accepteren van de voorwaarden van de afbeelding, raadpleegt u de sectie Accepteren van de voorwaarden. Zorg ervoor dat de uitvoer van az vm image terms accept de waarde "accepted": true, retourneert die laat zien dat u de voorwaarden van de afbeelding hebt geaccepteerd.

Een bestaande VHD gebruiken met informatie over het aankoopplan

Als u een bestaande VHD hebt van een virtuele machine die is gemaakt met behulp van een betaalde installatiekopie uit Azure Marketplace, moet u mogelijk de gegevens van het aankoopplan opgeven wanneer u een nieuwe virtuele machine maakt op basis van die VHD.

Als u nog steeds de oorspronkelijke virtuele machine hebt, of een andere virtuele machine die is gemaakt met dezelfde Marketplace-installatiekopie, kunt u de plannaam, de uitgever en de productinformatie ervan ophalen met az vm get-instance-view. In dit voorbeeld wordt een virtuele machine met de naam myVM opgehaald in de resourcegroep myResourceGroup en worden vervolgens de gegevens van het aankoopplan weergegeven.

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

Als u de plangegevens niet hebt opgehaald voordat de oorspronkelijke VM werd verwijderd, kunt u een ondersteuningsaanvraag indienen. Ze hebben de vm-naam, abonnements-id en het tijdstempel van de verwijderbewerking nodig.

Zodra u de gegevens van het plan hebt, kunt u de nieuwe VM maken met behulp van de parameter --attach-os-disk om de VHD te specificeren.

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

Volgende stappen

Zie Virtuele Linux-machines maken en beheren met de Azure CLI als u snel een virtuele machine wilt maken met behulp van de gegevens van de installatiekopie.