CLI-voorbeeld: Voer een taak en taken uit met Azure Batch

Dit script creëert een Batch-taak en voegt een reeks taken toe aan de taak. Het laat ook zien hoe u een taak en de bijbehorende taken bewaakt.

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.

Vereiste voorwaarden

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container te draaien. Voor meer informatie, zie Hoe u de Azure CLI in een Docker-container kunt uitvoeren.

  • Als je een lokale installatie gebruikt, meld je dan aan bij de Azure CLI met de opdracht az login. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de versie en de geïnstalleerde afhankelijke bibliotheken te vinden. Om naar de nieuwste versie te upgraden, voer az upgrade uit.

Voorbeeldscript

Azure Cloud Shell starten

De Azure Cloud Shell is een gratis interactieve shell die je kunt gebruiken om de stappen in dit artikel uit te voeren. Veelgebruikte Azure-hulpprogramma's zijn vooraf geïnstalleerd en geconfigureerd voor gebruik met uw account.

Als u Cloud Shell wilt openen, selecteert u Proberen in de rechterbovenhoek van een codeblok. U kunt Cloud Shell ook openen in een afzonderlijk browsertabblad door naar https://shell.azure.com te gaan.

Wanneer Cloud Shell wordt geopend, controleer of Bash is geselecteerd voor uw omgeving. Latere sessies zullen gebruikmaken van Azure CLI in een Bash-omgeving. Selecteer Copy om de codeblokken te kopiëren, plak ze in de Cloud Shell, en druk op Enter om ze uit te voeren.

Aanmelden bij Azure

Cloud Shell wordt automatisch geverifieerd onder het aanvankelijke account waarmee is ingelogd. Gebruik het volgende script om in te loggen met een ander abonnement. Vervang subscriptionId door je Azure-abonnement-ID.

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.

subscription="subscriptionId" # Set Azure subscription ID here

az account set -s $subscription # ...or use 'az login'

Voor meer informatie kunt u set active subscription of log in interactively bekijken.

Maak een Batch-account aan in Batch-servicemodus

# Run a job and tasks with Azure Batch

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
[[ "$RESOURCE_GROUP" == '' ]] && resourceGroup="msdocs-batch-rg-$randomIdentifier" || resourceGroup="${RESOURCE_GROUP}"
tag="run-job"
storageAccount="msdocsstorage$randomIdentifier"
batchAccount="msdocsbatch$randomIdentifier"

# Create a resource group.
echo "Creating $resourceGroup in "$location"..."
az group create --name $resourceGroup --location "$location" --tag $tag

# Create a general-purpose storage account in your resource group.
echo "Creating $storageAccount"
az storage account create --resource-group $resourceGroup --name $storageAccount --location "$location" --sku Standard_LRS

# Create a Batch account.
echo "Creating $batchAccount"
az batch account create --name $batchAccount --storage-account $storageAccount --resource-group $resourceGroup --location "$location"

# Authenticate against the account directly for further CLI interaction.
az batch account login --name $batchAccount --resource-group $resourceGroup --shared-key-auth

# Create a new Linux pool with a virtual machine configuration. 
az batch pool create --id mypool --vm-size Standard_A1 --target-dedicated 2 --image canonical:ubuntuserver:18_04-lts-gen2 --node-agent-sku-id "batch.node.ubuntu 18.04"

# Create a new job to encapsulate the tasks that are added.
az batch job create --id myjob --pool-id mypool

# Add tasks to the job. Here the task is a basic shell command.
az batch task create --job-id myjob --task-id task1 --command-line "/bin/bash -c 'printenv AZ_BATCH_TASK_WORKING_DIR'"

Meerdere taken tegelijk toevoegen

Om veel taken tegelijk toe te voegen, specificeer de taken in een JSON-bestand en geef dit door aan het commando. Voor de indeling, zie https://github.com/Azure/azure-docs-cli-python-samples/blob/master/batch/run-job/tasks.json. Geef het absolute pad naar het JSON-bestand op. Zie voor een voorbeeld van een JSON-bestand https://github.com/Azure-Samples/azure-cli-samples/blob/master/batch/run-job/tasks.json.

az batch task create \
    --job-id myjob \
    --json-file tasks.json

Om de opdracht bij te werken

Werk de taak bij zodat deze automatisch als voltooid wordt gemarkeerd zodra alle taken zijn afgerond.

az batch job set \
--job-id myjob \
--on-all-tasks-complete terminatejob

Om de status van de taak te controleren.

az batch job show --job-id myjob

Om de status van een taak te controleren

az batch task show \
    --job-id myjob \
    --task-id task1

De hulpbronnen opschonen

Gebruik de volgende opdracht om de resourcegroep en alle bijbehorende resources te verwijderen met behulp van het az group delete-commando, tenzij u deze resources nog nodig heeft. Sommige van deze resources kunnen even duren om te maken, en ook om te verwijderen.

az group delete --name $resourceGroup

Voorbeeldreferentie

Dit script gebruikt de volgende commando's. Elke opdracht in de tabel linkt naar documentatie die specifiek is voor die opdracht.

Volgende stappen

Voor meer informatie over de Azure CLI, zie Azure CLI documentation.