Udostępnij za pośrednictwem


Przygotowywanie środowiska do Azure CLI

W tym kroku samouczka wykonasz pierwsze polecenia Azure CLI. Obejmuje to znajdowanie i ustawianie aktywnej subskrypcji oraz ustawianie wartości domyślnych. Dowiesz się również, jak tworzyć grupy zasobów zawierające losowy identyfikator, aby zawsze zagwarantować unikatową nazwę zasobu.

Jeśli nie masz subskrypcji Azure utwórz bezpłatne konto Azure przed rozpoczęciem.

Aby ukończyć ten krok samouczka, potrzebujesz contributor lub wyższych uprawnień w ramach subskrypcji.

Instalowanie Azure CLI

Zacznij od wybrania środowiska.

  • Użyj środowiska powłoki Bash w Azure Cloud Shell wybierając przycisk Otwórz Cloud Shell w prawym górnym rogu każdego bloku kodu Azure CLI.

  • Jeśli wolisz uruchomić polecenia Azure CLI lokalnie, zainstaluj Azure CLI.

Bieżąca wersja Azure CLI to 2.84.0. Aby uzyskać informacje o najnowszej wersji, zobacz informacje o wersji. Aby znaleźć zainstalowaną wersję i sprawdzić, czy chcesz ją zaktualizować, uruchom polecenie az version.

Zaloguj się do Azure przy użyciu Azure CLI

Istnieje kilka opcji uwierzytelniania podczas pracy z Azure CLI. Domyślna metoda uwierzytelniania Azure CLI dla logowań używa przeglądarki internetowej i tokenu dostępu do logowania.

  1. Uruchom polecenie az login.

    az login
    

    Jeśli Azure CLI może otworzyć domyślną przeglądarkę, inicjuje przepływ kodu autoryzacyjnego i otwiera domyślną przeglądarkę, aby załadować stronę logowania Azure.

    W przeciwnym razie inicjuje przepływ kodu urządzenia i nakazuje otwarcie strony przeglądarki pod adresem https://aka.ms/devicelogin. Następnie wprowadź kod wyświetlany w terminalu.

    Jeśli żadna przeglądarka internetowa nie jest dostępna lub nie można otworzyć przeglądarki internetowej, możesz wymusić przepływ kodu urządzenia za pomocą polecenia az login --use-device-code.

  2. Zaloguj się w przeglądarce, używając danych swojego konta.

Znajdowanie i zmienianie aktywnej subskrypcji

Po zalogowaniu się do Azure CLI zawsze sprawdź bieżącą subskrypcję. Jeśli nie pracujesz w ramach preferowanej subskrypcji, zmień subskrypcję przy użyciu polecenia az account set. Oto przykładowy kod do użycia:

# 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>

Dane wyjściowe konsoli dla az account show polecenia:

{
  "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"
  }
}

Dowiedz się więcej o grupach zasobów

Grupa zasobów to kontener dla Azure zasobów. Aby utworzyć grupę zasobów, musisz mieć contributor uprawnienia lub wyższe w ramach subskrypcji.

Tworzenie grupy zasobów

  1. W ramach subskrypcji nazwa grupy zasobów musi być unikatowa. Najpierw sprawdź, czy wybrana nazwa jest dostępna za pomocą polecenia az group exists. Wartość wyjściowa false oznacza, że nazwa jest dostępna.

    az group exists --name <myUniqueRGname>
    
  2. Pobierz listę obsługiwanych regionów dla subskrypcji za pomocą polecenia az account list-locations . Aby zapoznać się z listą dostępnych lokalizacji Azure, zobacz Wybierz odpowiedni region Azure dla siebie.

    az account list-locations --query "[].{Region:name}" --output table
    
  3. Nadszedł czas, aby utworzyć grupę zasobów. Użyj polecenia az group create .

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

Tworzenie grupy zasobów zawierającej losowy identyfikator

Podczas testowania najlepiej utworzyć grupę zasobów zawierającą losowy identyfikator w nazwie. Dodanie losowego identyfikatora do nazwy grupy zasobów umożliwia ponowne testowanie kodu bez konieczności oczekiwania na usunięcie wcześniejszej grupy zasobów o tej samej nazwie z Azure.

Składnia zmiennych powłoki Bash i programu PowerShell jest inna. Skopiuj prawidłowy skrypt dla środowiska.

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

Wynik konsoli Bash i PowerShell:

{
  "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"
}

Ustawianie zmiennych środowiskowych

Azure CLI oferuje kilka opcji umożliwiających ponowne użycie typowych wartości parametrów. Te wartości domyślne są przechowywane w zmiennych środowiskowych i są unikatowe dla każdego logowania.

  1. Ustaw domyślną grupę zasobów.

    az config set defaults.group=<msdocs-tutorial-rg-0000000>
    
  2. Ustaw jednocześnie wiele zmiennych środowiskowych.

    Wiele parametrów Azure CLI ma wiele wartości rozdzielonych spacją. Wartości konfiguracji są jednym z takich wystąpień. W następnym przykładzie ustawiono wartości domyślne .location i .group używane przez parametry --location i --resource-group każdego polecenia Azure CLI.

    az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
    
  3. Ustaw domyślne dane wyjściowe.

    Jeśli zdecydujesz się pracować w Azure Cloud Shell lub zainstalować Azure CLI lokalnie, domyślne dane wyjściowe są automatycznie ustawione na json. To ustawienie jest jednak jedną z najważniejszych wartości domyślnych do zrozumienia i ustawienia. Dane wyjściowe określają, co pojawia się na konsoli i co jest zapisywane do pliku dziennika. Zawsze używaj wyniku none podczas tworzenia zasobów, które zwracają klucze, hasła i sekrety.

    az config set core.output=none
    

    W tym samouczku nie pracujemy z tajemnicami. Ustaw wartość domyślną na json, aby zobaczyć zwracane dane wyjściowe każdego polecenia w tym samouczku.

    az config set core.output=json
    
  4. Dowiedz się, jak używać az init.

    Azure CLI zawiera polecenie referencyjne, które przeprowadzi Cię przez proces konfigurowania środowiska. Wpisz az init w konsoli i naciśnij Enter. Postępuj zgodnie z podanymi monitami.

    az init
    

    Ważnym aspektem az init jest to, że wyświetla wszystkie bieżące ustawienia. Oto przykład danych wyjściowych:

    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. Znajdź i odczytaj plik konfiguracji.

    Jeśli pracujesz według zasady "ufaj, ale sprawdzaj", chcesz wiedzieć, gdzie są przechowywane pliki konfiguracyjne i co zawierają. Sam plik konfiguracji znajduje się w lokalizacji $AZURE_CONFIG_DIR/config. Wartość domyślna AZURE_CONFIG_DIR to $HOME/.azure w systemach Linux i macOS oraz %USERPROFILE%\.azure w Windows. Znajdź plik konfiguracji i przejrzyj jego zawartość.

Uzyskaj więcej szczegółów

Czy chcesz uzyskać więcej szczegółów na temat jednego z zagadnień omówionych w tym kroku samouczka? Skorzystaj z linków w tej tabeli, aby dowiedzieć się więcej.

Temat Dowiedz się więcej
Środowiska Wybierz odpowiednie narzędzie wiersza polecenia Azure
Opcje logowania Sign in with Azure CLI
Regulamin Azure CLI terminologia i poziomy pomocy technicznej
Subskrypcje Zarządzanie subskrypcjami przy użyciu Azure CLI
Grupy zasobów Zarządzanie grupami zasobów przy użyciu Azure CLI
Konfiguracje Konfiguruj Azure CLI
** Role Azure role Azure, role Microsoft Entra i klasyczne role administratora subskrypcji

Następny krok

Teraz, gdy wiesz już, jak skonfigurować środowisko, przejdź do następnego kroku, aby zrozumieć różnice skryptów między powłoką Bash, programem PowerShell i Cmd.exe.