Configurações pós-implantação do ASDK

  • Artigo

Depois de instalar o ASDK (Azure Stack Development Kit), você deverá fazer algumas alterações de configuração pós-implantação recomendadas enquanto estiver conectado como AzureStack\AzureStackAdmin no computador host do ASDK.

Instalar o PowerShell do Azure Stack

Os módulos de Azure PowerShell compatíveis com o Azure Stack são necessários para trabalhar com o Azure Stack.

Os comandos do PowerShell para o Azure Stack são instalados por meio do Galeria do PowerShell. Para registrar o repositório PSGallery, abra uma sessão do PowerShell com privilégios elevados e execute o seguinte comando:

Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

Use perfis de versão da API para especificar módulos Az compatíveis com o Azure Stack. Os perfis de versão da API fornecem uma maneira de gerenciar as diferenças de versão entre o Azure e o Azure Stack. Um perfil de versão da API é um conjunto de módulos do Az PowerShell com versões de API específicas. O módulo Az.BootStrapper que está disponível por meio do Galeria do PowerShell fornece cmdlets do PowerShell necessários para trabalhar com perfis de versão da API.

Você pode instalar o módulo mais recente do Azure Stack PowerShell com ou sem conectividade com a Internet para o computador host do ASDK.

  1. Valide seus pré-requisitos em seu computador Windows. Para obter instruções, consulte Pré-requisitos para Windows.
  2. Antes de instalar a versão necessária do PowerShell, desinstale todos os módulos Azure PowerShell existentes.
  • Com uma conexão com a Internet do computador host do ASDK: execute o seguinte script do PowerShell para instalar esses módulos na instalação do ASDK:
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

  Install-Module -Name Az.BootStrapper -Force
  Install-AzProfile -Profile 2020-09-01-hybrid -Force
  Install-Module -Name AzureStack -RequiredVersion 2.1.0

  Get-Module -Name "Az*" -ListAvailable
  Get-Module -Name "Azs*" -ListAvailable

Se a instalação for bem-sucedida, os módulos Az e AzureStack serão exibidos na saída.

  • Sem uma conexão com a Internet do computador host DO ASDK: em um cenário desconectado, primeiro você deve baixar os módulos do PowerShell para um computador que tenha conectividade com a Internet usando os seguintes comandos do PowerShell:
$Path = "<Path that is used to save the packages>"

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Az -Path $Path -Force -RequiredVersion 1.10.0

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 2.1.0

Em seguida, copie os pacotes baixados para o computador ASDK e registre o local como o repositório padrão e instale os módulos Az e AzureStack deste repositório:

$SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
$RepoName = "MyNuGetSource"

Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted

Install-Module Az -Repository $RepoName

Install-Module AzureStack -Repository $RepoName

Baixar as ferramentas do Azure Stack

O AzureStack-Tools é um repositório GitHub que hospeda módulos do PowerShell para gerenciar e implantar recursos no Azure Stack. Use as ferramentas usando os módulos do Az PowerShell ou os módulos do AzureRM.

Para obter essas ferramentas, clone o repositório GitHub do az branch ou baixe a pasta AzureStack-Tools executando o seguinte script:

# Change directory to the root directory.
cd \

# Download the tools archive.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
invoke-webrequest `
  https://github.com/Azure/AzureStack-Tools/archive/az.zip `
  -OutFile az.zip

# Expand the downloaded files.
expand-archive az.zip `
  -DestinationPath . `
  -Force

# Change to the tools directory.
cd AzureStack-Tools-az

Validar a instalação do ASDK

Para garantir que a implantação do ASDK tenha sido bem-sucedida, use o cmdlet Test-AzureStack seguindo estas etapas:

  1. Entre como AzureStack\AzureStackAdmin no computador host do ASDK.
  2. Abra o PowerShell como administrador (não o ISE do PowerShell).
  3. Execute: Enter-PSSession -ComputerName AzS-ERCS01 -ConfigurationName PrivilegedEndpoint
  4. Execute: Test-AzureStack

Os testes levam alguns minutos para serem concluídos. Se a instalação tiver sido bem-sucedida, a saída será semelhante a:

Testar o Azure Stack – Instalação bem-sucedida

Se houve uma falha, siga as etapas de solução de problemas para obter ajuda.

Habilitar multilocação

Para implantações que usam Microsoft Entra ID, você precisa habilitar a multilocação para a instalação do ASDK.

Observação

Quando contas de administrador ou usuário de domínios diferentes daquela usadas para registrar o Azure Stack são usadas para fazer logon em um portal do Azure Stack, o nome de domínio usado para registrar o Azure Stack deve ser acrescentado à URL do portal. Por exemplo, se o Azure Stack tiver sido registrado com fabrikam.onmicrosoft.com e o logon da conta de usuário for admin@contoso.com, a URL a ser usada para fazer logon no portal do usuário será: https://portal.local.azurestack.external/fabrikam.onmicrosoft.com.

Próximas etapas

Registrar o ASDK com o Azure