Azure Stack Hub için PowerShell'i çalıştırmak için Docker kullanma

Bu makalede, Çeşitli arabirimlerle çalışmak için gereken PowerShell sürümünün çalıştırıldığı bir kapsayıcı oluşturmak için Docker'ı kullanabilirsiniz. Hem AzureRM modüllerini hem de en son Az modüllerini kullanma yönergelerini bulabilirsiniz. AzureRM, Windows tabanlı bir kapsayıcı gerektirir. Az, Linux tabanlı bir kapsayıcı kullanır.

Docker ön koşulları

Docker'ı yükleme

1. Docker'ı yükleyin.

2. PowerShell veya Bash gibi bir komut satırı programına şunu girin:

   docker --version
   

PowerShell kullanmak için hizmet sorumlusu ayarlama

PowerShell'i kullanarak Azure Stack Hub'daki kaynaklara erişmek için Microsoft Entra kiracınızda bir hizmet sorumlusuna ihtiyacınız vardır. Kullanıcı rol tabanlı erişim denetimi (RBAC) ile izinleri delege edersiniz. Bulut operatörünüzden hizmet sorumlusunu istemeniz gerekebilir.

1. Hizmet sorumlunuzu ayarlamak için Uygulamalara hizmet sorumluları oluşturarak Azure Stack Hub kaynaklarına erişim verme başlığındaki yönergeleri izleyin.

2. Daha sonra kullanmak üzere uygulama kimliğini, gizli anahtarı, kiracı kimliğinizi ve nesne kimliğini not edin.

Docker'da PowerShell çalıştırma

Az modülleri

Bu yönergelerde, PowerShell'i ve Azure Stack Hub için gerekli modülleri içeren Linux tabanlı bir kapsayıcı görüntüsü çalıştıracaksınız.

1. Linux kapsayıcısını kullanarak Docker'ı çalıştırmanız gerekir. Docker'ı çalıştırdığınızda Linux kapsayıcılarına geçin.

2. Docker'ı Azure Stack Hub ile aynı etki alanına katılmış bir makineden çalıştırın. Azure Stack Geliştirme Seti'ni (ASDK) kullanıyorsanız vpn'i uzak makinenize yükleyin.

Azure Stack Hub Az modülünü Linux kapsayıcıya yükleme

1. Komut satırınızdan aşağıdaki Docker komutunu çalıştırarak PowerShell'i bir Ubuntu kapsayıcısında çalıştırın:

   docker run -it mcr.microsoft.com/azurestack/powershell
   

   Ubuntu veya Debian çalıştırabilirsiniz. Aşağıdaki Docker dosyalarını GitHub deposunda bulabilirsiniz: azurestack-powershell. Docker dosyalarındaki en son değişiklikler için GitHub deposuna bakın. Her işletim sistemi etiketlenmiştir. İki nokta üst üste işaretinden sonraki bölüm olan etiketini, istenen işletim sisteminin etiketiyle değiştirin.

   Linux	Docker görüntüsü
   Ubuntu	docker run -it mcr.microsoft.com/azurestack/powershell:ubuntu-18.04
   Debian	docker run -it mcr.microsoft.com/azurestack/powershell:debian-9

2. Kabuk cmdlet'leriniz için hazır. Oturum açıp Test-AzureStack.ps1 komutunu çalıştırarak kabuk bağlantınızı test edin.

   İlk olarak hizmet asıl kullanıcı kimlik bilgilerinizi oluşturun. Gizli ve uygulama kimliği ihtiyacınız olacaktır. Test-AzureStack.ps1 nesne kimliğine de ihtiyacınız olacaktır. Bulut operatörünüzden bir hizmet sorumlusu istemeniz gerekebilir.

   Hizmet ilkesi nesnesi oluşturmak için aşağıdaki cmdlet'leri yazın:

   $passwd = ConvertTo-SecureString <Secret> -AsPlainText -Force
   $pscredential = New-Object System.Management.Automation.PSCredential('<ApplicationID>', $passwd)
   

3. Azure Stack Hub örneğinizden aşağıdaki değerleri içeren aşağıdaki betiği çalıştırarak ortamınıza bağlanın.

   Değer	Açıklama
   Ortamın adı.	Azure Stack Hub ortamınızın adı.
   Resource Manager Uç Noktası	Resource Manager URL'si. Bilmiyorsanız bulut operatörünüze başvurun. https://management.region.domain.com gibi görünür.
   Dizin Kiracı Kimliği	Azure Stack Hub kiracı dizininizin kimliği.
   Kimlik bilgisi	Hizmet sorumlunuzu içeren bir nesne. Bu durumda $pscredential.

   ./Login-Environment.ps1 -Name <String> -ResourceManagerEndpoint <resource manager endpoint> -DirectoryTenantId <String> -Credential $pscredential
   

   PowerShell, hesap nesnenizi döndürür.

4. Kapsayıcıda betiği çalıştırarak Test-AzureStack.ps1 ortamınızı test edin. Hizmet asıl nesne kimliğini belirtin. Nesne kimliğini belirtmezseniz, betik çalışmaya devam eder, ancak yalnızca kiracı (kullanıcı) modüllerini test eder ve yönetici ayrıcalıkları gerektiren modüllerde başarısız olur.

   ./Test-AzureStack.ps1 <Object ID>
   

AzureRM modülleri

Bu yönergelerde, Windows tabanlı bir kapsayıcı görüntüsü çalıştıracak ve PowerShell'i ve Azure Stack Hub için gerekli modülleri yükleyeceksiniz. Docker'ı Windows ile çalıştırmayı planlıyorsanız Docker'ı fiziksel bir makinede çalıştırmanız gerekir. İç içe sanallaştırma Hyper-V'de desteklenmez.

1. Windows 10 gerektiren Windows kapsayıcılarını kullanarak Docker'ı çalıştırmanız gerekir. Docker'ı çalıştırdığınızda Windows kapsayıcılarına geçin. Az modülünü destekleyen görüntüler Docker 17.05 veya üzerini gerektirir.

2. Docker'ı Azure Stack Hub ile aynı etki alanına katılmış bir makineden çalıştırın. Azure Stack Geliştirme Seti'ni (ASDK) kullanıyorsanız vpn'i uzak makinenize yükleyin.

Azure Stack Hub AzureRM modülünü windows kapsayıcıya yükleme

Dockerfile, Windows PowerShell 5.1'in yüklü olduğu Microsoft/windowsservercore görüntüsünü açar. Dosya daha sonra NuGet ve Azure Stack Hub PowerShell modüllerini yükler ve Azure Stack Hub Araçları'ndan araçları indirir.

1. azure-stack-powershell deposunu ZIP dosyası olarak indirin veya depoyu kopyalayın.

2. Terminalinizden depo klasörünü açın.

3. Deponuzda bir komut satırı arabirimi açın ve aşağıdaki komutu girin:

   docker build --tag azure-stack-powershell .
   

4. Görüntü oluşturulduğunda şunları girerek etkileşimli bir kapsayıcı başlatın:

   docker run -it azure-stack-powershell powershell
   

   Kapsayıcı adınızı not edin. Aşağıdaki Docker komutunu çalıştırarak her seferinde yeni bir kapsayıcı oluşturmak yerine aynı kapsayıcıyı kullanabilirsiniz:

       docker exec -it "Container name" powershell
   

5. Cmdlet'leriniz için kabuk hazır.

   Windows PowerShell
   Copyright (C) 2016 Microsoft Corporation. All rights reserved.
   
   PS C:\>
   

6. Hizmet ilkesi kullanarak Azure Stack Hub örneğinize bağlanın. Artık Docker'da bir PowerShell istemi kullanıyorsunuz.

   $passwd = ConvertTo-SecureString <Secret> -AsPlainText -Force
   $pscredential = New-Object System.Management.Automation.PSCredential('<ApplicationID>', $passwd)
   Add-AzureRMEnvironment -Name "AzureStackUser" -ArmEndpoint <Your Azure Resource Manager endoint>
   Add-AzureRmAccount -EnvironmentName "AzureStackUser" -TenantId <TenantID> -ServicePrincipal -Credential $pscredential
   

   PowerShell, hesap nesnenizi döndürür:

   Account    SubscriptionName    TenantId    Environment
   -------    ----------------    --------    -----------
   <AccountID>    <SubName>       <TenantID>  AzureCloud
   

7. Azure Stack Hub'da bir kaynak grubu oluşturarak bağlantınızı test edin.

   New-AzureRmResourceGroup -Name "MyResourceGroup" -Location "Local"
   

Sonraki adımlar

• Azure Stack Hub'da Azure Stack Hub PowerShell'e genel bakış konusunu okuyun.
• Azure Stack Hub'da PowerShell için API profilleri hakkında bilgi edinin.
• Azure Stack Hub PowerShell'i yükleyin.
• Bulut tutarlılığı için Azure Resource Manager şablonları oluşturma hakkında bilgi edinin.