Compartilhar via

Implantar o agente local

  • Artigo

Saiba como usar o agente local vaaS (validação como serviço) para executar testes de validação. O agente local deve ser implantado antes de executar testes de validação.

Observação

Verifique se o computador no qual o agente local está em execução não perde o acesso de saída à Internet. Esse computador deve ser acessível somente para usuários autorizados a usar o VaaS em nome do seu locatário.

Para implantar o agente local:

  1. Baixe e instale o agente local.
  2. Execute verificações de integridade antes de iniciar os testes.
  3. Execute o agente local.

Baixar e iniciar o agente local

Baixe o agente em um computador que atenda aos pré-requisitos em seu datacenter e tenha acesso a todos os pontos de extremidade do Azure Stack Hub. Esse computador não deve fazer parte do sistema do Azure Stack Hub nem hospedado na nuvem do Azure Stack Hub.

Pré-requisitos do computador

Verifique se o computador atende aos seguintes critérios:

  • Acesso a todos os pontos de extremidade do Azure Stack Hub.
  • O .NET 4.6 e o PowerShell 5.0 instalados.
  • Pelo menos 8 GB de RAM.
  • Processadores mínimos de 8 núcleos.
  • Espaço em disco mínimo de 200 GB.
  • Conectividade de rede estável com a Internet.

Baixar e instalar o agente local

  1. Abra Windows PowerShell em um prompt com privilégios elevados no computador que você usará para executar os testes.

  2. Execute o comando a seguir para baixar e instalar as dependências do agente local e copiar as imagens de PIR (repositório de imagens públicas) (VHD) para o ambiente do Azure Stack Hub.

    # Review and update the following five parameters
$RootFolder = "c:\VaaS"
$CloudAdmindUserName = "<Cloud admin user name>"
$CloudAdminPassword = "<Cloud admin password>"
$AadServiceAdminUserName = "<AAD service admin user name>"
$AadServiceAdminPassword = "<AAD service admin password>"

if (-not(Test-Path($RootFolder))) {
    mkdir $RootFolder
}
Set-Location $RootFolder
Invoke-WebRequest -Uri "https://storage.azurestackvalidation.com/packages/Microsoft.VaaSOnPrem.TaskEngineHost.latest.nupkg" -outfile "$rootFolder\OnPremAgent.zip"
Expand-Archive -Path "$rootFolder\OnPremAgent.zip" -DestinationPath "$rootFolder\VaaSOnPremAgent" -Force
Set-Location "$rootFolder\VaaSOnPremAgent\lib\net46"

$cloudAdminCredential = New-Object System.Management.Automation.PSCredential($cloudAdmindUserName, (ConvertTo-SecureString $cloudAdminPassword -AsPlainText -Force))
$getStampInfoUri = "https://ASAppGateway:4443/ServiceTypeId/4dde37cc-6ee0-4d75-9444-7061e156507f/CloudDefinition/GetStampInformation" 
$stampInfo = Invoke-RestMethod -Method Get -Uri $getStampInfoUri -Credential $cloudAdminCredential -ErrorAction Stop
$serviceAdminCreds = New-Object System.Management.Automation.PSCredential $aadServiceAdminUserName, (ConvertTo-SecureString $aadServiceAdminPassword -AsPlainText -Force)
Import-Module .\VaaSPreReqs.psm1 -Force
Install-VaaSPrerequisites -AadTenantId $stampInfo.AADTenantID `
                        -ServiceAdminCreds $serviceAdminCreds `
                        -ArmEndpoint $stampInfo.AdminExternalEndpoints.AdminResourceManager `
                        -Region $stampInfo.RegionName

Observação

Install-VaaSPrerequisites o cmdlet baixa arquivos de imagem de VM grandes. Se você estiver enfrentando uma velocidade de rede lenta, poderá baixar arquivos para o servidor de arquivos local e adicionar manualmente imagens de VM ao ambiente de teste. Para obter mais informações, consulte Lidar com conectividade de rede lenta.

Parâmetros

Parâmetro Descrição
AadServiceAdminUser O usuário administrador global do locatário Microsoft Entra. Por exemplo: vaasadmin@contoso.onmicrosoft.com.
AadServiceAdminPassword A senha do usuário administrador global.
CloudAdminUserName O usuário administrador de nuvem que pode acessar e executar comandos permitidos no ponto de extremidade privilegiado. Por exemplo: AzusreStack\CloudAdmin. Para obter mais informações, consulte Parâmetros comuns do fluxo de trabalho para VaaS.
CloudAdminPassword A senha da conta de administrador de nuvem.

Baixar pré-requisitos para o agente local

Executar verificações de sanidade antes de iniciar os testes

Os testes executam operações remotas. O computador que executa os testes deve ter acesso aos pontos de extremidade do Azure Stack Hub, caso contrário, os testes não funcionarão. Se você estiver usando o agente local do VaaS, use o computador em que o agente será executado. Você pode marcar que seu computador tenha acesso aos pontos de extremidade do Azure Stack Hub executando as seguintes verificações:

  1. Verifique se o URI base pode ser alcançado. Abra um prompt cmd ou shell bash e execute o seguinte comando, substituindo <EXTERNALFQDN> pelo FQDN (nome de domínio totalmente qualificado) externo do seu ambiente:

    nslookup adminmanagement.<EXTERNALFQDN>

  2. Abra um navegador e acesse https://adminportal.<EXTERNALFQDN> para marcar que o Portal do MAS possa ser acessado.

  3. Entre usando os valores de nome do administrador do serviço Microsoft Entra e senha fornecidos ao criar a passagem de teste.

  4. Verifique a integridade do sistema executando o cmdlet Test-AzureStack PowerShell, conforme descrito em Executar um teste de validação para o Azure Stack Hub. Corrija quaisquer avisos e erros antes de iniciar os testes.

Executar o agente local

  1. Abra Windows PowerShell em um prompt com privilégios elevados.

  2. Execute o comando a seguir:

    # Review and update the following five parameters
$RootFolder = "c:\VAAS"
$CloudAdmindUserName = "<Cloud admin user name>"
$CloudAdminPassword = "<Cloud admin password>"
$VaaSUserId = "<VaaS user ID>"
$VaaSTenantId = "<VaaS tenant ID>"

Set-Location "$rootFolder\VaaSOnPremAgent\lib\net46"
.\Microsoft.VaaSOnPrem.TaskEngineHost.exe -u $VaaSUserId -t $VaaSTenantId -x $CloudAdmindUserName -y $CloudAdminPassword

    Parâmetros

    Parâmetro Descrição
    CloudAdminUserName O usuário administrador de nuvem que pode acessar e executar comandos permitidos no ponto de extremidade privilegiado. Por exemplo: AzusreStack\CloudAdmin. Consulte Parâmetros comuns de fluxo de trabalho para VaaS para obter mais informações.
    CloudAdminPassword A senha da conta de administrador de nuvem.
    VaaSUserId ID de usuário usada para entrar no portal de validação do Azure Stack Hub. Por exemplo: UserName@Contoso.com).
    VaaSTenantId Azure AD ID de locatário para a conta do Azure registrada com validação como serviço.

    Observação

    Quando você executa o agente, o diretório de trabalho atual deve ser o local do executável do host do mecanismo de tarefas, Microsoft.VaaSOnPrem.TaskEngineHost.exe.

Se você não vir nenhum erro relatado, o agente local terá êxito. O texto de exemplo a seguir aparece na janela do console.

Heartbeat was sent successfully.

Agente iniciado

Um agente é identificado exclusivamente pelo nome. Por padrão, ele usa o nome FQDN do computador de onde ele foi iniciado. Você deve minimizar a janela para evitar seleções acidentais na janela, pois alterar o foco pausa todas as outras ações.

Próximas etapas