Implantar o ASDK na linha de comando usando o PowerShell
O ASDK (Kit de Desenvolvimento do Azure Stack) é um ambiente de teste e desenvolvimento que você pode implantar para avaliar e demonstrar recursos e serviços do Azure Stack. Para colocá-lo em funcionamento, você precisa preparar o hardware do ambiente e executar alguns scripts. Os scripts levam várias horas para serem executados. Depois disso, você pode entrar nos portais de administrador e usuário para começar a usar o Azure Stack.
Pré-requisitos
Prepare o computador host do ASDK. Planeje seu hardware, software e rede. O computador que hospeda o ASDK deve atender aos requisitos de hardware, software e rede. Escolha entre usar a ID do Microsoft Entra ou os Serviços de Federação do Active Directory (AD FS). Certifique-se de seguir esses pré-requisitos antes de iniciar sua implantação para que o processo de instalação seja executado sem problemas.
Antes de implantar o ASDK, verifique se o hardware, o sistema operacional, a conta e as configurações de rede do computador host ASDK planejado atendem aos requisitos mínimos para instalar o ASDK.
Examine os requisitos e as considerações de implantação do ASDK.
Baixar e extrair o pacote de implantação
Depois de garantir que o computador host do ASDK atenda aos requisitos básicos para instalar o ASDK, a próxima etapa é baixar e extrair o pacote de implantação do ASDK. O pacote de implantação inclui o arquivo Cloudbuilder.vhdx, que é um disco rígido virtual que inclui um sistema operacional inicializável e os arquivos de instalação do Azure Stack.
Você pode baixar o pacote de implantação para o host ASDK ou para outro computador. Os arquivos de implantação extraídos ocupam 60 GB de espaço livre em disco, portanto, usar outro computador pode ajudar a reduzir os requisitos de hardware para o host ASDK.
Baixar e extrair o ASDK (Azure Stack Development Kit)
Prepare o computador host do ASDK
Antes de instalar o ASDK no computador host, o ambiente deve ser preparado e o sistema configurado para inicializar do VHD. Após essa etapa, o host ASDK será inicializado no Cloudbuilder.vhdx (um disco rígido virtual que inclui um sistema operacional inicializável e os arquivos de instalação do Azure Stack).
Use o PowerShell para configurar o computador host do ASDK para inicializar a partir de CloudBuilder.vhdx. Esses comandos configuram o computador host do ASDK para inicializar do disco rígido virtual do Azure Stack baixado e extraído (CloudBuilder.vhdx). Depois de concluir essas etapas, reinicie o computador host do ASDK.
Para configurar o computador host do ASDK para inicializar a partir do CloudBuilder.vhdx:
- Inicie um prompt de comando como administrador.
- Execute
bcdedit /copy {current} /d "Azure Stack". - Copie (CTRL+C) o valor CLSID retornado, incluindo as chaves necessárias (
{}). Esse valor é conhecido como{CLSID}e precisa ser colado (CTRL+V ou clique com o botão direito do mouse) nas etapas restantes. - Execute
bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx. - Execute
bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx. - Execute
bcdedit /set {CLSID} detecthal on. - Execute
bcdedit /default {CLSID}. - Para verificar as configurações de inicialização, execute
bcdedit. - Verifique se o arquivo CloudBuilder.vhdx foi movido para a raiz da unidade C:\ (
C:\CloudBuilder.vhdx) e reinicie o computador host ASDK. Quando o computador host do ASDK é reiniciado, ele deve ser inicializado do disco rígido da VM (máquina virtual) CloudBuilder.vhdx para iniciar a implantação do ASDK.
Importante
Certifique-se de ter acesso físico ou KVM direto ao computador host ASDK antes de reiniciá-lo. Quando a VM é iniciada pela primeira vez, ela solicita que você conclua a Instalação do Windows Server. Forneça as mesmas credenciais de administrador usadas para fazer logon no computador host do ASDK.
Preparar o host do ASDK usando o PowerShell
Depois que o computador host ASDK for inicializado com êxito na imagem CloudBuilder.vhdx, entre com as mesmas credenciais de administrador local usadas para fazer logon no computador host ASDK. Essas também são as mesmas credenciais que você forneceu como parte da conclusão da Instalação do Windows Server quando o computador host foi inicializado do VHD.
Observação
Opcionalmente, você também pode definir as configurações de telemetria do Azure Stack antes de instalar o ASDK.
Abra um console do PowerShell com privilégios elevados e execute os comandos nesta seção para implantar o ASDK no host do ASDK.
Importante
A instalação do ASDK dá suporte a exatamente uma placa de interface de rede (NIC) para rede. Se você tiver várias NICs, certifique-se de que apenas uma esteja habilitada (e todas as outras estejam desabilitadas) antes de executar o script de implantação.
Você pode implantar o Azure Stack com a ID do Microsoft Entra ou o Windows Server AD FS como o provedor de identidade. O Azure Stack, os provedores de recursos e outros aplicativos funcionam da mesma maneira com ambos.
Dica
Se você não fornecer nenhum parâmetro de instalação (consulte InstallAzureStackPOC.ps1 parâmetros opcionais e exemplos abaixo), será solicitado a fornecer os parâmetros necessários.
Implantar o Azure Stack usando a ID do Microsoft Entra
Para implantar o Azure Stack usando a ID do Microsoft Entra como o provedor de identidade, você deve ter conectividade com a Internet diretamente ou por meio de um proxy transparente.
Execute os seguintes comandos do PowerShell para implantar o ASDK usando a ID do Microsoft Entra:
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password
Alguns minutos após a instalação do ASDK, você será solicitado a fornecer as credenciais do Microsoft Entra. Forneça as credenciais de administrador do Microsoft Entra para seu locatário.
Implantar o Azure Stack usando o AD FS
Para implantar o ASDK usando o AD FS como o provedor de identidade, execute os seguintes comandos do PowerShell (você só precisa adicionar o parâmetro -UseADFS):
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -UseADFS
Nas implantações do AD FS, o Serviço de Diretório de carimbo padrão é usado como o provedor de identidade. A conta padrão para entrar é azurestackadmin@azurestack.local, e a senha é definida como o que você forneceu como parte dos comandos de instalação do PowerShell.
O processo de implantação pode levar algumas horas, durante as quais o sistema é reinicializado automaticamente uma vez. Quando a implantação for bem-sucedida, o console do PowerShell exibirá: COMPLETE: Ação 'Implantação'. Se a implantação falhar, tente executar o script novamente usando o parâmetro -rerun. Ou você pode reimplantar o ASDK do zero.
Importante
Se você quiser monitorar o progresso da implantação após a reinicialização do host ASDK, deverá entrar como AzureStack\AzureStackAdmin. Se você entrar como administrador local depois que o computador host for reiniciado (e ingressado no domínio azurestack.local), não verá o progresso da implantação. Não execute novamente a implantação, em vez disso, entre como AzureStack\AzureStackAdmin com a mesma senha que o administrador local para validar se a instalação está em execução.
Exemplos de script de implantação do Microsoft Entra
Você pode criar scripts de toda a implantação do Microsoft Entra. Aqui estão alguns exemplos comentados que incluem alguns parâmetros opcionais.
Se sua identidade do Microsoft Entra estiver associada apenas a um diretório do Microsoft Entra:
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
$aadcred = Get-Credential "<Microsoft Entra administrator account name>"
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 52.168.138.145 #Example time server IP address.
Se sua identidade do Microsoft Entra estiver associada a mais de um diretório do Microsoft Entra:
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
$aadcred = Get-Credential "<Microsoft Entra 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 ambiente não tiver o DHCP habilitado, você deverá incluir os seguintes parâmetros adicionais em uma das opções acima (exemplo de uso fornecido):
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26
Parâmetros opcionais do ASDK InstallAzureStackPOC.ps1
| Parâmetro | Obrigatório/Opcional | Descrição |
|---|---|---|
| AdminPassword | Obrigatório | Define a conta de administrador local e todas as outras contas de usuário em todas as VMs criadas como parte da implantação do ASDK. Essa senha deve corresponder à senha de administrador local atual no host. |
| InfraAzureDirectoryTenantName | Obrigatório | Define o diretório de locatários. Use esse parâmetro para especificar um diretório específico em que a conta do Microsoft Entra tenha permissões para gerenciar vários diretórios. Nome completo de um locatário do Microsoft Entra no formato .onmicrosoft.com ou um nome de domínio personalizado verificado pela ID do Microsoft Entra. |
| Servidor de Tempo | Obrigatório | Use esse parâmetro para especificar um servidor de horário específico. Esse parâmetro deve ser fornecido como um endereço IP do servidor de horário válido. Não há suporte para nomes de servidor. |
| InfraAzureDirectoryTenantAdminCredential | Opcional | Define o nome de usuário e a senha do Microsoft Entra. Essas credenciais do Azure devem ser uma ID da organização. |
| Ambiente InfraAzure | Opcional | Selecione o Ambiente do Azure com o qual você deseja registrar essa implantação do Azure Stack. As opções incluem Azure global, Azure - China, Azure - Governo dos EUA. |
| Administrador de DNS | Opcional | Um servidor DNS é criado como parte da implantação do Azure Stack. Para permitir que os computadores dentro da solução resolvam nomes fora do selo, forneça o servidor DNS de infraestrutura existente. O servidor DNS no selo encaminha solicitações de resolução de nomes desconhecidos para esse servidor. |
| Novamente Executada | Opcional | Use esse sinalizador para executar novamente a implantação. Todas as entradas anteriores são usadas. Não há suporte para a reinserção de dados fornecidos anteriormente porque vários valores exclusivos são gerados e usados para implantação. |
Executar configurações pós-implantação
Depois de instalar o ASDK, há algumas verificações pós-instalação recomendadas e alterações de configuração que devem ser feitas. Valide se a instalação foi instalada com êxito usando o cmdlet test-AzureStack e instale as ferramentas do Azure Stack PowerShell e do GitHub.
Recomendamos que você redefina a política de expiração de senha para garantir que a senha do host ASDK não expire antes do término do período de avaliação.
Observação
Opcionalmente, você também pode definir as configurações de telemetria do Azure Stack depois de instalar o ASDK.
Tarefas pós-implantação do ASDK
Registrar-se no Azure
Você deve registrar o Azure Stack no Azure para poder baixar itens do Azure Marketplace para o Azure Stack.
Registrar o Azure Stack no Azure
Próximas etapas
Parabéns! Depois de concluir essas etapas, você terá um ambiente ASDK com portais de administrador https://adminportal.local.azurestack.external e de usuário https://portal.local.azurestack.external .