Informatie over azure Marketplace-installatiekopieën zoeken met behulp van de Azure CLI

Artikel
10/18/2023

Let op

In dit artikel wordt verwezen naar CentOS, een Linux-distributie die de status End Of Life (EOL) nadert. 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: ✔️ Virtuele Linux-machines voor 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ën op te geven wanneer u programmatisch een VIRTUELE machine maakt met de CLI, Resource Manager-sjablonen of andere hulpprogramma's.

U kunt ook bladeren door beschikbare installatiekopieën en aanbiedingen met behulp van Azure Marketplace of Azure PowerShell.

Terminologie

Een Marketplace-installatiekopieën in Azure hebben de volgende kenmerken:

Uitgever: de organisatie die de installatiekopieën heeft gemaakt. Voorbeelden: Canonical, RedHat, SUSE.
Aanbieding: De naam van een groep gerelateerde installatiekopieën die zijn gemaakt door een uitgever. Voorbeelden: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
SKU: Een exemplaar van een aanbieding, zoals een grote release van een distributie. Voorbeelden: 22_04-lts-gen2, 8-lvm-gen2, gen2.
Versie: het versienummer van een installatiekopieën-SKU.

Deze waarden kunnen afzonderlijk of als afbeeldings-URN worden doorgegeven, waarbij de waarden worden gecombineerd die worden gescheiden door de dubbele punt (:). Bijvoorbeeld: Publisher:Offer:Sku:Version. U kunt het versienummer in de URN vervangen door latest de nieuwste versie van de installatiekopieën 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.

Populaire afbeeldingen weergeven

U kunt de az vm image list --all uitvoeren om alle beschikbare installatiekopieën voor u te zien, maar het kan enkele minuten duren om de hele lijst te produceren. Een snellere optie is het gebruik az vm image list, zonder de --all optie, om een lijst met populaire VM-installatiekopieën te bekijken in Azure Marketplace. Voer bijvoorbeeld de volgende opdracht uit om een lijst met populaire afbeeldingen in de cache 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, ziet u de UrnAlias voor elke afbeelding, indien beschikbaar. UrnAlias is een verkorte versie die is gemaakt voor populaire installatiekopieën zoals Ubuntu2204. De namen van de Linux-installatiekopieën en de bijbehorende gegevens die door deze opdracht worden uitgevoerd, zijn:

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

De namen van de Windows-installatiekopieën en de bijbehorende gegevens die door deze opdracht worden uitgevoerd, zijn:

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

Specifieke installatiekopieën zoeken

U kunt de lijst met afbeeldingen --publisher filteren op 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 installatiekopieën 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 in volgorde uit te voeren. Met deze opdrachten bepaalt u deze waarden:

Geef de uitgevers van installatiekopieën weer voor een locatie. In dit voorbeeld kijken we naar de regio VS - west.
```
az vm image list-publishers --location westus --output table
```
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
```
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. Voor Ubuntu 20.04 is de naam van de aanbieding UbuntuServer. Voor Ubuntu 20.04 is de naam van de aanbieding en 0001-com-ubuntu-server-focal voor Ubuntu 22.04 is 0001-com-ubuntu-server-jammydit .

Voor een bepaalde uitgever, aanbieding en SKU geeft u alle versies van de installatiekopieën 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', om de nieuwste versie van de installatiekopieën te gebruiken.

Als u een VIRTUELE machine met een Resource Manager-sjabloon implementeert, stelt u de installatiekopieënparameters afzonderlijk in de imageReference eigenschappen 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 parameters voor het aankoopplan opgeven om een VIRTUELE machine te implementeren vanuit die installatiekopieën

Als u de aankoopplangegevens van een installatiekopieën wilt weergeven, voert u de opdracht az vm image show uit met de URN van de installatiekopieën. Als de plan eigenschap in de uitvoer niet nullis, bevat de installatiekopieën termen die u moet accepteren voordat u programmatische implementatie uitvoert.

De Canonical Ubuntu Server 18.04 LTS-installatiekopie heeft bijvoorbeeld geen extra voorwaarden, omdat de plan informatie: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 slechts eenmaal per abonnement voor de installatiekopieën te accepteren. Voorbeeld:

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

De uitvoer bevat een licenseTextLink aan de licentievoorwaarden en geeft aan dat de waarde istrue:accepted

{
  "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 behulp van de installatiekopieënparameters

Met informatie over de installatiekopieën kunt u deze implementeren met behulp van de az vm create opdracht.

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 installatiekopieën met parameters voor het aankoopplan, zoals de RabbitMQ Certified by Bitnami-installatiekopieën, geeft u de URN door --image en geeft u ook de parameters voor het aankoopplan 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 accept-terms 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 Azure Marketplace-installatiekopieën, moet u mogelijk de aankoopplangegevens opgeven bij het maken van een nieuwe VIRTUELE machine op basis van die VHD.

Als u nog steeds de oorspronkelijke VIRTUELE machine of een andere VIRTUELE machine hebt gemaakt met dezelfde marketplace-installatiekopieën, kunt u de naam van het plan, de uitgever en de productinformatie ervan ophalen met behulp van az vm get-instance-view. In dit voorbeeld wordt een virtuele machine met de naam myVM opgehaald in de resourcegroep myResourceGroup en wordt vervolgens de informatie over 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 plangegevens hebt, kunt u de nieuwe VIRTUELE machine maken met behulp van de --attach-os-disk parameter om de VHD op te geven.

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

Als u snel een virtuele machine wilt maken met behulp van de installatiekopieën, raadpleegt u Virtuele Linux-machines maken en beheren met de Azure CLI.