Azure Stack Hub üzerine Azure CLI'yı yükleme

  • Makale
  • Okumak için 10 dakika

Azure Stack Hub'ı windows veya Linux makinelerle yönetmek için Azure CLI'yi yükleyebilirsiniz. Bu makale, Azure CLI'yi yükleme ve ayarlama adımlarını gösterir.

Azure CLI'yı yükleme

  1. Geliştirme iş istasyonunuzda oturum açın ve CLI'yi yükleyin. Azure Stack Hub, Azure CLI'nın 2.0 veya sonraki bir sürümünü gerektirir.

Önemli

Azure Stack Hub ile Azure CLI 2.29.2 veya önceki bir sürümünü kullanmanız gerekir. Microsoft, Azure Stack Hub'da Azure CLI 2.30.0 veya daha yeni bir sürümün kullanılmasını engelleyen bir sorun keşfetti.

  1. Azure CLI'yi yükleme makalesinde açıklanan adımları kullanarak CLI'yi yükleyebilirsiniz.

  2. Yüklemenin başarılı olup olmadığını doğrulamak için bir terminal veya komut istemi penceresi açın ve aşağıdaki komutu çalıştırın:

    az --version

    Azure CLI sürümünü ve bilgisayarınızda yüklü olan diğer bağımlı kitaplıkları görmeniz gerekir.

    Azure CLI on Azure Stack Hub Python location

  3. CLI'nın Python konumunu not edin.

Sertifika ekleme

Bağlantısı kesilmiş tümleşik sistemler ve ASDK için Azure Stack Hub sertifikasını dışarı aktarın ve içeri aktarın. Bağlı tümleşik sistemler için sertifika genel olarak imzalanır ve bu adım gerekli değildir. Yönergeleri Azure Stack Geliştirme Seti'nde Azure CLI için sertifikaları ayarlama sayfasında bulabilirsiniz.

Azure CLI ile bağlanma

Bu bölümde, kimlik yönetimi hizmeti olarak Azure AD kullanıyorsanız ve CLI'yi bir Windows makinesinde kullanıyorsanız CLI'yi ayarlama konusunda size yol gösterilir.

Azure Stack Hub'a bağlanma

  1. ASDK kullanıyorsanız Azure Stack Hub CA kök sertifikasına güvenin. Yönergeler için bkz. Sertifikaya güvenme.

  2. komutunu çalıştırarak az cloud register Azure Stack Hub ortamınızı kaydedin.

  3. Ortamınızı kaydedin. komutunu çalıştırırken az cloud registeraşağıdaki parametreleri kullanın:

    Değer Örnek Description
    Ortam adı AzureStackUser Kullanıcı ortamı için kullanın AzureStackUser . İşleçseniz belirtin AzureStackAdmin.
    Resource Manager uç noktası https://management.contoso.onmicrosoft.com ASDK'deki ResourceManagerUrl şöyledir: https://management.local.azurestack.external/ Tümleşik sistemlerdeki ResourceManagerUrl : https://management.<region>.<fqdn>/ Tümleşik sistem uç noktası hakkında bir sorunuz varsa bulut operatörünüze başvurun.
    Depolama uç noktası local.contoso.onmicrosoft.com local.azurestack.external ASDK içindir. Tümleşik bir sistem için sisteminiz için bir uç nokta kullanın.
    Keyvault soneki .vault.contoso.onmicrosoft.com .vault.local.azurestack.external ASDK içindir. Tümleşik bir sistem için sisteminiz için bir uç nokta kullanın.
    Uç nokta active directory grafı kaynak kimliği https://graph.windows.net/ Active Directory kaynak kimliği. 
    az cloud register `
    -n <environmentname> `
    --endpoint-resource-manager "https://management.<region>.<fqdn>" `
    --suffix-storage-endpoint "<fqdn>" `
    --suffix-keyvault-dns ".vault.<fqdn>"

    Yazmaç komutu için bir başvuruyu Azure CLI başvuru belgelerinde bulabilirsiniz.

  4. Aşağıdaki komutları kullanarak etkin ortamı ayarlayın.

    az cloud set -n <environmentname>

  5. Azure Stack Hub'a özgü API sürümü profilini kullanmak için ortam yapılandırmanızı güncelleştirin. Yapılandırmayı güncelleştirmek için aşağıdaki komutu çalıştırın:

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

  6. komutunu kullanarak az login Azure Stack Hub ortamınızda oturum açın.

    Kullanıcı kimlik bilgilerinizi kullanarak veya bulut operatörünüz tarafından size sağlanan bir hizmet sorumlusuyla (SPN) Azure Stack Hub ortamında oturum açabilirsiniz.

    • Kullanıcı olarak oturum açın:

      Kullanıcı adını ve parolayı doğrudan komutun az login içinde belirtebilir veya tarayıcı kullanarak kimlik doğrulaması yapabilirsiniz. Hesabınızda çok faktörlü kimlik doğrulaması etkinleştirildiyse ikincisini yapmanız gerekir:

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

      Not

      Kullanıcı hesabınızda çok faktörlü kimlik doğrulaması etkinleştirildiyse parametresini sağlamadan -u komutunu kullanınaz login. Bu komutu çalıştırmak size bir URL ve kimlik doğrulaması için kullanmanız gereken bir kod verir.

    • Hizmet sorumlusu olarak oturum açın:

      Oturum açmadan önce Azure portalı veya CLI aracılığıyla bir hizmet sorumlusu oluşturun ve bu sorumluya bir rol atayın. Şimdi aşağıdaki komutu kullanarak oturum açın:

      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. Ortamınızın doğru ayarlandığını ve ortamınızın etkin bulut olduğunu doğrulayın.

        az cloud list --output table

Ortamınızın listelendiğini ve IsActive'in olduğunu truegörmeniz gerekir. Örnek:

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

Bağlantıyı test etme

Her şey ayarlandıysa AZURE Stack Hub'da kaynak oluşturmak için CLI kullanın. Örneğin, bir uygulama için kaynak grubu oluşturabilir ve vm ekleyebilirsiniz. "MyResourceGroup" adlı bir kaynak grubu oluşturmak için aşağıdaki komutu kullanın:

az group create -n MyResourceGroup -l local

Kaynak grubu başarıyla oluşturulursa, önceki komut yeni oluşturulan kaynağın aşağıdaki özelliklerini verir:

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

Sonraki adımlar