Distribuire ASDK dalla riga di comando usando PowerShell
Azure Stack Development Kit (ASDK) è un ambiente di test e sviluppo che è possibile distribuire per valutare e illustrare funzionalità e servizi di Azure Stack. Per renderlo operativo, è necessario preparare l'hardware dell'ambiente ed eseguire alcuni script. L'esecuzione degli script richiede diverse ore. Successivamente, è possibile accedere ai portali di amministrazione e utenti per iniziare a usare Azure Stack.
Prerequisiti
Preparare il computer host ASDK. Pianificare l'hardware, il software e la rete. Il computer che ospita l'ASDK deve soddisfare i requisiti hardware, software e di rete. Scegliere tra l'uso di Microsoft Entra ID o 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, il sistema operativo, l'account e le configurazioni di rete del computer host ASDK pianificati 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 di avvio 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 occupano fino a 60 GB di spazio libero su disco, quindi l'uso di un altro computer può contribuire 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, è necessario preparare l'ambiente e il sistema configurato per l'avvio dal disco rigido virtuale. Dopo questo passaggio, l'host ASDK verrà avviato in Cloudbuilder.vhdx (un disco rigido virtuale che include un sistema operativo di avvio e i file di installazione di Azure Stack).
Usare PowerShell per configurare il computer host ASDK da avviare 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 per l'avvio da CloudBuilder.vhdx:
- Avviare un prompt dei comandi come amministratore.
- Eseguire
bcdedit /copy {current} /d "Azure Stack". - 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 clic con il pulsante destro del mouse) nei passaggi rimanenti. - Eseguire
bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx. - Eseguire
bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx. - Eseguire
bcdedit /set {CLSID} detecthal on. - Eseguire
bcdedit /default {CLSID}. - Per verificare le impostazioni di avvio, eseguire
bcdedit. - 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 essere avviato dal disco rigido della macchina virtuale CloudBuilder.vhdx per avviare la distribuzione di ASDK.
Importante
Assicurarsi di avere accesso fisico o KVM diretto al computer host ASDK prima di riavviarlo. Quando la macchina virtuale viene avviata per la prima volta, 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 durante il completamento del programma di 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 Stack prima 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 (NIC) per la rete. Se sono presenti più schede di interfaccia di rete, assicurarsi che ne sia abilitata una sola (e tutte le altre siano disabilitate) prima di eseguire lo script di distribuzione.
È possibile distribuire Azure Stack con Microsoft Entra ID 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 Parametri facoltativi InstallAzureStackPOC.ps1 ed esempi di seguito), vengono richiesti i parametri obbligatori.
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 verranno richieste le credenziali di Microsoft Entra. Specificare le credenziali di amministratore globale per il tenant di Microsoft Entra.
Dopo la distribuzione, l'autorizzazione di amministratore globale di Microsoft Entra non è necessaria. Tuttavia, alcune operazioni potrebbero richiedere le credenziali di amministratore globale. Esempi di tali 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 predefinito viene usato come provider di identità. L'account predefinito con cui eseguire l'accesso è azurestackadmin@azurestack.locale la password è impostata su quello 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. Quando la distribuzione ha esito positivo, viene visualizzata la console di PowerShell: COMPLETE: Action 'Deployment'. Se la distribuzione non riesce, 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 rieseguire la distribuzione, ma accedere come AzureStack\AzureStackAdmin con la stessa password dell'amministratore locale per verificare che l'installazione sia in esecuzione.
Esempi di script di distribuzione di Microsoft Entra
È possibile creare script per l'intera distribuzione di Microsoft Entra. Ecco alcuni esempi commentati che includono alcuni parametri facoltativi.
Se l'identità di 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à di Microsoft Entra è associata a una directory di Microsoft Entra:
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 dispone di DHCP abilitato, è necessario includere i parametri aggiuntivi seguenti a una delle opzioni precedenti (esempio di utilizzo fornito):
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26
Parametri facoltativi ASDK InstallAzureStackPOC.ps1
| Parametro | Obbligatorio/facoltativo | Descrizione |
|---|---|---|
| AdminPassword | Richiesto | 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 di amministratore locale corrente nell'host. |
| InfraAzureDirectoryTenantName | Richiesto | Imposta la directory del tenant. Utilizzare 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 di Microsoft Entra nel formato .onmicrosoft.com o un nome di dominio personalizzato verificato dall'ID Microsoft Entra. |
| Opportunista | Richiesto | Usare questo parametro per specificare un server ora specifico. Questo parametro deve essere specificato come indirizzo IP del server ora valido. I nomi dei server non sono supportati. |
| InfraAzureDirectoryTenantAdminCredential | Facoltativo | Imposta il nome utente e la password di Microsoft Entra. Queste credenziali di Azure devono essere un ID organizzazione. |
| InfraAzureEnvironment | Facoltativo | Selezionare l'ambiente di Azure con cui si vuole registrare la 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 rieseguire la distribuzione. Viene usato tutto l'input precedente. L'immissione di dati forniti in precedenza non è supportata perché vengono generati e usati diversi valori univoci per la distribuzione. |
Eseguire configurazioni post-distribuzione
Dopo l'installazione di ASDK, sono disponibili alcuni controlli di post-installazione consigliati e modifiche alla configurazione da apportare. 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 Stack dopo l'installazione di ASDK.
Post-attività di distribuzione ASDK
Eseguire la registrazione con Azure
È necessario registrare Azure Stack con Azure in modo da poter scaricare gli elementi di Azure Marketplace in Azure Stack.
Registrare Azure Stack con Azure
Passaggi successivi
Complimenti. Dopo aver completato questi passaggi, si avrà un ambiente ASDK con i portali di amministrazione https://adminportal.local.azurestack.external e utente https://portal.local.azurestack.external .
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per