Introdução ao Automação do Azure State Configuration

Este artigo fornece um guia passo a passo para realizar as tarefas mais comuns com Automação do Azure State Configuration, como:

• criar, importar e compilar configurações
• habilitar computadores para gerenciar
• visualizando relatórios

Para obter uma visão geral State Configuration, consulte State Configuration visão geral. Para a documentação do Desired State Configuration (DSC), consulte Visão geral do Desired State Configuration do Windows PowerShell.

Se você quiser um ambiente de exemplo que já esteja configurado sem seguir as etapas descritas neste artigo, poderá usar o modelo Automação do Azure Managed Node. Esse modelo configura um ambiente de State Configuration (DSC) completo, incluindo uma máquina virtual Azure gerenciada por State Configuration (DSC).

Pré-requisitos

Para concluir os exemplos neste artigo, são necessários:

• Uma conta Automação do Azure. Para saber mais sobre uma conta de automação e seus requisitos, consulte visão geral da autenticação da conta de automação.
• Uma VM Azure Resource Manager (não Clássica) executando um sistema operacional suportado. Para obter instruções sobre como criar uma VM, consulte Criar sua primeira máquina virtual Windows no portal Azure

Criar uma configuração de DSC

Você cria uma configuração DSC simples que garante a presença ou ausência do recurso Web-Server Windows Feature (IIS), dependendo de como você atribui os nós.

Os nomes de configuração em Automação do Azure devem ser limitados a no máximo 100 caracteres.

1. Inicie o VS Code (ou qualquer editor de texto).

2. Digite o seguinte texto:

   configuration TestConfig
   {
       Node IsWebServer
       {
           WindowsFeature IIS
           {
               Ensure               = 'Present'
               Name                 = 'Web-Server'
               IncludeAllSubFeature = $true
           }
       }
   
       Node NotWebServer
       {
           WindowsFeature IIS
           {
               Ensure               = 'Absent'
               Name                 = 'Web-Server'
           }
       }
   }
   

3. Salve o arquivo como TestConfig.ps1.

Essa configuração chama um recurso em cada bloco de nó, o recurso WindowsFeature. Esse recurso garante a presença ou a ausência do recurso Servidor Web.

Importar uma configuração para Automação do Azure

Em seguida, importe a configuração para a conta de Automação.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página DSC (State Configuration), selecione a guia Configurações e, em seguida, selecione Adicionar.

5. No painel Configuração de importação, vá para o arquivo TestConfig.ps1 no seu computador.

   

6. Selecione OK.

Exibir uma configuração no Automação do Azure

Depois de importar uma configuração, você pode exibi-la no portal do Azure.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página DSC (State Configuration), selecione a guia Configurações e, em seguida, selecione o nome da configuração importada no procedimento anterior, TestConfig.

5. No painel Configuração do TestConfig, selecione Exibir origem da configuração.

   

   O painel de origem de configuração TestConfig abre e mostra o código do PowerShell para a configuração.

Compilar uma configuração no Automação do Azure

Antes de aplicar um estado desejado a um nó, uma configuração DSC definindo esse estado deve ser compilada em uma ou mais configurações de nó (documento MOF) e colocada no Servidor de Pull do DSC de Automação. Para obter uma descrição mais detalhada da compilação de configurações no State Configuration (DSC), consulte Compile configurations in Automação do Azure State Configuration. Para obter mais informações sobre a compilação das configurações, consulte Configurações da DSC.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página DSC (State Configuration), selecione a guia Configurações e, em seguida, selecione o nome da configuração importada anteriormente, TestConfig.

5. Para iniciar o trabalho de compilação, selecione Compilar no painel Configuração do TestConfig e selecione Sim.

   

Exibir um trabalho de compilação

Após iniciar uma compilação, você poderá visualizá-la no bloco Trabalhos de Compilação na página Configuração. O bloco Trabalhos de Compilação mostra os trabalhos atualmente em execução, concluídos e falhados. Quando você abre um painel de trabalho de compilação, ela mostra informações sobre esse trabalho, incluindo quaisquer erros ou avisos encontrados, parâmetros de entrada usados na configuração e logs de compilação.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página DSC (State Configuration), selecione a guia Configurações e, em seguida, selecione o nome da configuração importada anteriormente, TestConfig.

5. Em Trabalhos de compilação, selecione o trabalho de compilação para exibir. Um painel de trabalho de compilação abre com a data em que o trabalho de compilação foi iniciado.

   

6. Para ver mais detalhes sobre o trabalho, selecione qualquer bloco no painel Trabalho de Compilação.

Exibir configurações de nó

A conclusão bem-sucedida de um trabalho de compilação resulta na criação de uma ou mais novas configurações de nós. Uma configuração de nó é um documento MOF que você implanta no servidor de coleta. É possível exibir as configurações de nós na conta de Automação na página State Configuration (DSC). Uma configuração de nó tem um nome com o formato ConfigurationName.NodeName.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página DSC (State Configuration), selecione a guia Configurações compiladas.

   

Habilitar uma VM Azure Resource Manager para gerenciamento com Configuração de Estado

Você pode usar State Configuration para gerenciar Azure VMs (clássicas e Resource Manager), VMs locais, computadores Linux, VMs AWS e computadores físicos locais. Neste artigo, você aprenderá a habilitar apenas Azure Resource Manager VMs. Para obter informações sobre como habilitar outros tipos de máquinas, consulte Enable machines for management by Automação do Azure State Configuration.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página Configuração do Estado (DSC), selecione a guia Nós e, em seguida, selecione + Adicionar.

   

5. No painel Máquinas Virtuais, selecione sua VM.

6. No painel de detalhes da máquina virtual, selecione + Conectar.

   Importante

   A máquina virtual deve ser uma VM do Azure Resource Manager executando um sistema operacional compatível.

7. Na página de registro, selecione o nome da configuração do nó a ser aplicado na VM no campo Nome da configuração do nó. Fornecer um nome neste ponto é opcional. Você pode alterar a configuração atribuída do nó após habilitar o nó.

8. Marque Reinicializar o nó, se necessário e clique em OK.

   

   A configuração de nó especificada é aplicada à VM em intervalos especificados pelo valor fornecido para Frequência do modo de configuração. A VM verifica se há atualizações para a configuração de nó em intervalos especificados pelo valor de Frequência de atualização. Para obter mais informações sobre como esses valores são usados, consulte Configurando o local Gerenciador de Configurações.

Azure inicia o processo de habilitação da VM. Quando concluída, a máquina virtual aparece na guia Nós da página de Configuração de Estado (DSC) na conta de Automação.

Exibir a lista de nós gerenciados

A aba Nodos da página de Configuração de Estado (DSC) contém uma lista de todas as máquinas habilitadas para gerenciamento em sua conta de Automação.

1. Entre no portal Azure.
2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.
3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.
4. Na página Configuração de Estado (DSC), selecione a guia Nós.

Valores de status de nós DSC

O nó DSC pode usar qualquer um dos seis valores a seguir da seguinte maneira:

• Failed – Esse status é exibido quando ocorre um erro ao aplicar uma ou mais configurações em um nó.
• Fora de conformidade – Esse status é exibido quando ocorre um descompasso em um nó e ele exige uma análise detalhada.
• Sem resposta – Esse status é exibido quando um nó não é verificado há mais de 24 horas.
• Pendente – Esse status é exibido quando um nó tem uma nova configuração a ser aplicada e o servidor de pull aguarda que o nó faça o check-in.
• In progress – Esse status é exibido quando um nó aplica a configuração e o servidor de pull aguarda o status.
• Compliant – Esse status é exibido quando um nó tem uma configuração válida e nenhum desvio ocorre atualmente.

Exibir relatórios de nós gerenciados

Sempre que State Configuration executa uma verificação de consistência em um nó gerenciado, o nó envia um relatório de status de volta para o servidor de pull. Você pode visualizar esses relatórios na página desse nó.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página de Configuração de Estado (DSC), selecione a guia Nós. Aqui, é possível ver a visão geral do estado da configuração e os detalhes de cada nó.

   

5. Enquanto estiver na guia Nós, selecione o registro do nó para acessar o relatório. Selecione o relatório que deseja visualizar.

   

Você pode ver as seguintes informações de status para a verificação de consistência correspondente:

• O status do relatório. Os valores possíveis são os seguintes:
  • Compliant - o nó está em conformidade com a verificação.
  • Failed - a configuração falhou na verificação.
  • Not Compliant - o nó está no modo ApplyandMonitor e a máquina não está no estado desejado.
• A hora de início para a verificação de consistência.
• O tempo de execução total para a verificação de consistência.
• O tipo de verificação de consistência.
• Quaisquer erros, incluindo o código de erro e a mensagem de erro.
• Todos os recursos do DSC usados na configuração e o estado de cada recurso (se o nó estiver no estado desejado para esse recurso). Você pode selecionar cada recurso para obter informações mais detalhadas sobre ele.
• O nome, o endereço IP e o modo de configuração do nó.

Você também pode selecionar Exibir relatório bruto para ver os dados reais que o nó envia ao servidor. Para obter mais informações sobre como usar esses dados, consulte Usando um servidor de relatório da DSC.

Pode levar algum tempo até que o primeiro relatório esteja disponível, depois que um nó seja habilitado ou reiniciado. Pode ser necessário esperar até 30 minutos após habilitar um nó ou reiniciá-lo.

Reatribuir um nó a uma configuração de nó diferente

Você pode atribuir um nó para que use uma configuração de nó diferente daquela que foi inicialmente atribuída.

1. Entre no portal Azure.

2. À esquerda, selecione Todos os recursos e, em seguida, o nome de sua conta de Automação.

3. Na página de conta da Automação, selecione State Configuration (DSC) em Gerenciamento de configuração.

4. Na página Configuração de Estado (DSC), selecione a guia Nós.

5. Na guia Nós, clique no nome do nó que você deseja reatribuir.

6. Na página do referido nó, selecione Atribuir configuração de nó.

   

7. Na página Atribuir Configuração de Nó, selecione a configuração do nó à qual você deseja atribuir o nó e selecione OK.

   

Cancelar o registro de um nó

Você pode cancelar o registro de um nó se não quiser mais que o State Configuration o gerencie. Consulte Como remover uma configuração e um nó da Configuração de Estado de Automação.

Próximas etapas

• Para obter uma visão geral, consulte a visão geral do Automação do Azure State Configuration.
• Para habilitar o recurso para VMs em seu ambiente, consulte Enable Automação do Azure State Configuration.
• Para entender o PowerShell DSC, consulte Visão geral da Configuração de Estado Desejado do Windows PowerShell.
• Para obter informações sobre preços, consulte preços do Automação do Azure State Configuration.
• Para obter uma referência de cmdlet do PowerShell, confira Az.Automation.
• Para solucionar problemas relacionados ao Automação do Azure State Configuration (DSC), consulte Solucionar problemas do Automação do Azure State Configuration.