Udostępnij za pośrednictwem

Przygotuj swoje środowisko dla 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 platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

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

Instalacja Azure CLI

Zacznij od wybrania środowiska.

  • Aby skorzystać ze środowiska Bash w Azure Cloud Shell, wybierz przycisk Otwórz okno Cloud Shell w prawym górnym rogu każdego bloku kodu Azure CLI.

  • Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia platformy Azure lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure.

Bieżąca wersja interfejsu wiersza polecenia platformy Azure to 2.75.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 za pomocą Azure CLI

Istnieje kilka opcji uwierzytelniania podczas pracy z interfejsem wiersza polecenia platformy Azure. Domyślna metoda uwierzytelniania Azure CLI podczas logowania wykorzystuje przeglądarkę internetową i token dostępu.

  1. Uruchom polecenie az login.

    az login

    Jeśli interfejs wiersza polecenia platformy Azure może otworzyć domyślną przeglądarkę, inicjuje przepływ kodu autoryzacji i otwiera domyślną przeglądarkę, aby załadować stronę logowania platformy 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 interfejsu wiersza polecenia platformy Azure 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 zasobów platformy Azure. 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 uzyskać listę dostępnych lokalizacji platformy Azure, zobacz Wybieranie odpowiedniego regionu świadczenia usługi Azure.

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

Interfejs wiersza polecenia platformy Azure 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 przyjmuje wiele wartości rozdzielonych spacją. Wartości konfiguracji są jednym z takich wystąpień. W następnym przykładzie ustawiane są zarówno .location, jak i .group jako wartości domyślne, które są 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 usłudze Azure Cloud Shell lub zainstalować interfejs wiersza polecenia platformy Azure lokalnie, domyślne dane wyjściowe zostaną 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.

    Interfejs wiersza polecenia platformy Azure 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 systemie 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 Wybieranie odpowiedniego narzędzia wiersza polecenia platformy Azure
Opcje logowania Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure
Regulamin Terminologia interfejsu wiersza polecenia platformy Azure i poziomy pomocy technicznej
Subskrypcje Zarządzanie subskrypcjami przy użyciu interfejsu wiersza polecenia platformy Azure
Grupy zasobów Zarządzanie grupami zasobów przy użyciu interfejsu wiersza polecenia platformy Azure
Konfiguracje Konfigurowanie interfejsu wiersza polecenia platformy Azure
Role na platformie Azure Role platformy 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.

Poznaj różnice składni Azure CLI w Bash, PowerShell i Cmd