Příprava prostředí pro rozhraní příkazového řádku Azure

Článek
12/06/2023

V tomto kroku kurzu spustíte první příkazy Azure CLI. To zahrnuje vyhledání a nastavení aktivního předplatného a nastavení výchozích hodnot. Dozvíte se také, jak vytvořit skupiny prostředků obsahující náhodné ID, abyste vždy zajistili jedinečný název prostředku.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

K dokončení tohoto kroku kurzu potřebujete contributor nebo vyšší oprávnění ke svému předplatnému.

Instalace Azure CLI

Začněte tím, že nejprve vyberete své prostředí.

Pomocí prostředí Bash v Azure Cloud Shellu vyberte tlačítko Otevřít Cloud Shell v pravém horním rohu každého bloku kódu Azure CLI.
Pokud dáváte přednost místnímu spuštění referenčních příkazů Azure CLI, nainstalujte Azure CLI.

Aktuální verze Azure CLI je 2.63.0. Informace o nejnovější verzi najdete v tématu Poznámky k verzi. Pokud chcete najít nainstalovanou verzi a zjistit, jestli potřebujete aktualizovat, spusťte příkaz az version.

Při práci s Azure CLI existuje několik možností ověřování. Výchozí metoda ověřování v Azure CLI pro přihlášení používá webový prohlížeč a přístupový token pro přihlášení.

Spusťte příkaz az login.
```
az login
```
Pokud azure CLI může otevřít váš výchozí prohlížeč, zahájí tok autorizačního kódu a otevře výchozí prohlížeč pro načtení přihlašovací stránky Azure.

V opačném případě zahájí tok kódu zařízení a dá vám pokyn, abyste otevřeli stránku prohlížeče na https://aka.ms/deviceloginadrese . Pak zadejte kód zobrazený v terminálu.

Pokud není k dispozici žádný webový prohlížeč nebo se webový prohlížeč neotevře, můžete vynutit tok kódu zařízení pomocí příkazu az login --use-device-code.
Přihlaste se pomocí přihlašovacích údajů vašeho účtu v prohlížeči.

Vyhledání a změna aktivního předplatného

Po přihlášení k Azure CLI vždy zkontrolujte aktuální předplatné. Pokud v rámci předplatného, které preferujete, nefunguje, změňte své předplatné pomocí příkazu az account set. Tady je příklad kódu, který se má použít:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Výstup konzoly pro az account show příkaz:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Informace o skupinách prostředků

Skupina prostředků představuje kontejner prostředků Azure. K vytvoření skupiny prostředků potřebujete contributor ve svém předplatném oprávnění nebo vyšší.

Vytvoření skupiny zdrojů

V rámci předplatného musí být název skupiny prostředků jedinečný. Nejprve zkontrolujte, jestli je požadovaný název dostupný pomocí příkazu az group exists . Výstupní hodnota false znamená, že název je k dispozici.
```
az group exists --name <myUniqueRGname>
```
Pomocí příkazu az account list-locations načtěte seznam podporovaných oblastí pro vaše předplatné. Seznam dostupných umístění Azure najdete v tématu Volba správné oblasti Azure.
```
az account list-locations --query "[].{Region:name}" --output table
```
Je čas vytvořit skupinu prostředků. Použijte příkaz az group create.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Vytvoření skupiny prostředků obsahující náhodné ID

Při testování je nejlepší vytvořit skupinu prostředků obsahující náhodné ID v názvu. Přidání náhodného ID do názvu skupiny prostředků vám umožní znovu otestovat kód, aniž byste museli čekat na odebrání předchozí skupiny prostředků se stejným názvem z Azure.

Syntaxe proměnných Bash a PowerShellu se liší. Zkopírujte správný skript pro vaše prostředí.

Udeřit
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Výstup konzoly Bash a PowerShellu:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Nastavení proměnných prostředí

Azure CLI nabízí několik možností, které vám umožní opakovaně používat běžné hodnoty parametrů. Tyto výchozí hodnoty jsou uložené v proměnných prostředí a jsou jedinečné pro každé přihlášení.

Nastavte výchozí skupinu prostředků.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Nastavte více proměnných prostředí najednou.

Mnoho parametrů Azure CLI má několik hodnot oddělených mezerou. Hodnoty konfigurace jsou jednou z takových instancí. V dalším příkladu se .location .group nastaví jak výchozí hodnoty, které používají všechny příkazy Azure CLI, tak --resource-group i výchozí hodnoty, které používají --location každý příkaz Azure CLI.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Nastavte výchozí výstup.

Pokud jste se rozhodli pracovat v Azure Cloud Shellu nebo nainstalovat Azure CLI místně, výchozí výstup se automaticky nastaví na json. Toto je ale jedno z nejdůležitějších výchozích hodnot, které je potřeba pochopit a nastavit. Výstup určuje, co se zobrazí v konzole a co se zapíše do souboru protokolu. Vždy používejte výstup none při vytváření prostředků, které vracejí klíče, hesla a tajné kódy.
```
az config set core.output=none
```
V tomto kurzu nepracujeme s tajnými kódy. Nastavte výchozí hodnotu zpět, json abyste viděli vrácený výstup každého referenčního příkazu v tomto kurzu.
```
az config set core.output=json
```

Naučte se používat az init.

Azure CLI obsahuje referenční příkaz, který vás provede konfigurací vašeho prostředí. Zadejte az init konzolu a stiskněte Enter. Postupujte podle zobrazených výzev.

az init

První pěkná věc o az init je, že vám poskytne všechna vaše aktuální nastavení! Tady je příklad výstupu:

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing it's number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Vyhledejte a přečtěte si konfigurační soubor.

Pokud pracujete pod nastavením důvěryhodnosti, ale ověříte, chcete vědět, kde jsou uložené konfigurační soubory a co obsahují. Samotný konfigurační soubor je umístěný v $AZURE_CONFIG_DIR/config. Výchozí hodnota pro AZURE_CONFIG_DIR je $HOME/.azure v Linuxu a macOS a %USERPROFILE%\.azure ve Windows. Vyhledejte konfigurační soubor teď a podívejte se, co obsahuje.

Získání dalších podrobností

Chcete podrobnější informace o jednom z témat popsaných v tomto kroku kurzu? Další informace získáte pomocí odkazů v této tabulce.

Předmět	Další informace
Prostředí	Volba správného nástroje příkazového řádku Azure
Možnosti přihlášení	Přihlášení pomocí Azure CLI
Termíny	Terminologie a úrovně podpory Azure CLI
Předplatná	Správa předplatných pomocí Azure CLI
Skupiny prostředků	Správa skupin prostředků pomocí Azure CLI
Konfigurace	Konfigurace Azure CLI
Role Azure	Role Azure, role Microsoft Entra a klasické role správce předplatného

Další krok

Teď, když jste se naučili, jak nakonfigurovat prostředí, přejděte k dalšímu kroku a seznamte se se skriptovacími rozdíly mezi Bashem, PowerShellem a cmd.

Informace o rozdílech syntaxe Azure CLI v Bash, PowerShellu a Cmd

Sdílet prostřednictvím

Příprava prostředí pro rozhraní příkazového řádku Azure

Instalace Azure CLI

Vyhledání a změna aktivního předplatného

Informace o skupinách prostředků

Vytvoření skupiny zdrojů

Vytvoření skupiny prostředků obsahující náhodné ID

Nastavení proměnných prostředí

Získání dalších podrobností

Další krok

Další materiály

Sdílet prostřednictvím

Příprava prostředí pro rozhraní příkazového řádku Azure

Instalace Azure CLI

Přihlášení k Azure pomocí Azure CLI

Vyhledání a změna aktivního předplatného

Informace o skupinách prostředků

Vytvoření skupiny zdrojů

Vytvoření skupiny prostředků obsahující náhodné ID

Nastavení proměnných prostředí

Získání dalších podrobností

Další krok

Další materiály