Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
Uruchom polecenie
az login.az loginJeś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.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
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
falseoznacza, ż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 zapoznać się z listą dostępnych lokalizacji Azure, zobacz Wybierz odpowiedni region Azure dla siebie.
az account list-locations --query "[].{Region:name}" --output tableNadszedł 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.
Ustaw domyślną grupę zasobów.
az config set defaults.group=<msdocs-tutorial-rg-0000000>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
.locationi.groupużywane przez parametry--locationi--resource-groupkażdego polecenia Azure CLI.az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>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 wynikunonepodczas tworzenia zasobów, które zwracają klucze, hasła i sekrety.az config set core.output=noneW 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=jsonDowiedz się, jak używać
az init.Azure CLI zawiera polecenie referencyjne, które przeprowadzi Cię przez proces konfigurowania środowiska. Wpisz
az initw konsoli i naciśnij Enter. Postępuj zgodnie z podanymi monitami.az initWaż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: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ślnaAZURE_CONFIG_DIRto$HOME/.azurew systemach Linux i macOS oraz%USERPROFILE%\.azurew 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.