Solucionar problemas de artefatos em máquinas virtuais de laboratório no Azure DevTest Labs

Esse artigo orienta você através de possíveis causas e etapas de solução de problemas para falhas de artefatos em seus recursos de máquina virtual (VM) do Azure DevTest Labs.

Artefatos são ferramentas, ações ou softwares que você pode instalar nas VMs de laboratório durante ou após a criação da VM. Os proprietários de laboratório podem pré-selecionar artefatos obrigatórios a serem aplicados em todas as VMs de laboratório na criação, e os usuários do laboratório podem aplicar artefatos às VMs que eles possuem. Vários problemas possíveis podem fazer com que os artefatos não sejam instalados e aplicados a um laboratório ou executados corretamente num VM de laboratório.

Quando um artefato parece parar de responder, a primeira etapa é tentar determinar por que o processo está travado. A instalação do artefato pode ser bloqueada durante a solicitação inicial ou falhar durante a execução da solicitação. Você pode solucionar falhas de artefatos no portal do Azure ou na VM onde ocorre a falha do artefato.

Solucionar problemas no portal do Azure

Se um artefacto não se aplicar com sucesso ao seu VM de laboratório, pode começar por investigar o estado do seu VM no portal do Azure. Você pode encontrar informações sobre o estado da VM, confirmar se ela está em execução e verificar se os artefatos podem ser aplicados. Os dados do log de atividades da VM do laboratório mostram entradas sobre processos de instalação. É possível verificar as entradas para localizar informações sobre falhas de artefato.

Verificar o status da VM

Verifique o estado da VM no portal do Azure seguindo essas etapas:

1. Navegue até a página Visão geral da VM do laboratório DevTest Labs e confirme se a máquina está em execução:

   

2. Selecione Artefatos e abra a lista de artefatos da VM do laboratório:

   

3. Verifique a opção Aplicar artefatos e confirme se a VM do laboratório está pronta para aceitar artefatos aplicados:

   

   Quando a opção Aplicar artefatos estiver esmaecida, você não poderá aplicar artefatos à VM do laboratório e verá uma mensagem de notificação na página:

   

Use o comando do PowerShell

Também pode utilizar o Azure PowerShell para verificar se o seu VM de laboratório pode receber artefatos aplicados.

O seguinte comando GET retorna o sinalizador canApplyArtifacts com um valor True ou False. Para executar o comando, substitua o parâmetro $LabName/$VmName pelo nome do laboratório e pelo nome da VM e especifique o grupo de recursos do laboratório no parâmetro $LabRgName.

Select-AzSubscription -SubscriptionId $SubscriptionId | Out-Null
$vm = Get-AzResource `
        -Name "$LabName/$VmName" `
        -ResourceGroupName $LabRgName `
        -ResourceType 'microsoft.devtestlab/labs/virtualmachines' `
        -ApiVersion '2018-10-15-preview' `
        -ODataQuery '$expand=Properties($expand=ComputeVm)'
$vm.Properties.canApplyArtifacts

Investigue detalhes do artefato com falha

Um artefato pode parar de responder e eventualmente aparecer como Falha na lista de artefatos da VM do laboratório.

Investigue artefatos com falha seguindo essas etapas:

1. Navegue até a página da lista Artefatos da VM do laboratório e selecione o artefato com o status Com falha:

   

2. A visualização de detalhes do Artefato é aberta. Os detalhes incluem as informações Mensagem de implantação e Mensagem de extensão sobre a falha do artefato:

   

Inspecione os registros de atividades

Para instalar artefatos, o DevTest Labs cria e implanta um modelo do ARM (Azure Resource Manager) que solicita o uso da CSE (extensão de script personalizado). Um erro a esse nível aparece nos registos de atividades da subscrição e do grupo de recursos que contém o VM do laboratório.

Inspecione as entradas do log de atividades em busca de falhas relacionadas à instalação ou aplicação do artefato na VM do laboratório com essas etapas:

1. Navegue até a página Log de atividades da VM do laboratório e localize o artefato com o status Falha:

   

2. Selecione a entrada para abrir o painel de detalhes e visualizar as informações de registro:

   • Se você estiver tentando aplicar o artefato diretamente à VM do laboratório, procure erros de falha relacionados ao processo de instalação da extensão Criar ou atualizar máquina virtual.

   • Se você estiver criando uma VM e aplicando o artefato durante o processo, procure erros de falha relatados para o processo de instalação Criar ou Atualizar Máquina Virtual.

   O título do painel corresponde ao título da entrada, como Aplicar artefatos à máquina virtual:

   

3. No painel de detalhes, selecione JSON para revisar o conteúdo da carga JSON. Você pode ver o erro no final do documento JSON:

   

Investigar o repositório de artefatos e a conta de armazenamento no laboratório

Ao aplicar um artefato, o DevTest Labs lê a configuração do artefato e os arquivos dos repositórios configurados. Se um artefato não for instalado ou aplicado à VM do laboratório, o problema poderá estar relacionado ao acesso ao repositório.

Por padrão, o DevTest Labs tem acesso ao repositório de artefatos público do DevTest Labs. Você também pode conectar um laboratório a um repositório privado para acessar artefatos personalizados. Dependendo da configuração, as VMs de laboratório podem não ter acesso direto ao repositório de artefatos. O DevTest Labs armazena em cache os artefatos em uma conta de armazenamento no laboratório criada quando o laboratório é inicializado pela primeira vez.

• Se um artefato personalizado falhar na instalação, certifique-se de que o token de acesso pessoal (PAT) do repositório privado não tenha expirado. Se o PAT expirar, o artefato não será listado e todos os scripts que se referem aos artefatos desse repositório falharão.

• Se o acesso à conta de armazenamento estiver bloqueado, poderá ver um erro semelhante a esse exemplo:

  CSE Error: Failed to download all specified files. Exiting. Exception: Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (403) Forbidden. ---> System.Net.WebException: The remote server returned an error: (403) Forbidden.
  

  Um cenário em que você pode encontrar esse erro é quando o tráfego é bloqueado da VM para o serviço Armazenamento do Microsoft Azure. O erro aparece no log de atividades do grupo de recursos da VM do laboratório.

Identifique problemas de conexão do repositório com a conta do Armazenamento do Microsoft Azure com essas etapas:

1. Verifique se há NSG (grupos de segurança de rede) adicionados. Se uma política de assinatura for adicionada para configurar automaticamente NSGs em todas as redes virtuais, ela poderá afetar a rede virtual usada para criar suas VMs de laboratório.

2. Verifique todas as regras do NSG:

   • Use a verificação de fluxo de IP para determinar se uma regra de NSG está bloqueando o tráfego para ou de uma VM.

   • Revise as regras eficazes do grupo de segurança para garantir que exista uma regra de entrada Permitir NSG. Para saber mais, confira Usar regras de segurança efetivas para solucionar problemas de fluxo de tráfego de VM.

3. Verifique a conta de armazenamento padrão do seu laboratório.

   A conta de armazenamento padrão é a primeira conta de armazenamento criada durante a criação do laboratório. O nome geralmente começa com a letra "a" e termina com um número de vários dígitos, como a<labname>#.

   1. Navegue até a página Visão geral da VM do laboratório DevTest Labs e selecione Visualizador de recursos.

   2. No diagrama, localize a conta de armazenamento que tem um nome que corresponde à convenção de nomenclatura descrita, a<labname>#.

   3. Selecione o recurso Conta de armazenamento para ver o menu pop-up e selecione Exibir:

      

   4. Na página Visão geral da conta de armazenamento, expanda a seção Segurança + rede no menu esquerdo e selecione Rede:

      

   5. Na aba Firewalls e redes virtuais, verifique a configuração da opção Acesso à rede pública:

      1. Se Habilitado a partir de redes virtuais e endereços IP selecionados estiver selecionado, confirme se a lista de endereços IP permitidos mostra as redes virtuais do laboratório que podem ser usadas para criar VMs de laboratório:

         

      2. Caso contrário, confirme se Habilitado em todas as redes está selecionado:

         

Para uma solução de problemas detalhada, veja Configurar redes virtuais e firewalls do Armazenamento do Microsoft Azure.

Solucionar problemas na máquina do laboratório

Você pode se conectar à VM do laboratório onde o artefato falhou e investigar o problema.

Inspecionar arquivo de log de extensão de script personalizado

Visualize o arquivo de log Custom Script Extension (CSE) para uma VM do Windows seguindo essas etapas:

1. Conecte-se à VM do laboratório do DevTest Labs em execução.

2. Abra uma janela do Explorador de Arquivos e vá para C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\<CSE version>\Status\. Um exemplo <Versão CSE> é 1.10.12.

   

3. Abra e inspecione um arquivo STATUS para visualizar o erro, como 1.status.

Para obter instruções sobre como localizar os arquivos de log em uma VM Linux, consulte: Usar a Extensão de Script Personalizado do Azure versão 2 com máquinas virtuais Linux.

Verifique o Agente de Máquina Virtual do Azure

Certifique-se de que o Agente de Máquina Virtual do Azure (Agente de VM) da VM do seu laboratório esteja instalado e pronto.

Quando a VM do laboratório for iniciada pela primeira vez ou quando o CSE for instalado pela primeira vez para atender à solicitação de aplicação de artefatos, a VM do laboratório poderá precisar atualizar o Agente da VM ou aguardar a inicialização do Agente da VM. O Agente de VM pode depender de serviços que levam muito tempo para serem inicializados.

Determine se o Agente VM está fazendo com que o artefato pare de responder seguindo essas etapas:

1. Conecte-se à VM do laboratório do DevTest Labs em execução.

2. Abra uma janela do Explorador de Arquivos e vá para a pasta que contém os arquivos de log da sua VM de laboratório, como C:\WindowsAzure\logs.

3. Abra o arquivo WaAppAgent.log.

4. No arquivo de log, procure entradas que mostrem o Agente VM iniciando, finalizando a inicialização e enviando a primeira pulsação. Verifique as entradas em busca de carimbos de data/hora em torno do momento em que você teve o problema do artefato. O snippet a seguir mostra alguns exemplos de entradas do arquivo de log:

   [00000006] [11/14/2019 05:52:13.44] [INFO]  WindowsAzureGuestAgent starting. Version 2.7.41491.949
   ...
   [00000006] [11/14/2019 05:52:31.77] [WARN]  Waiting for OOBE to Complete ...
   ...
   [00000006] [11/14/2019 06:02:30.43] [WARN]  Waiting for OOBE to Complete ...
   [00000006] [11/14/2019 06:02:33.43] [INFO]  StateExecutor initialization completed.
   [00000020] [11/14/2019 06:02:33.43] [HEART] WindowsAzureGuestAgent Heartbeat.
   

   Nesse exemplo, o Agente VM demorou 10 minutos e 20 segundos para iniciar. O atraso ocorre porque o serviço de experiência pronta para uso (OOBE) demorou muito para ser iniciado. O longo tempo de início do Agente VM fez com que o artefato parasse de responder.

Para obter informações gerais sobre extensões do Azure, confira Recursos e extensões de máquina virtual do Azure. Para obter mais ideias de resolução de problemas, veja visão geral do Agente de Máquina Virtual Azure.

Investigar problemas de script

Outro motivo pelo qual a instalação do artefato pode falhar é a forma como o script de instalação do artefato é criado.

Aqui estão alguns exemplos de possíveis problemas de script:

• O script possui parâmetros obrigatórios, mas um valor esperado não é passado durante a execução do script. Esse cenário pode acontecer se o usuário tiver permissão para deixar um parâmetro esperado em branco e um valor padrão não for especificado no arquivo de definição artifactfile.json. Como resultado, o script para de responder porque está aguardando a entrada do usuário. Quando o script requer valores de parâmetros, é uma boa prática definir padrões e exigir que o usuário insira um valor.

• O script requer ação do usuário durante a execução do script. Esse cenário pode acontecer se houver um longo atraso na execução do script enquanto aguarda a ação do usuário. É uma boa prática criar scripts que possam funcionar silenciosamente sem exigir a intervenção do usuário.

Determine se o script está fazendo com que o artefato pare de responder seguindo essas etapas:

1. Conecte-se à VM do laboratório do DevTest Labs em execução.

2. Abra uma janela do Explorador de Arquivos.

3. Vá para a pasta Download que contém o script de instalação do artefato para sua VM, como C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\<CSE version>\Downloads\. Um exemplo <Versão CSE> é 1.10.12.

   Para as etapas subsequentes, você pode trabalhar com o script nessa pasta ou copiar o script para uma pasta de trabalho na sua VM.

4. Abra uma janela do prompt de comando com privilégios administrativos em sua VM.

5. Execute o script de instalação do artefato na janela do prompt de comando.

   Siga os prompts do script e insira os valores de parâmetro necessários. Para investigar se a falta de entrada do usuário ou a ação atrasada do usuário causa um problema, tente reproduzir o comportamento específico.

6. Determine se o script demonstra comportamento inesperado ou problemático.

7. Conforme necessário, corrija o script na VM do laboratório e execute-o novamente para confirmar que os problemas foram resolvidos.

Verifique a estrutura do artefato

Um artefato personalizado precisa ter a estrutura adequada. Certifique-se de confirmar se os artefatos customizados no script de instalação do artefato implementam a estrutura correta. Os recursos a seguir fornecem informações para ajudá-lo a concluir essa verificação:

• Para saber mais sobre como construir corretamente um artefato, confira Criar artefatos personalizados.
• Para ver um exemplo de um artefato corretamente estruturado, verifique o artefato Testar tipos de parâmetro.
• Para obter mais informações sobre como grava e corrigir scripts de artefato, consulte CRIAÇÃO.

Solicitar atualização de script

Você pode enviar correções de script propostas para artefatos hospedados no repositório público do DevTest Labs. Para obter detalhes, confira a seção Contribuições no documento README.

Obtenha suporte

Se precisar de ajuda adicional, tente um dos seguintes canais de suporte:

• Pesquise nos recursos do site da Comunidade da Microsoft informações sobre o Azure DevTest Labs e acesse postagens no Stack Overflow.

• Conecte-se ao @AzureSupport, a conta oficial do Microsoft Azure para melhorar a experiência do cliente. O Suporte do Azure conecta a Comunidade do Azure a respostas, suporte e especialistas.

Conteúdo relacionado

• Solucionar problemas de falhas de implantação de máquinas virtuais no Azure DevTest Labs
• Artefato de tipos de parâmetros de teste