Installera Azure CLI på Azure Stack Hub

Du kan installera Azure CLI för att hantera Azure Stack Hub med en Windows- eller Linux-dator. Den här artikeln beskriver steg för steg hur du installerar och konfigurerar Azure CLI.

Installera Azure CLI

  1. Logga in på utvecklingsarbetsstationen och installera CLI. Azure Stack Hub kräver version 2.0 eller senare av Azure CLI.

Viktigt

Du måste använda Azure CLI version 2.29.2 eller tidigare med Azure Stack Hub. Microsoft har upptäckt ett problem med Azure Stack Hub som förhindrar användning av Azure CLI version 2.30.0 eller senare.

  1. Du kan installera CLI med hjälp av stegen som beskrivs i artikeln Installera Azure CLI .

  2. Kontrollera om installationen lyckades genom att öppna en terminal eller kommandotolk och köra följande kommando:

    az --version
    

    Du bör se versionen av Azure CLI och andra beroende bibliotek som är installerade på datorn.

    Azure CLI on Azure Stack Hub Python location

  3. Anteckna CLI:s Python-plats.

Lägga till certifikat

Exportera och importera sedan Azure Stack Hub-certifikat för frånkopplade integrerade system och för ASDK. För anslutna integrerade system är certifikatet offentligt signerat och det här steget är inte nödvändigt. Anvisningar finns i Konfigurera certifikat för Azure CLI i Azure Stack Development Kit.

Ansluta med Azure CLI

Det här avsnittet beskriver steg för steg hur du konfigurerar CLI om du använder Azure AD som identitetshanteringstjänst och använder CLI på en Windows-dator.

Ansluta till Azure Stack Hub

  1. Om du använder ASDK:t litar du på Azure Stack Hub CA-rotcertifikatet. Instruktioner finns i Lita på certifikatet.

  2. Registrera din Azure Stack Hub-miljö genom att az cloud register köra kommandot .

  3. Registrera din miljö. Använd följande parametrar när du kör az cloud register:

    Värde Exempel Description
    Miljönamn AzureStackUser Används AzureStackUser för användarmiljön. Om du är operator anger du AzureStackAdmin.
    Resource Manager-slutpunkt https://management.contoso.onmicrosoft.com ResourceManagerUrl i ASDK är: https://management.local.azurestack.external/ResourceManagerUrl i integrerade system är: https://management.<region>.<fqdn>/ Kontakta molnoperatören om du har en fråga om slutpunkten för det integrerade systemet.
    Lagringsslutpunkt local.contoso.onmicrosoft.com local.azurestack.external är för ASDK. För ett integrerat system använder du en slutpunkt för ditt system.
    Nyckelvalvsuffix .vault.contoso.onmicrosoft.com .vault.local.azurestack.external är för ASDK. För ett integrerat system använder du en slutpunkt för ditt system.
    Resurs-ID för Active Directory-slutpunktsdiagram https://graph.windows.net/ Resurs-ID:t för Azure Active Directory.
    az cloud register `
        -n <environmentname> `
        --endpoint-resource-manager "https://management.<region>.<fqdn>" `
        --suffix-storage-endpoint "<fqdn>" `
        --suffix-keyvault-dns ".vault.<fqdn>" 
    

    Du hittar en referens för registerkommandot i Azure CLI-referensdokumentationen.

  4. Ange den aktiva miljön med hjälp av följande kommandon.

    az cloud set -n <environmentname>
    
  5. Uppdatera din miljökonfiguration för att använda den Azure Stack Hub-specifika API-versionsprofilen. Kör följande kommando för att uppdatera konfigurationen:

    az cloud update --profile 2020-09-01-hybrid
    
  6. Logga in i Azure Stack Hub-miljön med hjälp az login av kommandot .

    Du kan logga in i Azure Stack Hub-miljön med dina autentiseringsuppgifter eller med ett tjänsthuvudnamn (SPN) som tillhandahålls av molnoperatören.

    • Logga in som användare:

      Du kan antingen ange användarnamnet och lösenordet direkt i kommandot eller autentisera az login med hjälp av en webbläsare. Du måste göra det senare om ditt konto har multifaktorautentisering aktiverat:

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

      Anteckning

      Om multifaktorautentisering är aktiverat för ditt användarkonto använder du az login kommandot utan att ange parametern -u . Om du kör det här kommandot får du en URL och en kod som du måste använda för att autentisera.

    • Logga in som tjänstens huvudnamn:

      Innan du loggar in skapar du ett huvudnamn för tjänsten via Azure-portalen eller CLI och tilldelar det en roll. Logga nu in med följande kommando:

      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. Kontrollera att din miljö är korrekt inställd och att din miljö är det aktiva molnet.

        az cloud list --output table
    

Du bör se att din miljö visas och Att IsActive är true. Exempel:

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

Testa anslutningen

När allt har konfigurerats använder du CLI för att skapa resurser i Azure Stack Hub. Du kan till exempel skapa en resursgrupp för en app och lägga till en virtuell dator. Använd följande kommando för att skapa en resursgrupp med namnet "MyResourceGroup":

az group create -n MyResourceGroup -l local

Om resursgruppen har skapats returnerar föregående kommando följande egenskaper för den nyligen skapade resursen:

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

Nästa steg