Distribuire ASDK dalla riga di comando con PowerShell

Azure Stack Development Kit (ASDK) è un ambiente di test e sviluppo che è possibile distribuire per valutare e illustrare le funzionalità e i servizi di Azure Stack. Per renderlo operativo, è necessario preparare l'hardware dell'ambiente ed eseguire alcuni script. Gli script richiedono diverse ore per l'esecuzione. In seguito, è possibile accedere agli amministratori e ai portali utente per iniziare a usare Azure Stack.

Prerequisiti

Preparare il computer host ASDK. Pianificare l'hardware, il software e la rete. Il computer che ospita asDK deve soddisfare i requisiti hardware, software e di rete. Scegliere tra l'uso dell'ID Microsoft Entra o dell'Active Directory Federation Services (AD FS). Assicurarsi di seguire questi prerequisiti prima di avviare la distribuzione in modo che il processo di installazione venga eseguito senza problemi.

Prima di distribuire ASDK, assicurarsi che l'hardware del computer host ASDK pianificato, il sistema operativo, l'account e le configurazioni di rete soddisfino i requisiti minimi per l'installazione dell'ASDK.

Esaminare i requisiti e le considerazioni sulla distribuzione di ASDK.

Scaricare ed estrarre il pacchetto di distribuzione

Dopo aver verificato che il computer host ASDK soddisfi i requisiti di base per l'installazione di ASDK, il passaggio successivo consiste nel scaricare ed estrarre il pacchetto di distribuzione ASDK. Il pacchetto di distribuzione include il file Cloudbuilder.vhdx, ovvero un disco rigido virtuale che include un sistema operativo avviabile e i file di installazione di Azure Stack.

È possibile scaricare il pacchetto di distribuzione nell'host ASDK o in un altro computer. I file di distribuzione estratti richiedono 60 GB di spazio su disco libero, quindi l'uso di un altro computer può aiutare a ridurre i requisiti hardware per l'host ASDK.

Scaricare ed estrarre Azure Stack Development Kit (ASDK)

Preparare il computer host ASDK

Prima di poter installare ASDK nel computer host, l'ambiente deve essere preparato e il sistema configurato per l'avvio dal disco rigido virtuale. Dopo questo passaggio, l'host ASDK verrà avviato nel cloudbuilder.vhdx (un disco rigido virtuale che include un sistema operativo avviabile e i file di installazione di Azure Stack).

Usare PowerShell per configurare il computer host ASDK per l'avvio da CloudBuilder.vhdx. Questi comandi configurano il computer host ASDK per l'avvio dal disco rigido virtuale di Azure Stack scaricato ed estratto (CloudBuilder.vhdx). Dopo aver completato questi passaggi, riavviare il computer host ASDK.

Per configurare il computer host ASDK da avviare da CloudBuilder.vhdx:

1. Avviare un prompt dei comandi come amministratore.
2. Eseguire bcdedit /copy {current} /d "Azure Stack".
3. Copiare (CTRL+C) il valore CLSID restituito, incluse le parentesi graffe necessarie ({}). Questo valore viene definito {CLSID} e deve essere incollato in (CTRL+V o fare clic con il pulsante destro del mouse) nei passaggi rimanenti.
4. Eseguire bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
5. Eseguire bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
6. Eseguire bcdedit /set {CLSID} detecthal on.
7. Eseguire bcdedit /default {CLSID}.
8. Per verificare le impostazioni di avvio, eseguire bcdedit.
9. Assicurarsi che il file CloudBuilder.vhdx sia stato spostato nella radice dell'unità C:\ (C:\CloudBuilder.vhdx) e riavviare il computer host ASDK. Quando il computer host ASDK viene riavviato, deve eseguire l'avvio dal disco rigido cloudBuilder.vhdx (VM) per avviare la distribuzione ASDK.

Importante

Assicurarsi di avere accesso fisico o KVM diretto al computer host ASDK prima di riavviarlo. Al primo avvio della macchina virtuale, viene richiesto di completare l'installazione di Windows Server. Specificare le stesse credenziali di amministratore usate per accedere al computer host ASDK.

Preparare l'host ASDK con PowerShell

Dopo l'avvio del computer host ASDK nell'immagine CloudBuilder.vhdx, accedere con le stesse credenziali di amministratore locale usate per accedere al computer host ASDK. Queste sono anche le stesse credenziali fornite come parte del completamento dell'installazione di Windows Server quando il computer host è stato avviato dal disco rigido virtuale.

Nota

Facoltativamente, è anche possibile configurare le impostazioni di telemetria di Azure Stackprima di installare asDK.

Aprire una console di PowerShell con privilegi elevati ed eseguire i comandi in questa sezione per distribuire ASDK nell'host ASDK.

Importante

L'installazione di ASDK supporta esattamente una scheda di interfaccia di rete per la rete. Se sono presenti più schede di interfaccia di rete, assicurarsi che solo una sia abilitata (e tutte le altre siano disabilitate) prima di eseguire lo script di distribuzione.

È possibile distribuire Azure Stack con ID Microsoft Entra o Windows Server AD FS come provider di identità. Azure Stack, provider di risorse e altre app funzionano allo stesso modo con entrambi.

Suggerimento

Se non si specificano parametri di installazione (vedere InstallAzureStackPOC.ps1 parametri facoltativi ed esempi seguenti), viene richiesto di specificare i parametri necessari.

Distribuire Azure Stack usando Microsoft Entra ID

Per distribuire Azure Stack usando Microsoft Entra ID come provider di identità, è necessario disporre della connettività Internet direttamente o tramite un proxy trasparente.

Eseguire i comandi di PowerShell seguenti per distribuire ASDK usando Microsoft Entra ID:

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator     
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password

A pochi minuti dall'installazione di ASDK verrà richiesto di Microsoft Entra credenziali. Specificare le credenziali di amministratore globale per il tenant Microsoft Entra.

Dopo la distribuzione, non è necessaria l'autorizzazione di amministratore globale Microsoft Entra. Tuttavia, alcune operazioni potrebbero richiedere le credenziali di amministratore globale. Esempi di queste operazioni includono uno script del programma di installazione del provider di risorse o una nuova funzionalità che richiede un'autorizzazione da concedere. È possibile ripristinare temporaneamente le autorizzazioni di amministratore globale dell'account o usare un account amministratore globale separato proprietario della sottoscrizione del provider predefinita.

Distribuire Azure Stack con AD FS

Per distribuire ASDK usando AD FS come provider di identità, eseguire i comandi di PowerShell seguenti (è sufficiente aggiungere il parametro -UseADFS):

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -UseADFS

Nelle distribuzioni di AD FS il servizio directory di stamp predefinito viene usato come provider di identità. L'account predefinito con cui accedere è azurestackadmin@azurestack.locale la password è impostata su ciò che è stato fornito come parte dei comandi di installazione di PowerShell.

Il processo di distribuzione può richiedere alcune ore, durante il quale il sistema viene riavviato automaticamente una volta. Al termine della distribuzione, viene visualizzata la console di PowerShell: COMPLETE: Action 'Deployment'. Se la distribuzione ha esito negativo, provare a eseguire di nuovo lo script usando il parametro -rerun. In alternativa, è possibile ridistribuire ASDK da zero.

Importante

Se si vuole monitorare lo stato di avanzamento della distribuzione dopo il riavvio dell'host ASDK, è necessario accedere come AzureStack\AzureStackAdmin. Se si accede come amministratore locale dopo il riavvio del computer host (e aggiunto al dominio azurestack.local), non verrà visualizzato lo stato di avanzamento della distribuzione. Non eseguire nuovamente la distribuzione, accedere invece come AzureStack\AzureStackAdmin con la stessa password dell'amministratore locale per verificare che l'installazione sia in esecuzione.

esempi di script di distribuzione Microsoft Entra

È possibile creare uno script dell'intera distribuzione Microsoft Entra. Ecco alcuni esempi di commento che includono alcuni parametri facoltativi.

Se l'identità Microsoft Entra è associata solo a una directory Microsoft Entra:

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 52.168.138.145 #Example time server IP address.

Se l'identità Microsoft Entra è associata a una directory di Microsoft Entra maggiore:

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" #Example: user@AADDirName.onmicrosoft.com 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -InfraAzureDirectoryTenantName "<Azure AD directory in the form of domainname.onmicrosoft.com or an Azure AD verified custom domain name>" -TimeServer 52.168.138.145 #Example time server IP address.

Se l'ambiente non è abilitato per DHCP, è necessario includere i parametri aggiuntivi seguenti a una delle opzioni precedenti (utilizzo di esempio fornito):

.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26

Parametri facoltativi InstallAzureStackPOC.ps1 ASDK

Parametro	Obbligatorio/facoltativo	Descrizione
AdminPassword	Necessario	Imposta l'account amministratore locale e tutti gli altri account utente in tutte le macchine virtuali create come parte della distribuzione di ASDK. Questa password deve corrispondere alla password dell'amministratore locale corrente nell'host.
InfraAzureDirectoryTenantName	Necessario	Imposta la directory del tenant. Usare questo parametro per specificare una directory specifica in cui l'account Microsoft Entra dispone delle autorizzazioni per gestire più directory. Nome completo di un tenant Microsoft Entra nel formato di .onmicrosoft.com o di un ID Microsoft Entra verificato nome di dominio personalizzato.
TimeServer	Necessario	Usare questo parametro per specificare un server di tempo specifico. Questo parametro deve essere fornito come indirizzo IP del server di tempo valido. I nomi dei server non sono supportati.
InfraAzureDirectoryTenantAdminCredential	Facoltativo	Imposta il Microsoft Entra nome utente e la password. Queste credenziali di Azure devono essere un ID organizzazione.
InfraAzureEnvironment	Facoltativo	Selezionare l'ambiente di Azure con cui si vuole registrare questa distribuzione di Azure Stack. Le opzioni includono Azure globale, Azure - Cina, Azure - US Government.
DNSForwarder	Facoltativo	Un server DNS viene creato come parte della distribuzione di Azure Stack. Per consentire ai computer all'interno della soluzione di risolvere i nomi all'esterno del timbro, fornire il server DNS dell'infrastruttura esistente. Il server DNS in-stamp inoltra richieste di risoluzione dei nomi sconosciute a questo server.
Riesegui	Facoltativo	Usare questo flag per eseguire nuovamente la distribuzione. Viene usato tutto l'input precedente. L'immissione dei dati forniti in precedenza non è supportata perché vengono generati diversi valori univoci e usati per la distribuzione.

Eseguire configurazioni post-distribuzione

Dopo aver installato ASDK, sono disponibili alcuni controlli di post-installazione consigliati e modifiche alla configurazione che devono essere apportate. Verificare che l'installazione sia stata installata correttamente usando il cmdlet test-AzureStack, quindi installare Gli strumenti di Azure Stack PowerShell e GitHub.

È consigliabile reimpostare i criteri di scadenza della password per assicurarsi che la password per l'host ASDK non scada prima del termine del periodo di valutazione.

Nota

Facoltativamente, è anche possibile configurare le impostazioni di telemetria di Azure Stackdopo l'installazione di ASDK.

Post-attività di distribuzione ASDK

Registrare con Azure

È necessario registrare Azure Stack con Azure in modo che sia possibile scaricare Azure Marketplace elementi in Azure Stack.

Registrare Azure Stack con Azure

Passaggi successivi

Congratulazioni! Dopo aver completato questi passaggi, si avrà un ambiente ASDK con sia gli amministratori https://adminportal.local.azurestack.external che i portali utente https://portal.local.azurestack.external .

Post-attività di configurazione dell'installazione di ASDK