Usare Docker per eseguire PowerShell per l'hub di Azure Stack

In questo articolo è possibile usare Docker per creare un contenitore in cui eseguire la versione di PowerShell necessaria per l'uso delle varie interfacce. È possibile trovare istruzioni per l'uso dei moduli AzureRM e dei moduli Az più recenti. AzureRM richiede un contenitore basato su Windows. Az usa un contenitore basato su Linux.

Prerequisiti Docker

Installare Docker

1. Installare Docker.

2. In un programma da riga di comando, ad esempio PowerShell o Bash, immettere:

   docker --version
   

Configurare un'entità servizio per l'uso di PowerShell

Per usare PowerShell per accedere alle risorse nell'hub di Azure Stack, è necessaria un'entità servizio nel tenant di Microsoft Entra. Delegare le autorizzazioni con il controllo degli accessi in base al ruolo dell'utente. Potrebbe essere necessario richiedere l'entità servizio dall'operatore cloud.

1. Per configurare l'entità servizio, seguire le istruzioni in Concedere alle applicazioni l'accesso alle risorse dell'hub di Azure Stack creando entità servizio.

2. Prendere nota dell'ID applicazione, del segreto, dell'ID tenant e dell'ID oggetto per un uso successivo.

Eseguire PowerShell in Docker

Moduli Az

In queste istruzioni si eseguirà un'immagine del contenitore basata su Linux che contiene PowerShell e i moduli necessari per l'hub di Azure Stack.

1. È necessario eseguire Docker usando il contenitore Linux. Quando si esegue Docker, passare ai contenitori Linux.

2. Eseguire Docker da un computer aggiunto allo stesso dominio dell'hub di Azure Stack. Se si usa Azure Stack Development Kit (ASDK), installare la VPN nel computer remoto.

Installare il modulo Az dell'hub di Azure Stack in un contenitore Linux

1. Dalla riga di comando eseguire il comando Docker seguente per eseguire PowerShell in un contenitore Ubuntu:

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

   È possibile eseguire Ubuntu o Debian. È possibile trovare i file Docker seguenti nel repository GitHub azurestack-powershell. Per le modifiche più recenti ai file Docker, vedere il repository GitHub. Ogni sistema operativo è contrassegnato. Sostituire il tag, la sezione dopo i due punti, con il tag per il sistema operativo desiderato.

   Linux	Immagine Docker
   Ubuntu	docker run -it mcr.microsoft.com/azurestack/powershell:ubuntu-18.04
   Debian	docker run -it mcr.microsoft.com/azurestack/powershell:debian-9

2. La shell è pronta per i cmdlet. Testare la connettività della shell eseguendo l'accesso e quindi eseguendo Test-AzureStack.ps1.

   Creare prima di tutto le credenziali dell'entità servizio. Saranno necessari il segreto e l'ID applicazione. È necessario anche l'ID oggetto durante l'esecuzione di Test-AzureStack.ps1 per controllare il contenitore. Potrebbe essere necessario richiedere un'entità servizio dall'operatore cloud.

   Digitare i cmdlet seguenti per creare un oggetto entità servizio:

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

3. Connettersi all'ambiente eseguendo lo script seguente con i valori seguenti dell'istanza dell'hub di Azure Stack.

   valore	Descrizione
   Il nome dell'ambiente.	Nome dell'ambiente hub di Azure Stack.
   Endpoint Resource Manager	URL di Resource Manager. Se non lo si conosce, contattare l'operatore cloud. Sarà simile a https://management.region.domain.com.
   Directory Tenant ID	ID della directory del tenant dell'hub di Azure Stack.
   Credenziale	Oggetto contenente l'entità servizio. In questo caso $pscredential.

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

   PowerShell restituisce l'oggetto account.

4. Testare l'ambiente eseguendo lo Test-AzureStack.ps1 script nel contenitore. Specificare l'ID oggetto dell'entità servizio. Se non si indica l'ID oggetto, lo script verrà comunque eseguito, ma eseguirà solo moduli tenant (utente) e avrà esito negativo nei moduli che richiedono privilegi di amministratore.

   ./Test-AzureStack.ps1 <Object ID>
   

Moduli AzureRM

In queste istruzioni si eseguirà un'immagine del contenitore basata su Windows e si installeranno PowerShell e i moduli necessari per l'hub di Azure Stack. Se si prevede di eseguire Docker con Windows, è necessario eseguire Docker in un computer fisico. La virtualizzazione annidata non è supportata in Hyper-V.

1. È necessario eseguire Docker usando contenitori di Windows che richiedono Windows 10. Quando si esegue Docker, passare ai contenitori di Windows. Le immagini che supportano il modulo Az richiederanno Docker 17.05 o versione successiva.

2. Eseguire Docker da un computer aggiunto allo stesso dominio dell'hub di Azure Stack. Se si usa Azure Stack Development Kit (ASDK), installare la VPN nel computer remoto.

Installare il modulo AzureRM dell'hub di Azure Stack in un contenitore Windows

Il Dockerfile apre l'immagine Microsoft microsoft/windowsservercore, in cui è installato Windows PowerShell 5.1. Il file carica quindi NuGet e i moduli PowerShell dell'hub di Azure Stack e scarica gli strumenti dagli strumenti dell'hub di Azure Stack.

1. Scaricare il repository azure-stack-powershell come file ZIP o clonare il repository.

2. Aprire la cartella del repository dal terminale.

3. Aprire un'interfaccia della riga di comando nel repository e quindi immettere il comando seguente:

   docker build --tag azure-stack-powershell .
   

4. Dopo aver compilato l'immagine, avviare un contenitore interattivo immettendo:

   docker run -it azure-stack-powershell powershell
   

   Prendere nota del nome del contenitore. È possibile usare lo stesso contenitore, anziché creare un nuovo contenitore ogni volta, eseguendo il comando Docker seguente:

       docker exec -it "Container name" powershell
   

5. La shell è pronta per i cmdlet.

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

6. Connettersi all'istanza dell'hub di Azure Stack usando l'entità servizio. Si usa ora un prompt di PowerShell in Docker.

   $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 restituisce l'oggetto account:

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

7. Testare la connettività creando un gruppo di risorse nell'hub di Azure Stack.

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

Passaggi successivi

• Leggere una panoramica di PowerShell dell'hub di Azure Stack nell'hub di Azure Stack.
• Informazioni sui profili API per PowerShell nell'hub di Azure Stack.
• Installare PowerShell per l'hub di Azure Stack.
• Informazioni sulla creazione di modelli di Azure Resource Manager per la coerenza cloud.