Erőforrások kezelése és üzembe helyezése az Azure Stack Hubon az Azure CLI-velManage and deploy resources to Azure Stack Hub with Azure CLI

A következőkre vonatkozik: Azure Stack hub integrált rendszerekApplies to: Azure Stack Hub integrated systems

A cikk lépéseit követve állítsa be az Azure Command-Line Interface (CLI) eszközt a Azure Stack hub-erőforrások Linux, Mac és Windows rendszerű ügyfélszámítógépeken való kezeléséhez.Follow the steps in this article to set up the Azure Command-Line Interface (CLI) to manage Azure Stack Hub resources from Linux, Mac, and Windows client platforms.

Felkészülés az Azure CLI-rePrepare for Azure CLI

A virtuális gép aliasok végpontja egy aliast (például "UbuntuLTS" vagy "Win2012Datacenter") biztosít.The virtual machine aliases endpoint provides an alias, like "UbuntuLTS" or "Win2012Datacenter." Ez az alias a virtuális gépek telepítésekor egyetlen paraméterként hivatkozik a lemezkép-közzétevőre, az ajánlatra, az SKU-ra és a verzióra.This alias references an image publisher, offer, SKU, and version as a single parameter when deploying VMs.

A következő szakasz a virtuális gép aliasok végpontjának beállítását ismerteti.The following section describes how to set up the virtual machine aliases endpoint.

A virtuális gép aliasnevei végpont beállításaSet up the virtual machine aliases endpoint

Beállíthat egy nyilvánosan elérhető végpontot, amely egy virtuálisgép-alias fájlt üzemeltet.You can set up a publicly accessible endpoint that hosts a VM alias file. A VM-alias fájl egy olyan JSON-fájl, amely a rendszerkép köznapi nevét adja meg.The VM alias file is a JSON file that provides a common name for an image. A nevet akkor használja, ha a virtuális gépet Azure CLI-paraméterként telepíti.You use the name when you deploy a VM as an Azure CLI parameter.

  1. Ha egyéni rendszerképet tesz közzé, jegyezze fel a közzététel során megadott kiadói, ajánlati, SKU-és verziószám-információkat.If you publish a custom image, make note of the publisher, offer, SKU, and version information that you specified during publishing. Ha ez egy rendszerkép a piactéren, megtekintheti az adatokat a Get-AzureVMImage parancsmag használatával.If it's an image from the Marketplace, you can view the information by using the Get-AzureVMImage cmdlet.

  2. Töltse le a mintát a githubról.Download the sample file from GitHub.

  3. Hozzon létre egy Storage-fiókot Azure Stack központban.Create a storage account in Azure Stack Hub. Ha elkészült, hozzon létre egy BLOB-tárolót.When that's done, create a blob container. Állítsa be a hozzáférési házirendet a "Public" értékre.Set the access policy to "public."

  4. Töltse fel a JSON-fájlt az új tárolóba.Upload the JSON file to the new container. Ha elkészült, megtekintheti a blob URL-címét.When that's done, you can view the URL of the blob. Jelölje ki a blob nevét, majd válassza ki az URL-címet a blob tulajdonságai között.Select the blob name and then selecting the URL from the blob properties.

PARANCSSORI felület telepítése vagy frissítéseInstall or upgrade CLI

Jelentkezzen be a fejlesztői munkaállomásra, és telepítse a CLI-t.Sign in to your development workstation and install CLI. Azure Stack hub esetében az Azure CLI 2,0-es vagy újabb verziójára van szükség.Azure Stack Hub requires version 2.0 or later of Azure CLI. Az API-profilok legújabb verziójának a parancssori felület aktuális verzióját kell megadnia.The latest version of the API Profiles requires a current version of the CLI. A CLI-t az Azure CLI telepítése című cikkben ismertetett lépések segítségével telepítheti.You install the CLI by using the steps described in the Install the Azure CLI article.

Annak ellenőrzéséhez, hogy a telepítés sikeres volt-e, nyisson meg egy terminált vagy egy parancssorablakot, és futtassa a következő parancsot:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

az --version

Ekkor meg kell jelennie az Azure CLI és a számítógépre telepített egyéb függő kódtárak verziójának.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

Azure CLI Azure Stack hub Python-helyen

Windows/Linux (Azure AD)Windows/Linux (Azure AD)

Ez a szakasz végigvezeti a parancssori felület beállításán, ha az Azure AD-t használja Identity Management szolgáltatásként, és Windows/Linux rendszerű számítógépen használja a CLI-t.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/Linux machine.

Kapcsolódás Azure Stack hubhozConnect to Azure Stack Hub

  1. Regisztrálja Azure Stack hub-környezetét a az cloud register parancs futtatásával.Register your Azure Stack Hub environment by running the az cloud register command.

  2. Regisztrálja a környezetét.Register your environment. A következő paraméterek használata a futtatásakor az cloud register :Use the following parameters when running az cloud register:

    ÉrtékValue PéldaExample LeírásDescription
    Környezet neveEnvironment name AzureStackUserAzureStackUser AzureStackUserA felhasználói környezethez használható.Use AzureStackUser for the user environment. Ha az operátor van megadva, akkor a ( AzureStackAdmin ) lehetőséget.If you're operator, specify AzureStackAdmin.
    Resource Manager-végpontResource Manager endpoint https://management.local.azurestack.external Az integrált rendszerek ResourceManagerUrl : https://management.<region>.<fqdn>/ Ha kérdése van az integrált rendszer-végponttal kapcsolatban, forduljon a felhő üzemeltetőjéhez.The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    Tárolási végpontStorage endpoint helyi. azurestack. externallocal.azurestack.external Integrált rendszer esetén használjon végpontot a rendszer számára.For an integrated system, use an endpoint for your system.
    Kulcstartó utótagjaKeyvault suffix . Vault. local. azurestack. external.vault.local.azurestack.external Integrált rendszer esetén használjon végpontot a rendszer számára.For an integrated system, use an endpoint for your system.
    VM-rendszerkép aliasa doc-végpont –VM image alias doc endpoint- https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json A virtuális gép rendszerképének aliasait tartalmazó dokumentum URI azonosítója.URI of the document, which contains VM image aliases. További információ: set up the VM aliass Endpoint.For more info, see Set up the VM aliases endpoint.
    az cloud register -n <environmentname> --endpoint-resource-manager "https://management.local.azurestack.external" --suffix-storage-endpoint "local.azurestack.external" --suffix-keyvault-dns ".vault.local.azurestack.external" --endpoint-vm-image-alias-doc <URI of the document which contains VM image aliases>
    
  3. Állítsa be az aktív környezetet az alábbi parancsok használatával.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  4. Frissítse környezeti konfigurációját az Azure Stack Hub-specifikus API-verzió profiljának használatára.Update your environment configuration to use the Azure Stack Hub specific API version profile. A konfiguráció frissítéséhez futtassa a következő parancsot:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  5. Jelentkezzen be az Azure Stack hub-környezetbe a az login paranccsal.Sign in to your Azure Stack Hub environment by using the az login command. Jelentkezzen be az Azure Stack hub-környezetbe felhasználóként vagy egyszerű szolgáltatásnévként.Sign in to the Azure Stack Hub environment either as a user or as a service principal.

    • Bejelentkezés felhasználóként:Sign in as a user:

      Megadhatja a felhasználónevet és a jelszót közvetlenül a az login parancson belül, vagy egy böngészőben végezheti el a hitelesítést.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Ha a fiókjában engedélyezve van a többtényezős hitelesítés, az utóbbit el kell végeznie:You must do the latter if your account has multi-factor authentication enabled:

      az login -u <Active directory global administrator or user account. For example: username@<aadtenant>.onmicrosoft.com> --tenant <Azure Active Directory Tenant name. For example: myazurestack.onmicrosoft.com>
      

      Megjegyzés

      Ha a felhasználói fiókja engedélyezte a többtényezős hitelesítést, a az login paraméter megadása nélkül használja a parancsot -u .If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. A parancs futtatásával egy URL-címet és egy kódot kell használnia a hitelesítéshez.Running this command gives you a URL and a code that you must use to authenticate.

    • Bejelentkezés egyszerű szolgáltatásként:Sign in as a service principal:

      A bejelentkezés előtt hozzon létre egy egyszerű szolgáltatásnevet a Azure Portal vagy a parancssori felület használatával, és rendeljen hozzá egy szerepkört.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Most jelentkezzen be a következő parancs használatával: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>
      

Kapcsolat teszteléseTest the connectivity

Minden beállításnál a CLI használatával hozhat létre erőforrásokat Azure Stack hub-on belül.With everything set up, use CLI to create resources within Azure Stack Hub. Létrehozhat például egy erőforráscsoportot egy alkalmazáshoz, és hozzáadhat egy virtuális gépet.For example, you can create a resource group for an app and add a VM. A következő parancs használatával hozzon létre egy "MyResourceGroup" nevű erőforráscsoportot:Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Ha az erőforráscsoport sikeresen létrejött, az előző parancs kimenete az újonnan létrehozott erőforrás következő tulajdonságait eredményezi:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Erőforráscsoport kimenet létrehozása

Windows/Linux (AD FS)Windows/Linux (AD FS)

Ez a szakasz végigvezeti a parancssori felület beállításán, ha Active Directory összevont szolgáltatásokat (AD FS) használja az identitáskezelési szolgáltatásként, és Windows/Linux rendszerű számítógépen használja a CLI-t.This section walks you through setting up CLI if you're using Active Directory Federated Services (AD FS) as your identity management service, and are using CLI on a Windows/Linux machine.

Kapcsolódás Azure Stack hubhozConnect to Azure Stack Hub

  1. Regisztrálja Azure Stack hub-környezetét a az cloud register parancs futtatásával.Register your Azure Stack Hub environment by running the az cloud register command.

  2. Regisztrálja a környezetét.Register your environment. A következő paraméterek használata a futtatásakor az cloud register :Use the following parameters when running az cloud register:

    ÉrtékValue PéldaExample LeírásDescription
    Környezet neveEnvironment name AzureStackUserAzureStackUser AzureStackUserA felhasználói környezethez használható.Use AzureStackUser for the user environment. Ha az operátor van megadva, akkor a ( AzureStackAdmin ) lehetőséget.If you're operator, specify AzureStackAdmin.
    Resource Manager-végpontResource Manager endpoint https://management.local.azurestack.external Az integrált rendszerek ResourceManagerUrl : https://management.<region>.<fqdn>/ Ha kérdése van az integrált rendszer-végponttal kapcsolatban, forduljon a felhő üzemeltetőjéhez.The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    Tárolási végpontStorage endpoint helyi. azurestack. externallocal.azurestack.external Integrált rendszer esetén használjon végpontot a rendszer számára.For an integrated system, use an endpoint for your system.
    Kulcstartó utótagjaKeyvault suffix . Vault. local. azurestack. external.vault.local.azurestack.external Integrált rendszer esetén használjon végpontot a rendszer számára.For an integrated system, use an endpoint for your system.
    VM-rendszerkép aliasa doc-végpont –VM image alias doc endpoint- https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json A virtuális gép rendszerképének aliasait tartalmazó dokumentum URI azonosítója.URI of the document, which contains VM image aliases. További információ: set up the VM aliass Endpoint.For more info, see Set up the VM aliases endpoint.
    az cloud register -n <environmentname> --endpoint-resource-manager "https://management.local.azurestack.external" --suffix-storage-endpoint "local.azurestack.external" --suffix-keyvault-dns ".vault.local.azurestack.external" --endpoint-vm-image-alias-doc <URI of the document which contains VM image aliases>
    
  3. Állítsa be az aktív környezetet az alábbi parancsok használatával.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  4. Frissítse környezeti konfigurációját az Azure Stack Hub-specifikus API-verzió profiljának használatára.Update your environment configuration to use the Azure Stack Hub specific API version profile. A konfiguráció frissítéséhez futtassa a következő parancsot:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  5. Jelentkezzen be az Azure Stack hub-környezetbe a az login paranccsal.Sign in to your Azure Stack Hub environment by using the az login command. Bejelentkezhet a Azure Stack hub-környezetbe felhasználóként vagy egyszerű szolgáltatásnévként.You can sign in to the Azure Stack Hub environment either as a user or as a service principal.

    • Bejelentkezés felhasználóként:Sign in as a user:

      Megadhatja a felhasználónevet és a jelszót közvetlenül a az login parancson belül, vagy egy böngészőben végezheti el a hitelesítést.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Ha a fiókjában engedélyezve van a többtényezős hitelesítés, az utóbbit el kell végeznie:You must do the latter if your account has multi-factor authentication enabled:

      az cloud register  -n <environmentname>   --endpoint-resource-manager "https://management.local.azurestack.external"  --suffix-storage-endpoint "local.azurestack.external" --suffix-keyvault-dns ".vault.local.azurestack.external" --endpoint-vm-image-alias-doc <URI of the document which contains VM image aliases>   --profile "2019-03-01-hybrid"
      

      Megjegyzés

      Ha a felhasználói fiókja engedélyezte a többtényezős hitelesítést, a az login paraméter megadása nélkül használja a parancsot -u .If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. A parancs futtatásával egy URL-címet és egy kódot kell használnia a hitelesítéshez.Running this command gives you a URL and a code that you must use to authenticate.

    • Bejelentkezés egyszerű szolgáltatásként:Sign in as a service principal:

      Készítse elő a. PEM-fájlt, amelyet a szolgáltatás egyszerű bejelentkezéséhez kíván használni.Prepare the .pem file to be used for service principal login.

      A rendszerbiztonsági tag létrehozására szolgáló ügyfélszámítógépen exportálja az egyszerű szolgáltatás tanúsítványát pfx-ként a következő helyen található titkos kulccsal cert:\CurrentUser\My .On the client machine where the principal was created, export the service principal certificate as a pfx with the private key located at cert:\CurrentUser\My. A tanúsítvány neve megegyezik a rendszerbiztonsági tag nevével.The cert name has the same name as the principal.

      Alakítsa át a pfx-t PEM-ra (használja az OpenSSL segédprogramot).Convert the pfx to pem (use the OpenSSL utility).

      Jelentkezzen be a CLI-be:Sign in to the CLI:

      az login --service-principal \
      -u <Client ID from the Service Principal details> \
      -p <Certificate's fully qualified name, such as, C:\certs\spn.pem>
      --tenant <Tenant ID> \
      --debug 
      

Kapcsolat teszteléseTest the connectivity

Minden beállításnál a CLI használatával hozhat létre erőforrásokat Azure Stack hub-on belül.With everything set up, use CLI to create resources within Azure Stack Hub. Létrehozhat például egy erőforráscsoportot egy alkalmazáshoz, és hozzáadhat egy virtuális gépet.For example, you can create a resource group for an app and add a VM. A következő parancs használatával hozzon létre egy "MyResourceGroup" nevű erőforráscsoportot:Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Ha az erőforráscsoport sikeresen létrejött, az előző parancs kimenete az újonnan létrehozott erőforrás következő tulajdonságait eredményezi:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Erőforráscsoport kimenet létrehozása

Ismert problémákKnown issues

Ismert problémák léptek fel a CLI Azure Stack hub-ban való használatakor:There are known issues when using CLI in Azure Stack Hub:

  • A CLI interaktív mód.The CLI interactive mode. A parancs például az az interactive Azure stack hub még nem támogatja.For example, the az interactive command, isn't yet supported in Azure Stack Hub.
  • Azure Stack hub-ban elérhető virtuálisgép-rendszerképek listájának lekéréséhez használja a parancsot a parancs az vm image list --all helyett az vm image list .To get the list of VM images available in Azure Stack Hub, use the az vm image list --all command instead of the az vm image list command. A beállítás megadásával --all biztosíthatja, hogy a válasz csak az Azure stack hub-környezetben elérhető lemezképeket adja vissza.Specifying the --all option ensures that the response returns only the images that are available in your Azure Stack Hub environment.
  • Előfordulhat, hogy az Azure-ban elérhető virtuálisgép-rendszerkép-aliasok nem alkalmazhatók Azure Stack hubhoz.VM image aliases that are available in Azure may not be applicable to Azure Stack Hub. Virtuálisgép-lemezképek használata esetén a rendszerkép aliasa helyett a teljes URN paramétert (Canonical: UbuntuServer: 14.04.3-LTS: 1.0.0) kell használnia.When using VM images, you must use the entire URN parameter (Canonical:UbuntuServer:14.04.3-LTS:1.0.0) instead of the image alias. Ennek az URN-nek meg kell egyeznie a parancsból származtatott rendszerkép-specifikációkkal az vm images list .This URN must match the image specifications as derived from the az vm images list command.

További lépésekNext steps