az image builder
Image Builder-sjablonen beheren en bouwen.
Opdracht
| az image builder cancel |
Annuleer de langlopende build van de afbeelding op basis van de afbeeldingssjabloon. |
| az image builder create |
Maak een sjabloon voor de opbouw van afbeeldingen. |
| az image builder customizer |
Sjabloon customizers voor Image Builder beheren. |
| az image builder customizer add |
Voeg een aanwijzer voor de opbouw van afbeeldingen toe aan een sjabloon voor de opbouw van afbeeldingen. |
| az image builder customizer clear |
Verwijder alle aanpasers voor de opbouw van afbeeldingen uit een sjabloon voor de opbouw van afbeeldingen. |
| az image builder customizer remove |
Verwijder een aanwijzer voor de opbouw van afbeeldingen uit een sjabloon voor de opbouw van afbeeldingen. |
| az image builder delete |
Sjabloon voor het maken van afbeeldingen verwijderen. |
| az image builder list |
Lijst met image builder-sjablonen. |
| az image builder output |
Uitvoerdistributeurs van image builder-sjablonen beheren. |
| az image builder output add |
Voeg een uitvoerdistributeur voor image builder toe aan een sjabloon voor de opbouw van afbeeldingen. |
| az image builder output clear |
Verwijder alle uitvoerdistributeurs van Image Builder uit een sjabloon voor de opbouw van afbeeldingen. |
| az image builder output remove |
Verwijder een uitvoerdistributeur voor image builder uit een sjabloon voor de opbouw van afbeeldingen. |
| az image builder run |
Bouw een sjabloon voor de opbouw van afbeeldingen. |
| az image builder show |
Een sjabloon voor de opbouw van afbeeldingen tonen. |
| az image builder show-runs |
Uitvoer van de uitvoer van een sjabloon voor de opbouw van afbeeldingen tonen. |
| az image builder update |
Werk een sjabloon voor de opbouw van afbeeldingen bij. |
| az image builder wait |
Plaats de CLI in een wachttoestand totdat aan een voorwaarde van de sjabloon wordt voldaan. |
az image builder cancel
Annuleer de langlopende build van de afbeelding op basis van de afbeeldingssjabloon.
az image builder cancel [--ids]
[--name]
[--resource-group]
[--subscription]
Voorbeelden
Annuleer een build van een afbeelding.
az image builder cancel -n mytemplate -g my-group
Optionele parameters
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
De naam van de afbeeldingssjabloon.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder create
Maak een sjabloon voor de opbouw van afbeeldingen.
az image builder create --name
--resource-group
[--build-timeout]
[--checksum]
[--defer]
[--identity]
[--image-source]
[--image-template]
[--location]
[--managed-image-destinations]
[--no-wait]
[--os-disk-size]
[--scripts]
[--shared-image-destinations]
[--subnet]
[--subscription]
[--tags]
[--vm-size]
[--vnet]
Voorbeelden
Maak een sjabloon voor de opbouw van installatieafbeeldingen op basis van een UbuntuLTS 18.04-installatie afbeelding. Distribueren als een beheerde afbeelding en een versie van een galerie met gedeelde afbeeldingen
scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:UbuntuServer:18.04-LTS:18.04.201903060"
az image builder create --image-source $imagesource -n mytemplate -g my-group \
--scripts $scripts --managed-image-destinations image_1=westus \
--shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
--identity myidentity
Maak een sjabloon voor de opbouw van afbeeldingen met behulp van een sjabloonbestand voor afbeeldingen.
az image builder create -g my-group -n mytemplate --image-template filename
[Geavanceerd] Maak een afbeeldingssjabloon met meerdere aanpasers en distributeurs met behulp van de objectcache van de CLI via --defer. Ondersteunt functies zoals: aangepaste namen en uitvoernamen, PowerShell-exitcodes, inlinescripts, windows opnieuw opstarten, bestands customizers, artefacttags en VHD-uitvoerdistributeurs.
script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"
# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n mytemplate \
-g my-group --scripts $script --identity myidentity --defer
# add customizers
az image builder customizer add -n mytemplate -g my-group \
--customizer-name my-pwsh-script --exit-codes 0 1 --inline-script \
"mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
> c:\buildActions\Output.txt" --type powershell --defer
az image builder customizer add -n mytemplate -g my-group \
--customizer-name my-file-customizer --type file \
--file-source "https://my-file-source.net/file.txt" \
--dest-path "c:\buildArtifacts\file.txt" --defer
# add distributors
az image builder output add -n mytemplate -g my-group --is-vhd \
--output-name my-win-image-vhd --artifact-tags "is_vhd=True" --defer
az image builder output add -n mytemplate -g my-group \
--output-name my-win-image-managed --managed-image winImage \
--managed-image-location eastus \
--artifact-tags "is_vhd=False" --defer
# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n mytemplate -g my-group
Vereiste parameters
De naam van de afbeeldingssjabloon.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Optionele parameters
De Maximale duur die moet worden gewacht tijdens het bouwen van de afbeeldingssjabloon, in minuten. De standaardwaarde is 60.
De SHA256-controlesum van de Red Hat ISO-afbeelding.
Sla het object tijdelijk op in de lokale cache in plaats van naar Azure te verzenden. Gebruik az cache opdrachten om weer te geven/te clearen.
Lijst met door de gebruiker toegewezen identiteiten (naam of id, spatie met scheidingstekens) van de afbeeldingssjabloon.
De basisafbeelding die moet worden aangepast. Moet een geldige URN voor de platform-afbeelding, alias van platformafbeelding, URI van Red Hat ISO-afbeelding, naam/id van beheerde afbeelding of versie-id van gedeelde afbeelding zijn.
Lokaal pad of URL naar een afbeeldingssjabloonbestand. Wanneer u --image-template gebruikt, worden alle andere parameters genegeerd, behalve -g en -n. Naslaginformatie: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/image-builder-json.
Locatie. Waarden van: az account list-locations . U kunt de standaardlocatie configureren met az configure --defaults location=<location> behulp van .
Informatie over de distributeur van beheerde afbeeldingsuitvoer. Door spaties gescheiden lijst met sleutel-waardeparen. Bijvoorbeeld 'image_1=westus2 image_2=westus'. Elke sleutel is de naam of resource-id van de beheerde afbeelding die moet worden gemaakt. Elke waarde is de locatie van de afbeelding.
Wacht niet tot de langlopende bewerking is uitgevoerd.
Grootte van de besturingssysteemschijf in GB. Laat 0 weg of geef 0 op om de standaardschijfgrootte van het besturingssysteem van Azure te gebruiken.
Door spaties gescheiden lijst met shell- of PowerShell-scripts om de afbeelding mee aan te passen. Elk script moet een openbaar toegankelijke URL zijn. Decodeer het type script uit de bestandsextensie ('.sh' of '.ps1') of van het brontype. Zie ' az image template customizer add' (az image template customizer add) voor meer opties en flexibiliteit.
Gedeelde afbeeldingengalerie (sig) output distributor information. Door spaties gescheiden lijst met sleutel-waardeparen. Bijvoorbeeld 'my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth'. Elke sleutel is de definitie-id van de sig-afbeelding of de naam van de sig-galerie en de definitie van de sig-afbeelding, die wordt scheidingstekens door een '/'. Elke waarde is een lijst met replicalocaties met door komma's scheidingstekens.
Naam of id van het subnet voor het implementeren van de virtuele machine van de build.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Door spatie gescheiden tags: sleutel[=waarde] [sleutel[=waarde] ...]. Gebruik '' om bestaande tags te verwijderen.
Grootte van de virtuele machine die wordt gebruikt voor het bouwen, aanpassen en vastleggen van afbeeldingen. Laat een lege tekenreeks weg of geef deze op om de standaardwaarde (Standard_D1_v2).
Naam van het VNET voor het implementeren van de virtuele machine van de build. U moet dit alleen opgeven wanneer subnet een naam is.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder delete
Sjabloon voor het maken van afbeeldingen verwijderen.
az image builder delete [--ids]
[--name]
[--resource-group]
[--subscription]
Voorbeelden
Sjabloon voor het maken van afbeeldingen verwijderen. (automatisch gegenereerd)
az image builder delete --name MyImageTemplate --resource-group MyResourceGroup
Optionele parameters
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
De naam van de afbeeldingssjabloon.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder list
Lijst met image builder-sjablonen.
az image builder list [--query-examples]
[--resource-group]
[--subscription]
Optionele parameters
JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder run
Bouw een sjabloon voor de opbouw van afbeeldingen.
az image builder run [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
Voorbeelden
Start een sjabloon build-run en wacht tot deze is uitgevoerd.
az image builder run -n mytemplate -g my-group --no-wait
az image builder wait -n mytemplate -g aibmdi \
--custom "lastRunStatus.runState!='running'"
az image builder show -n mytemplate -g my-group
Optionele parameters
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
De naam van de afbeeldingssjabloon.
Wacht niet tot de langlopende bewerking is uitgevoerd.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder show
Een sjabloon voor de opbouw van afbeeldingen tonen.
az image builder show [--ids]
[--name]
[--query-examples]
[--resource-group]
[--subscription]
Voorbeelden
Een sjabloon voor de opbouw van afbeeldingen tonen (automatisch gegenereerd)
az image builder show --name mytemplate --resource-group my-group
Optionele parameters
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
De naam van de afbeeldingssjabloon.
JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder show-runs
Uitvoer van de uitvoer van een sjabloon voor de opbouw van afbeeldingen tonen.
az image builder show-runs [--ids]
[--name]
[--output-name]
[--resource-group]
[--subscription]
Voorbeelden
Voer een sjabloon build-run uit en bekijk vervolgens de uitvoer van de uitvoer.
az image builder run -n mytemplate -g my-group --no-wait
az image builder wait -n mytemplate -g aibmdi \
--custom "lastRunStatus.runState!='running'"
az image builder show-runs -n mytemplate -g my-group
Optionele parameters
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
De naam van de afbeeldingssjabloon.
De naam van de uitvoer van de opbouwer van de afbeelding.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder update
Werk een sjabloon voor de opbouw van afbeeldingen bij.
Het bijwerken van sjablonen voor de opbouw van afbeeldingen wordt momenteel niet ondersteund. Deze opdracht kan worden gebruikt in combinatie met --defer om een afbeeldingssjabloonobject in de CLI-cache bij te werken. Zonder --defer wordt de opgegeven afbeeldingssjabloon opgehaald uit de cache en wordt een aanvraag naar Azure verzendt om de sjabloon voor de afbeelding te maken.
az image builder update [--add]
[--defer]
[--force-string]
[--ids]
[--name]
[--remove]
[--resource-group]
[--set]
[--subscription]
Voorbeelden
Maak een sjabloonresource op basis van een sjabloonobject in de CLI-cache.
# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
--scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer
# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
--artifact-tags "is_vhd=False" --managed-image winImage --managed-image-location eastus --defer
# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group
Optionele parameters
Voeg een -object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string of JSON string>.
Sla het object tijdelijk op in de lokale cache in plaats van naar Azure te verzenden. Gebruik az cache opdrachten om weer te geven/te clearen.
Wanneer u 'set' of 'add' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te proberen te converteren naar JSON.
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
De naam van de afbeeldingssjabloon.
Verwijder een eigenschap of een element uit een lijst. Voorbeeld: --remove property.list OR --remove propertyToRemove.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Werk een object bij door een eigenschapspad en waarde op te geven die moeten worden ingesteld. Voorbeeld: --set property1.property2=.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az image builder wait
Plaats de CLI in een wachttoestand totdat aan een voorwaarde van de sjabloon wordt voldaan.
az image builder wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Voorbeelden
Start een sjabloon build-run en wacht tot deze is uitgevoerd.
az image builder run -n mytemplate -g my-group --no-wait
az image builder wait -n mytemplate -g aibmdi \
--custom "lastRunStatus.runState!='running'"
az image builder show -n mytemplate -g my-group
Optionele parameters
Wacht totdat u met provisioningState bij Succeeded hebt gemaakt.
Wacht totdat de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Wacht totdat u deze hebt verwijderd.
Wacht totdat de resource bestaat.
Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.
Pollinginterval in seconden.
De naam van de afbeeldingssjabloon.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Maximale wachttijd in seconden.
Wacht totdat de provisioningState is bijgewerkt op 'Succeeded'.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.