Zelfstudie: Persistente parameters gebruiken om sequentiële Azure CLI-opdrachten te vereenvoudigen
Azure CLI biedt persistente parameters waarmee u parameterwaarden kunt opslaan voor verder gebruik. In deze zelfstudie leert u hoe u kunt werken met persistente waarden en hoe u deze lokale waarden gebruikt om efficiënt sequentiële opdrachten uit te voeren.
In deze zelfstudie leert u het volgende:
- Referentieopdrachten
az config param-persistgebruiken - Sequentiële opdrachten uitvoeren met behulp van persistente parameters
In deze zelfstudie worden de volgende Azure CLI-opdrachten gebruikt
- az config param-persist delete
- az config param-persist off
- az config param-persist on
- az config param-persist show
- az function app create
- az group create
- az storage account create
Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.
Vereisten
-
Als u dat liever hebt, kunt u ook Azure Cloud Shell om de stappen in deze zelfstudie uit te voeren. Azure Cloud Shell is een interactieve shell-omgeving die u via uw browser gebruikt. Begin Cloud Shell met behulp van een van deze methoden:
Open Cloud Shell door naar te gaan https://shell.azure.com
Selecteer de Cloud Shell in de menubalk in de rechterbovenhoek van de Azure Portal
Als u een lokale installatie van de Azure CLI gebruikt, voltooit u het volgende:
Meld u aan met de opdracht az login en volg de stappen die worden weergegeven in uw terminal om het verificatieproces te voltooien.
az loginVoor deze zelfstudie is versie 2.12.0 of hoger van de Azure CLI vereist. Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
1. Uw lokale map bepalen
Persistente parameterwaarden worden opgeslagen in de werkmap van het Azure-opslagaccount dat wordt gebruikt door Azure Cloud Shell. Als u een lokale installatie van de Azure CLI gebruikt, worden waarden opgeslagen in de werkmap op uw computer.
Gebruik deze vertrouwde CLI-opdrachten om de werkmap te zoeken, te maken of te wijzigen die wordt gebruikt door de Azure CLI.
# List directories
dir
# Make directory
mkdir azCLI
# Change directory
cd azCLI
2. Persistente parameters in te stellen
Persistente parameters moeten worden ingeschakeld voordat parameterwaarden kunnen worden opgeslagen. U ontvangt een waarschuwing totdat az config param-persist u uit de experimentele fase bent verplaatst. Zie Overzicht: Azure CLI-referentietypen en -status voor meer informatie over de Azure CLI-referentietypen, -status en -ondersteuningsniveaus.
az config param-persist on
3. Persistente parameters maken
Als u waarden voor persistente parameters wilt opslaan, voert u een Azure CLI-opdracht naar keuze uit die de parameters bevat die u wilt opslaan. Maak bijvoorbeeld een resourcegroep en de --location --name parameters en worden opgeslagen voor toekomstig gebruik.
Sla de locatie en de naam van de resourcegroep op.
# With persisted parameters turned on, create a resource group az group create --name RG1forTutorial --location eastus2 # See new persisted parameters az config param-persist show{ "all": { "location": "eastus2", "resource_group_name": "RG1forTutorial" } }Maak een opslagaccount met behulp van de nieuwe persistente parameters.
# Create a storage account az storage account create --name sa1fortutorial # See that storage_account_name has been added to persisted parameters az config param-persist show{ "all": { "location": "eastus2", "resource_group_name": "RG1forTutorial", "storage_account_name": "sa1fortutorial" } }Maak een persistente parameter zonder een nieuwe resource te maken.
Als u geen nieuwe Azure-resource wilt maken en parameters kunnen worden opgeslagen met behulp van
resource_group_namelocationniet-create-opdrachten zoalsshowoflist. Zie Persistente parameters in Azure CLI voor een volledige lijst met ondersteunde parameters en de actie die nodig is om waarden te behouden. In dit voorbeeld worden ook alle parameterwaarden verwijderd met behulp van de opdracht az config param-persist delete.# Clear all persisted parameters for demonstration. az config param-persist delete --all # List all storage accounts which will create the `resource_group_name` stored parameter value. az storage account show --resource-group RG1forTutorial --name sa1fortutorial # See the new stored value created for resource group. The storage account name is only stored with a 'create' command. az config param-persist show{ "all": { "resource_group_name": "RG1forTutorial" } }
4. Persistente parameters vervangen
Het vervangen van een opgeslagen parameterwaarde is net zo eenvoudig als het uitvoeren van een opdracht die een andere waarde bevat.
Nieuwe persistente parameters maken.
# Clear all persisted parameters for demonstration az config param-persist delete --all # Create a storage account placing "location", "resource_group_name", and "storage_account_name" into persisted parameters az storage account create --name sa1fortutorial --resource-group RG1forTutorial --location eastus2 # See persisted parameters entries az config param-persist show{ "all": { "location": "eastus2", "resource_group_name": "RG1forTutorial", "storage_account_name": "sa1fortutorial" } }Vervang de nieuw opgeslagen waarden.
# Create a second storage account while changing both the "storage_account_name" and "location" persisted parameters az storage account create --name sa2fortutorial --location westeurope # See new persisted parameters az config param-persist show{ "all": { "location": "westeurope", "resource_group_name": "RG1forTutorial", "storage_account_name": "sa2fortutorial" } }Notitie
Zelfs als persistente parameters zijn ingeschakeld, hoeft u ze niet te gebruiken. U kunt nog steeds opdrachten uitvoeren met alle opgegeven parameterwaarden. Als persistente parameters zijn ingeschakeld, maakt u echter nieuwe persistente parameters of overschrijft u bestaande parameters.
5. Sequentiële opdrachten uitvoeren
Met deze scripts maakt u een Azure Function-app met behulp van het verbruiksplan.
# Reminder: function app and storage account names must be unique.
# Turn persisted parameters on.
az config param-persist on
# Create a resource group.
az group create --name RG2forTutorial --location westeurope
# Create an Azure storage account in the resource group omitting "--location" and "--resource-group" parameters.
az storage account create \
--name sa3fortutorial \
--sku Standard_LRS
# Create a serverless function app in the resource group omitting "--storage-account" and "--resource-group" parameters.
az functionapp create \
--name FAforTutorial \
--consumption-plan-location westeurope \
--functions-version 2
# See the stored parameter values.
az config param-persist show
6. Persistente parameters verwijderen
Gebruik de opdracht az config param-persist delete om vermeldingen te verwijderen.
# Remove a single persisted parameters entry by specifying the name, not the value
az config param-persist delete resource_group_name
# Remove all persisted parameters entries and do not prompt for confirmation
az config param-persist delete --all --yes
Belangrijk
Persistente parameters worden niet bijgewerkt wanneer een Azure-resource wordt verwijderd.
# delete a resource group
az group delete --name RG1forTutorial
# verify that the resource group no longer exists
az group list --output table
# See that the resource group name remains in persisted parameters
az config param-persist show
7. Persistente parameters uitschakelen
U kunt persistente parameters uitschakelen met behulp van de opdracht az config param-persist off, maar uw opgeslagen persistente parameters worden niet verwijderd.
# Turn persisted parameters off
az config param-persist off
# See that your persisted parameters still exist
az config param-persist show
# Try to create a new resource relying on persisted parameters and receive error "...the following arguments are required:..."
az storage account create --name SA4inAzCLI --sku Standard_LRS
8. Resources opschonen
Gebruik de opdracht az group delete om de resourcegroep en alle bijbehorende resources te verwijderen wanneer u ze niet meer nodig hebt.
az group delete --name RG1forTutorial