Sdílet prostřednictvím


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

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.

Nainstalujte Azure CLI

Začněte tím, že vyberete 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.81.0. Informace o nejnovější verzi najdete v poznámkách k verzi . Pokud chcete najít nainstalovanou verzi a zjistit, jestli potřebujete aktualizovat, spusťte příkaz az version.

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

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í.

  1. 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í s az login --use-device-code.

  2. 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 nepracujete v rámci předplatného, které preferujete, 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"
  }
}

Seznamte se se skupinami prostředků

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

Vytvoření skupiny zdrojů

  1. V rámci předplatného musí být název skupiny prostředků jedinečný. Nejprve pomocí příkazu az group exists zkontrolujte, jestli je požadovaný název dostupný. Výstupní hodnota false znamená, že název je k dispozici.

    az group exists --name <myUniqueRGname>
    
  2. 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
    
  3. Nyní je čas vytvořit skupinu prostředků. Použijte příkaz az group create .

    az group create --location <myLocation> --name <myUniqueRGname>
    

Vytvořit skupinu prostředků obsahující náhodné ID

Při testování je nejlepší vytvořit skupinu prostředků, která obsahuje 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í.

let "randomIdentifier=$RANDOM*$RANDOM"
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í.

  1. Nastavte výchozí skupinu prostředků.

    az config set defaults.group=<msdocs-tutorial-rg-0000000>
    
  2. 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 jsou nastaveny výchozí hodnoty jak pro .location a .group, které využívají parametry --location a --resource-group každého příkazu Azure CLI.

    az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
    
  3. Nastavte výchozí výstup.

    Když se rozhodnete pracovat v Azure Cloud Shellu nebo nainstalovat Azure CLI místně, výchozí výstup se automaticky nastaví na json. Toto nastavení je ale jedním z nejdůležitějších výchozích hodnot pro pochopení a nastavení. 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
    
  4. 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 do konzole a stiskněte Enter. Postupujte podle zobrazených výzev.

    az init
    

    Důležitým aspektem az init je, že zobrazuje 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 its 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: 
    
  5. Vyhledejte a přečtěte si konfigurační soubor.

    Pokud pracujete s přístupem „důvěřuj, ale prověřuj“, chcete vědět, kde jsou uloženy vaše 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 a zkontrolujte jeho obsah.

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
Podmínky Terminologie a úrovně podpory Azure CLI
Předplatná Správa předplatných pomocí Azure CLI
Skupiny zdrojů 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 dozvěděli, jak nakonfigurovat prostředí, přejděte k dalšímu kroku, abyste porozuměli rozdílům skriptování mezi prostředím Bash, PowerShellem a Cmd.exe.