Przygotowywanie środowiska dla interfejsu wiersza polecenia platformy Azure

Artykuł
12/06/2023

W tym kroku samouczka wykonasz pierwsze polecenia interfejsu wiersza polecenia platformy Azure. 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.

Instalowanie interfejsu wiersza polecenia platformy Azure

Rozpocznij od pierwszego wybrania środowiska.

Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell , wybierając przycisk Otwórz usługę Cloud Shell w prawym górnym rogu bloku kodu interfejsu wiersza polecenia platformy Azure.
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.60.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.

Istnieje kilka opcji uwierzytelniania podczas pracy z interfejsem wiersza polecenia platformy Azure. Domyślna metoda uwierzytelniania interfejsu wiersza polecenia platformy Azure do logowania używa przeglądarki internetowej i tokenu dostępu.

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 przeglądarka internetowa nie zostanie otwarta, możesz wymusić przepływ kodu urządzenia za pomocą polecenia az login --use-device-code.
Zaloguj się w przeglądarce przy użyciu poświadczeń 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 jest kontenerem zasobów platformy Azure. Aby utworzyć grupę zasobów, musisz mieć contributor uprawnienia lub wyższe w ramach subskrypcji.

Tworzenie grupy zasobów

W ramach subskrypcji nazwa grupy zasobów musi być unikatowa. Najpierw sprawdź, czy wybrana nazwa jest dostępna przy użyciu polecenia az group exists . Wartość wyjściowa false oznacza, że nazwa jest dostępna.
```
az group exists --name <myUniqueRGname>
```
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
```
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.

Bash
Program 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

Dane wyjściowe powłoki Bash i konsoli programu 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.

Ustaw domyślną grupę zasobów.

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

Ustaw jednocześnie wiele zmiennych środowiskowych.

Wiele parametrów interfejsu wiersza polecenia platformy Azure dzieli wiele wartości rozdzielonych spacją. Wartości konfiguracji są jednym z takich wystąpień. W następnym przykładzie ustawiane są zarówno .location wartości domyślne, jak i .group używane przez --location parametry i --resource-group każdego polecenia interfejsu wiersza polecenia platformy Azure.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Ustaw domyślne dane wyjściowe.

Jeśli zdecydujesz się pracować w usłudze Azure Cloud Shell lub zainstalujesz interfejs wiersza polecenia platformy Azure lokalnie, domyślne dane wyjściowe zostaną automatycznie ustawione na json. Jest to jednak jedno z najważniejszych wartości domyślnych do zrozumienia i ustawienia. Dane wyjściowe określają, co pojawia się w konsoli programu i co jest zapisywane w pliku dziennika. Zawsze używaj danych wyjściowych none podczas tworzenia zasobów, które zwracają klucze, hasła i wpisy tajne.
```
az config set core.output=none
```
W tym samouczku nie pracujemy z wpisami tajnymi. Ustaw wartość domyślną json na , aby zobaczyć zwrócone dane wyjściowe każdego polecenia referencyjnego w tym samouczku.
```
az config set core.output=json
```

Dowiedz się, jak używać polecenia az init.

Interfejs wiersza polecenia platformy Azure zawiera polecenie referencyjne, które przeprowadzi Cię przez proces konfigurowania środowiska. Wpisz az init ciąg w konsoli i naciśnij klawisz Enter. Postępuj zgodnie z podanymi monitami.

az init

Pierwszą miłą rzeczą na temat az init jest to, że daje wszystkie bieżące ustawienia! Oto przykładowe dane wyjściowe:

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:

Znajdź i odczytaj plik konfiguracji.

Jeśli pracujesz w ramach "zaufania, ale weryfikujesz" sposób myślenia, chcesz wiedzieć, gdzie są przechowywane pliki konfiguracji i jakie zawierają. Sam plik konfiguracji znajduje się w ścieżce $AZURE_CONFIG_DIR/config. Wartość domyślna zmiennej AZURE_CONFIG_DIR to $HOME/.azure w systemie Linux oraz macOS i %USERPROFILE%\.azure w systemie Windows. Znajdź plik konfiguracji teraz i zobacz, co zawiera.

Uzyskaj więcej szczegółów

Czy chcesz uzyskać więcej szczegółowych informacji na temat jednego z tematów 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
Terminy	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 entra firmy Microsoft i klasyczne role administratora subskrypcji

Następny krok

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

Poznaj różnice składni interfejsu wiersza polecenia platformy Azure w powłokach Bash, programie PowerShell i programie Cmd