Implementar o ASDK a partir da linha de comandos com o PowerShell

O Azure Stack Development Kit (ASDK) é um ambiente de teste e desenvolvimento que pode implementar para avaliar e demonstrar funcionalidades e serviços do Azure Stack. Para o pôr a funcionar, tem de preparar o hardware do ambiente e executar alguns scripts. Os scripts demoram várias horas a serem executados. Depois disso, pode iniciar sessão nos portais de administrador e utilizador para começar a utilizar o Azure Stack.

Pré-requisitos

Preparar o computador anfitrião do ASDK. Planeie o seu hardware, software e rede. O computador que aloja o ASDK tem de cumprir os requisitos de hardware, software e rede. Escolha entre utilizar Microsoft Entra ID ou Serviços de Federação do Active Directory (AD FS) (AD FS). Certifique-se de que segue estes pré-requisitos antes de iniciar a implementação para que o processo de instalação seja executado sem problemas.

Antes de implementar o ASDK, certifique-se de que as configurações de hardware, sistema operativo, conta e rede do seu computador anfitrião ASDK planeada cumprem os requisitos mínimos para instalar o ASDK.

Reveja as considerações e os requisitos de implementação do ASDK.

Transferir e extrair o pacote de implementação

Depois de garantir que o computador anfitrião do ASDK cumpre os requisitos básicos para instalar o ASDK, o próximo passo é transferir e extrair o pacote de implementação do ASDK. O pacote de implementação inclui o ficheiro Cloudbuilder.vhdx, que é um disco rígido virtual que inclui um sistema operativo de arranque e os ficheiros de instalação do Azure Stack.

Pode transferir o pacote de implementação para o anfitrião do ASDK ou para outro computador. Os ficheiros de implementação extraídos ocupam 60 GB de espaço livre em disco, pelo que a utilização de outro computador pode ajudar a reduzir os requisitos de hardware do anfitrião ASDK.

Transferir e extrair o Azure Stack Development Kit (ASDK)

Preparar o computador anfitrião do ASDK

Antes de poder instalar o ASDK no computador anfitrião, o ambiente tem de estar preparado e o sistema configurado para arrancar a partir do VHD. Após este passo, o anfitrião do ASDK arrancará para o Cloudbuilder.vhdx (um disco rígido virtual que inclui um sistema operativo de arranque e os ficheiros de instalação do Azure Stack).

Utilize o PowerShell para configurar o computador anfitrião ASDK para arrancar a partir de CloudBuilder.vhdx. Estes comandos configuram o computador anfitrião do ASDK para arrancar a partir do harddisk virtual do Azure Stack transferido e extraído (CloudBuilder.vhdx). Depois de concluir estes passos, reinicie o computador anfitrião do ASDK.

Para configurar o computador anfitrião ASDK para arrancar a partir de CloudBuilder.vhdx:

1. Inicie uma linha de comandos como administrador.
2. Execute bcdedit /copy {current} /d "Azure Stack".
3. Copie (CTRL+C) o valor CLSID devolvido, incluindo os parênteses curly necessários ({}). Este valor é referido como {CLSID} e tem de ser colado em (CTRL+V ou clique com o botão direito do rato) nos passos restantes.
4. Execute bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
5. Execute bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
6. Execute bcdedit /set {CLSID} detecthal on.
7. Execute bcdedit /default {CLSID}.
8. Para verificar as definições de arranque, execute bcdedit.
9. Certifique-se de que o ficheiro CloudBuilder.vhdx foi movido para a raiz da unidade C:\ (C:\CloudBuilder.vhdx) e reinicie o computador anfitrião do ASDK. Quando o computador anfitrião do ASDK for reiniciado, deverá arrancar a partir do disco rígido da máquina virtual (VM) cloudBuilder.vhdx para iniciar a implementação do ASDK.

Importante

Certifique-se de que tem acesso físico direto ou KVM ao computador anfitrião do ASDK antes de reiniciá-lo. Quando a VM é iniciada pela primeira vez, é-lhe pedido que conclua a Configuração do Windows Server. Forneça as mesmas credenciais de administrador que utilizou para iniciar sessão no computador anfitrião do ASDK.

Preparar o anfitrião do ASDK com o PowerShell

Depois de o computador anfitrião do ASDK iniciar com êxito a imagem CloudBuilder.vhdx, inicie sessão com as mesmas credenciais de administrador local que utilizou para iniciar sessão no computador anfitrião do ASDK. Estas são também as mesmas credenciais que forneceu como parte da conclusão da Configuração do Windows Server quando o computador anfitrião arrancou a partir do VHD.

Nota

Opcionalmente, também pode configurar as definições de telemetria do Azure Stackantes de instalar o ASDK.

Abra uma consola elevada do PowerShell e execute os comandos nesta secção para implementar o ASDK no anfitrião do ASDK.

Importante

A instalação do ASDK suporta exatamente uma placa de interface de rede (NIC) para redes. Se tiver vários NICs, certifique-se de que apenas um está ativado (e todos os outros estão desativados) antes de executar o script de implementação.

Pode implementar o Azure Stack com Microsoft Entra ID ou Windows Server AD FS como fornecedor de identidade. O Azure Stack, os fornecedores de recursos e outras aplicações funcionam da mesma forma com ambos.

Dica

Se não fornecer parâmetros de configuração (veja InstallAzureStackPOC.ps1 parâmetros opcionais e exemplos abaixo), ser-lhe-ão pedidos os parâmetros necessários.

Implementar o Azure Stack com Microsoft Entra ID

Para implementar o Azure Stack com Microsoft Entra ID como fornecedor de identidade, tem de ter conectividade à Internet diretamente ou através de um proxy transparente.

Execute os seguintes comandos do PowerShell para implementar o ASDK com Microsoft Entra ID:

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

A poucos minutos da instalação do ASDK, ser-lhe-ão pedidas Microsoft Entra credenciais. Forneça as credenciais de administrador global para o seu inquilino Microsoft Entra.

Após a implementação, não é necessária Microsoft Entra permissão de administrador global. No entanto, algumas operações podem exigir a credencial de administrador global. Exemplos dessas operações incluem um script do instalador do fornecedor de recursos ou uma nova funcionalidade que exige a concessão de uma permissão. Pode restabelecer temporariamente as permissões de administrador global da conta ou utilizar uma conta de administrador global separada que seja proprietária da subscrição de fornecedor predefinida.

Implementar o Azure Stack com o AD FS

Para implementar o ASDK com o AD FS como fornecedor de identidade, execute os seguintes comandos do PowerShell (basta adicionar o parâmetro -UseADFS):

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

Nas implementações do AD FS, o Serviço de Diretório de selos predefinido é utilizado como o fornecedor de identidade. A conta predefinida com a qual iniciar sessão é azurestackadmin@azurestack.local, e a palavra-passe está definida para o que forneceu como parte dos comandos de configuração do PowerShell.

O processo de implementação pode demorar algumas horas, período durante o qual o sistema é reiniciado automaticamente uma vez. Quando a implementação for bem-sucedida, a consola do PowerShell é apresentada: COMPLETE: Ação "Implementação". Se a implementação falhar, tente executar o script novamente com o parâmetro -rerun. Em alternativa, pode reimplementar o ASDK do zero.

Importante

Se quiser monitorizar o progresso da implementação após o reinício do anfitrião do ASDK, tem de iniciar sessão como AzureStack\AzureStackAdmin. Se iniciar sessão como administrador local após o computador anfitrião ser reiniciado (e associado ao domínio azurestack.local), não verá o progresso da implementação. Não execute novamente a implementação, em vez disso, inicie sessão como AzureStack\AzureStackAdmin com a mesma palavra-passe que o administrador local para validar que a configuração está em execução.

Microsoft Entra exemplos de scripts de implementação

Pode criar scripts para toda a implementação Microsoft Entra. Eis alguns exemplos comentados que incluem alguns parâmetros opcionais.

Se a sua identidade de Microsoft Entra estiver associada apenas a um diretório 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 a sua identidade de Microsoft Entra estiver associada a um diretório superior a um 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 o seu ambiente não tiver o DHCP ativado, tem de incluir os seguintes parâmetros adicionais numa das opções acima (utilização de exemplo fornecida):

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

O ASDK InstallAzureStackPOC.ps1 parâmetros opcionais

Parâmetro	Obrigatório/Opcional	Description
AdminPassword	Necessário	Define a conta de administrador local e todas as outras contas de utilizador em todas as VMs criadas como parte da implementação do ASDK. Esta palavra-passe tem de corresponder à palavra-passe de administrador local atual no anfitrião.
InfraAzureDirectoryTenantName	Necessário	Define o diretório do inquilino. Utilize este parâmetro para especificar um diretório específico onde a conta Microsoft Entra tem permissões para gerir vários diretórios. Nome completo de um inquilino Microsoft Entra no formato .onmicrosoft.com ou um nome de domínio personalizado verificado pelo ID Microsoft Entra.
TimeServer	Necessário	Utilize este parâmetro para especificar um servidor de hora específico. Este parâmetro tem de ser fornecido como um endereço IP de servidor de tempo válido. Os nomes dos servidores não são suportados.
InfraAzureDirectoryTenantAdminCredential	Opcional	Define o Microsoft Entra nome de utilizador e palavra-passe. Estas credenciais do Azure têm de ser um ID da Organização.
InfraAzureEnvironment	Opcional	Selecione o Ambiente do Azure com o qual pretende registar esta implementação do Azure Stack. As opções incluem o Azure global, O Azure - China, Azure - Governo dos EUA.
DNSForwarder	Opcional	Um servidor DNS é criado como parte da implementação do Azure Stack. Para permitir que os computadores dentro da solução resolvam nomes fora do carimbo, forneça o servidor DNS da infraestrutura existente. O servidor DNS no carimbo reencaminha pedidos de resolução de nomes desconhecidos para este servidor.
Executar novamente	Opcional	Utilize este sinalizador para executar novamente a implementação. Todas as entradas anteriores são utilizadas. O reintrodutor de dados fornecidos anteriormente não é suportado porque são gerados e utilizados vários valores exclusivos para implementação.

Executar configurações pós-implementação

Depois de instalar o ASDK, existem algumas verificações pós-instalação recomendadas e alterações de configuração que devem ser efetuadas. Valide se a instalação foi instalada com êxito com o cmdlet test-AzureStack e, em seguida, instale as ferramentas do Azure Stack PowerShell e do GitHub.

Recomendamos que reponha a política de expiração da palavra-passe para garantir que a palavra-passe do anfitrião do ASDK não expira antes de o período de avaliação terminar.

Nota

Opcionalmente, também pode configurar as definições de telemetria do Azure Stackdepois de instalar o ASDK.

Publicar tarefas de implementação do ASDK

Registar-se no Azure

Tem de registar o Azure Stack no Azure para poder transferir Azure Marketplace itens para o Azure Stack.

Registar o Azure Stack no Azure

Passos seguintes

Parabéns! Depois de concluir estes passos, terá um ambiente ASDK com portais de administrador https://adminportal.local.azurestack.external e de utilizador https://portal.local.azurestack.external .

Publicar tarefas de configuração de instalação do ASDK