Instalace rozhraní příkazového řádku Azure CLI do centra Azure StackInstall Azure CLI on Azure Stack Hub

  • 11 min ke čtení

Rozhraní příkazového řádku Azure můžete nainstalovat pro správu centra Azure Stack s počítači se systémem Windows nebo Linux.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. Tento článek vás provede kroky instalace a nastavení Azure CLI.This article walks you through the steps of installing and setting up Azure CLI.

Instalace rozhraní příkazového řádku Azure CLIInstall Azure CLI

  1. Přihlaste se k vývojové pracovní stanici a nainstalujte rozhraní příkazového řádku.Sign in to your development workstation and install CLI. Azure Stack hub vyžaduje Azure CLI verze 2,0 nebo novější.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. Rozhraní příkazového řádku můžete nainstalovat pomocí postupu popsaného v článku instalace Azure CLI .You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. Chcete-li ověřit, zda byla instalace úspěšná, otevřete okno terminálu nebo příkazového řádku a spusťte následující příkaz:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version

    Měla by se zobrazit verze rozhraní příkazového řádku Azure CLI a dalších závislých knihoven, které jsou nainstalované ve vašem počítači.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    Rozhraní příkazového řádku Azure v umístění Pythonu centra Azure Stack

  4. Poznamenejte si umístění Pythonu pro rozhraní příkazového řádku.Make a note of the CLI's Python location. Pokud používáte ASDK, musíte k přidání certifikátu použít toto umístění.If you're running the ASDK, you need to use this location to add your certificate. Pokyny k nastavení certifikátů pro instalaci rozhraní příkazového řádku na ASDK najdete v tématu nastavení certifikátů pro Azure CLI v Azure Stack Development Kit.For instructions on setting up certificates for installing the CLI on the ASDK, see Setting up certificates for Azure CLI on Azure Stack Development Kit.

Připojení pomocí Azure CLIConnect with Azure CLI

V této části se dozvíte, jak nastavit rozhraní příkazového řádku, pokud používáte Azure AD jako službu pro správu identit a používáte rozhraní příkazového řádku v počítači s Windows.This section walks you through setting up CLI if you're using Azure AD as your identity management service, and are using CLI on a Windows machine.

Připojení k centru Azure StackConnect to Azure Stack Hub

  1. Pokud používáte ASDK, důvěřovat kořenovému certifikátu certifikační autority centra Azure Stack.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Pokyny najdete v tématu důvěryhodnost certifikátu.For instruction, see Trust the certificate.

  2. Zaregistrujte své prostředí Azure Stackového centra spuštěním az cloud register příkazu.Register your Azure Stack Hub environment by running the az cloud register command.

  3. Zaregistrujte své prostředí.Register your environment. Při spuštění použijte následující parametry az cloud register :Use the following parameters when running az cloud register:

    HodnotaValue PříkladExample PopisDescription
    Název prostředíEnvironment name AzureStackUserAzureStackUser Použijte AzureStackUser pro uživatelské prostředí.Use AzureStackUser for the user environment. Pokud jste operátor, zadejte AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    Správce prostředků koncový bodResource Manager endpoint https://management.contoso.onmicrosoft.com ResourceManagerUrl v ASDK je: https://management.local.azurestack.external/ ResourceManagerUrl v integrovaných systémech je: https://management.<region>.<fqdn>/ Pokud máte dotaz týkající se integrovaného systémového koncového bodu, obraťte se na svého operátora cloudu.The ResourceManagerUrl in the ASDK is: https://management.local.azurestack.external/ The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    Koncový bod úložištěStorage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external je pro rozhraní ASDK.local.azurestack.external is for the ASDK. Pro integrovaný systém použijte pro svůj systém koncový bod.For an integrated system, use an endpoint for your system.
    Přípona trezoru klíčůKeyvault suffix . vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external je pro rozhraní ASDK..vault.local.azurestack.external is for the ASDK. Pro integrovaný systém použijte pro svůj systém koncový bod.For an integrated system, use an endpoint for your system.
    ID prostředku grafu služby Active Directory koncového boduEndpoint active directory graph resource ID https://graph.windows.net/ Identifikátor prostředku služby Azure Active Directory.The Active Directory resource ID. 
    az cloud register `
    -n <environmentname> `
    --endpoint-resource-manager "https://management.<region>.<fqdn>" `
    --suffix-storage-endpoint "<fqdn>" `
    --suffix-keyvault-dns ".vault.<fqdn>" `
    --endpoint-active-directory-graph-resource-id "https://graph.windows.net/"

    Odkaz na příkaz Register najdete v referenční dokumentaci k Azure CLI.You can find a reference for the register command in the Azure CLI reference documentation.

  4. Nastavte aktivní prostředí pomocí následujících příkazů.Set the active environment by using the following commands.

    az cloud set -n <environmentname>

  5. Aktualizujte konfiguraci prostředí tak, aby používala profil konkrétní verze rozhraní API centra Azure Stack.Update your environment configuration to use the Azure Stack Hub specific API version profile. Chcete-li aktualizovat konfiguraci, spusťte následující příkaz:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid

  6. Přihlaste se k prostředí Azure Stackového centra pomocí az login příkazu.Sign in to your Azure Stack Hub environment by using the az login command.

    K prostředí centra Azure Stack se můžete přihlásit pomocí přihlašovacích údajů uživatele nebo pomocí instančního objektu , který vám poskytl operátor cloudu.You can sign in to the Azure Stack Hub environment using your user credentials, or with a service principal (SPN) provided to you by your cloud operator.

    • Přihlaste se jako uživatel:Sign in as a user:

      Můžete buď zadat uživatelské jméno a heslo přímo v rámci az login příkazu, nebo ověřit pomocí prohlížeče.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Pokud má váš účet povolené ověřování Multi-Factor Authentication, musíte to udělat:You must do the latter if your account has multi-factor authentication enabled:

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

      Poznámka

      Pokud má váš uživatelský účet povolený službu Multi-Factor Authentication, použijte az login příkaz bez zadání -u parametru.If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. Spuštěním tohoto příkazu získáte adresu URL a kód, který je nutné použít k ověření.Running this command gives you a URL and a code that you must use to authenticate.

    • Přihlaste se jako instanční objekt:Sign in as a service principal:

      Než se přihlásíte, vytvořte instanční objekt pomocí Azure Portal nebo rozhraní příkazového řádku a přiřaďte mu roli.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Teď se přihlaste pomocí následujícího příkazu:Now, sign in by using the following command:

      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. Ověřte, že je vaše prostředí správně nastavené a že vaše prostředí je aktivním cloudem.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table

Měli byste vidět, že je vaše prostředí uvedené a je aktivní true .You should see that your environment is listed and IsActive is true. Například:For example:

IsActive    Name               Profile
----------  -----------------  -----------------
False       AzureCloud         2019-03-01-hybrid
False       AzureChinaCloud    latest
False       AzureUSGovernment  latest
False       AzureGermanCloud   latest
True        AzureStackUser     2019-03-01-hybrid

Testování připojeníTest the connectivity

Když máte všechno nastavené, pomocí rozhraní příkazového řádku můžete vytvářet prostředky v rámci centra Azure Stack.With everything set up, use CLI to create resources within Azure Stack Hub. Můžete například vytvořit skupinu prostředků pro aplikaci a přidat virtuální počítač.For example, you can create a resource group for an app and add a VM. Pomocí následujícího příkazu vytvořte skupinu prostředků s názvem "MyResourceGroup":Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Pokud je skupina prostředků úspěšně vytvořená, předchozí příkaz vytvoří výstup následujících vlastností nově vytvořeného prostředku:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Skupina prostředků – vytvořit výstup

Další krokyNext steps