Instalowanie interfejsu wiersza polecenia platformy Azure w usłudze Azure Stack Hub

  • Artykuł
  • Czas czytania: 12 min

Interfejs wiersza polecenia platformy Azure umożliwia zarządzanie usługą Azure Stack Hub przy użyciu maszyn z systemem Windows lub Linux. W tym artykule przedstawiono kroki instalowania i konfigurowania interfejsu wiersza polecenia platformy Azure.

Zainstaluj interfejs wiersza polecenia platformy Azure

  1. Zaloguj się do stacji roboczej deweloperów i zainstaluj interfejs wiersza polecenia. Usługa Azure Stack Hub wymaga wersji 2.0 lub nowszej interfejsu wiersza polecenia platformy Azure.

Ważne

Musisz użyć interfejsu wiersza polecenia platformy Azure w wersji 2.29.2 lub starszej z usługą Azure Stack Hub. Firma Microsoft wykryła problem z usługą Azure Stack Hub, która uniemożliwia korzystanie z interfejsu wiersza polecenia platformy Azure w wersji 2.30.0 lub nowszej.

  1. Interfejs wiersza polecenia można zainstalować, wykonując kroki opisane w artykule Instalowanie interfejsu wiersza polecenia platformy Azure .

  2. Aby sprawdzić, czy instalacja zakończyła się pomyślnie, otwórz okno terminalu lub wiersza polecenia i uruchom następujące polecenie:

    az --version

    Powinna zostać wyświetlona wersja interfejsu wiersza polecenia platformy Azure i inne zależne biblioteki zainstalowane na komputerze.

    Azure CLI on Azure Stack Hub Python location

  3. Zanotuj lokalizację języka Python interfejsu wiersza polecenia.

Dodawanie certyfikatu

Wyeksportuj, a następnie zaimportuj certyfikat usługi Azure Stack Hub do odłączonych systemów zintegrowanych i zestawu ASDK. W przypadku połączonych systemów zintegrowanych certyfikat jest podpisany publicznie i ten krok nie jest konieczny. Instrukcje można znaleźć w temacie Konfigurowanie certyfikatów dla interfejsu wiersza polecenia platformy Azure w zestawie Azure Stack Development Kit.

Nawiązywanie połączenia za pomocą interfejsu wiersza polecenia platformy Azure

W tej sekcji opisano konfigurowanie interfejsu wiersza polecenia, jeśli używasz usługi Azure AD jako usługi zarządzania tożsamościami i używasz interfejsu wiersza polecenia na maszynie z systemem Windows.

Nawiązywanie połączenia z usługą Azure Stack Hub

  1. Jeśli używasz zestawu ASDK, ufaj certyfikatowi głównemu urzędu certyfikacji usługi Azure Stack Hub. Aby uzyskać instrukcje, zobacz Ufaj certyfikatowi.

  2. Zarejestruj środowisko usługi Azure Stack Hub, uruchamiając az cloud register polecenie .

  3. Zarejestruj swoje środowisko. Podczas uruchamiania az cloud registerpolecenia użyj następujących parametrów:

    Wartość Przykład Opis
    Nazwa środowiska AzureStackUser Użyj AzureStackUser dla środowiska użytkownika. Jeśli jesteś operatorem, określ AzureStackAdminwartość .
    Punkt końcowy usługi Resource Manager https://management.contoso.onmicrosoft.com Element ResourceManagerUrl w zestawie ASDK to: https://management.local.azurestack.external/Element ResourceManagerUrl w zintegrowanych systemach: https://management.<region>.<fqdn>/ Jeśli masz pytanie dotyczące zintegrowanego punktu końcowego systemu, skontaktuj się z operatorem chmury.
    Punkt końcowy magazynu local.contoso.onmicrosoft.com local.azurestack.external jest przeznaczony dla zestawu ASDK. W przypadku zintegrowanego systemu użyj punktu końcowego dla systemu.
    Sufiks usługi Keyvault .vault.contoso.onmicrosoft.com .vault.local.azurestack.external jest przeznaczony dla zestawu ASDK. W przypadku zintegrowanego systemu użyj punktu końcowego dla systemu.
    Identyfikator zasobu grafu usługi Active Directory punktu końcowego https://graph.windows.net/ Identyfikator zasobu usługi Active Directory. 
    az cloud register `
    -n <environmentname> `
    --endpoint-resource-manager "https://management.<region>.<fqdn>" `
    --suffix-storage-endpoint "<fqdn>" `
    --suffix-keyvault-dns ".vault.<fqdn>"

    Informacje o poleceniu register można znaleźć w dokumentacji referencyjnej interfejsu wiersza polecenia platformy Azure.

  4. Ustaw aktywne środowisko przy użyciu następujących poleceń.

    az cloud set -n <environmentname>

  5. Zaktualizuj konfigurację środowiska, aby używać profilu wersji interfejsu API specyficznego dla usługi Azure Stack Hub. Aby zaktualizować konfigurację, uruchom następujące polecenie:

    az cloud update --profile 2020-09-01-hybrid

  6. Zaloguj się do środowiska usługi Azure Stack Hub przy użyciu az login polecenia .

    Możesz zalogować się do środowiska usługi Azure Stack Hub przy użyciu poświadczeń użytkownika lub jednostki usługi (SPN) dostarczonej przez operatora chmury.

    • Zaloguj się jako użytkownik:

      Możesz określić nazwę użytkownika i hasło bezpośrednio w az login poleceniu lub uwierzytelnić przy użyciu przeglądarki. Należy to zrobić, jeśli twoje konto ma włączone uwierzytelnianie wieloskładnikowe:

      az login -u "user@contoso.onmicrosoft.com" -p 'Password123!' --tenant contoso.onmicrosoft.com

      Uwaga

      Jeśli konto użytkownika ma włączone uwierzytelnianie wieloskładnikowe, użyj az login polecenia bez podawania parametru -u . Uruchomienie tego polecenia daje adres URL i kod, którego należy użyć do uwierzytelnienia.

    • Zaloguj się jako jednostka usługi:

      Przed zalogowaniem utwórz jednostkę usługi za pomocą witryny Azure Portal lub interfejsu wiersza polecenia i przypisz ją do roli. Teraz zaloguj się przy użyciu następującego polecenia:

      az login `
  --tenant <Azure Active Directory Tenant name. `
            For example: myazurestack.onmicrosoft.com> `
--service-principal `
  -u <Application Id of the Service Principal> `
  -p <Key generated for the Service Principal>

  7. Sprawdź, czy środowisko jest poprawnie ustawione i czy środowisko jest aktywną chmurą.

        az cloud list --output table

Powinno zostać wyświetlone twoje środowisko, a wartość IsActive to true. Przykład:

IsActive    Name               Profile
----------  -----------------  -----------------
False       AzureCloud         2020-09-01-hybrid
False       AzureChinaCloud    latest
False       AzureUSGovernment  latest
False       AzureGermanCloud   latest
True        AzureStackUser     2020-09-01-hybrid

Testowanie połączenia

Po skonfigurowaniu wszystkiego użyj interfejsu wiersza polecenia, aby utworzyć zasoby w usłudze Azure Stack Hub. Można na przykład utworzyć grupę zasobów dla aplikacji i dodać maszynę wirtualną. Użyj następującego polecenia, aby utworzyć grupę zasobów o nazwie "MyResourceGroup":

az group create -n MyResourceGroup -l local

Jeśli grupa zasobów zostanie utworzona pomyślnie, poprzednie polecenie wyświetli następujące właściwości nowo utworzonego zasobu:

{
  "id": "/subscriptions/84edee99-XXXX-4f5c-b646-5cdab9759a03/resourceGroups/RGCL11",
  "location": "local",
  "name": "RGCLI1",
  " properties ": {
    "provisioningState": "Succeeded"
  },
  "tags ": null
}

Następne kroki