Informatie over azure Marketplace-installatiekopieën zoeken met behulp van 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: ✔️ 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-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 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 tableGeef 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 tableGeef 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.