Compartilhar via

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

  • Artigo

Observação

O State Configuration da Automação do Azure será desativado em 30 de setembro de 2027, faça a transição para a Configuração de Máquina do Azure até essa data. Para saber mais, confira a postagem no blog sobre o anúncio. O serviço de Configuração de Máquina do Azure combina recursos da Extensão DSC, da Configuração de Estado da Automação do Azure e dos recursos mais solicitados por meio de comentários dos clientes. A Configuração de Máquinas do Azure também inclui suporte a máquina híbrida por meio servidores habilitados para Arc.

Cuidado

O DSC de Automação do Azure para Linux foi desativado em 30 de setembro de 2023. Para obter mais informações, confira o comunicado.

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

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

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

Se quiser um exemplo de ambiente já configurado sem seguir as etapas descritas neste artigo, você poderá usar o modelo de nó gerenciado da Automação do Azure. Este modelo configura um ambiente completo do State Configuration (DSC), incluindo uma máquina virtual do Azure gerenciada pelo State Configuration (DSC).

Pré-requisitos

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

Criar uma configuração de DSC

Crie uma configuração de DSC simples que garante a presença ou a ausência do WindowsFeature do Servidor Web (IIS), dependendo de como os nós são atribuídos.

Os nomes de configuração na 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 na Automação do Azure

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

  1. Entre no portal do 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.

    Captura de tela da folha Importar Configuração

  6. Selecione OK.

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

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

  1. Entre no portal do 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.

    Captura de tela da folha TestConfig configuration (Configuração do TestConfig)

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

Compilar uma configuração na 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 uma descrição mais detalhada das configurações de compilação no State Configuration (DSC), consulte Compilar configurações no State Configuration da Automação do Azure. Para obter mais informações sobre a compilação das configurações, consulte Configurações da DSC.

  1. Entre no portal do 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.

    Captura de tela da página de configuração de TestConfig realçando o botão de compilação

Observação

Quando você compila uma configuração na Automação do Azure, ela implanta automaticamente quaisquer arquivos MOF de configuração de nó no servidor de pull.

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 com falha. 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 do 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.

    Captura de tela da página Trabalho de Compilação

  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 com êxito de um trabalho de compilação cria uma ou mais novas configurações de nó. Uma configuração de nó é um documento MOF que você implanta no servidor de pull. É 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 formulário ConfigurationName.NodeName.

  1. Entre no portal do 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.

    Captura de tela da guia Configurações Compiladas

Habilitar uma VM do Azure Resource Manager para gerenciamento com o State Configuration

É possível usar o State Configuration para gerenciar VMs do Azure (tanto clássica quanto do gerenciador de recursos), VMs locais, computadores Linux, VMs de AWS e computadores físicos locais. Neste artigo, você aprenderá como habilitar somente VMs do Azure Resource Manager. Para obter mais informações sobre como habilitar outros tipos de computadores, consulte Habilitar computadores para gerenciamento pelo State Configuration da Automação do Azure.

  1. Entre no portal do 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 Nós e, em seguida, selecione + Adicionar.

    Captura de tela da página Nós DSC realçando o botão Adicionar VM do Azure

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

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

    Importante

    A VM deve ser do Azure Resource Manager e executar um sistema operacional compatível.

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

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

    Captura de tela da folha Registro

    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 Gerenciador de Configuração Local.

O Azure inicia o processo de habilitar a VM. Quando concluída, a VM aparece na guia Nós da página DSC (State Configuration) na conta de Automação.

Exibir a lista de nós gerenciados

A guia Nós da página DSC (State Configuration) contém uma lista de todos os computadores habilitados para gerenciamento em sua conta de Automação.

  1. Entre no portal do 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 guiaNó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 o check-in do nó.
  • 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 descompasso ocorre atualmente.

Observação

  • RefreshFrequencyMins – Define a frequência do nó que entra em contato com o serviço do agente e pode ser fornecido como parte da integração ao DSC. Isso leva um valor máximo de 10080 minutos.
  • O nó será marcado como Unresponsive se ele não entrar em contato com o serviço do agente por 1440 minutos (1 dia). Recomendamos que você use o valor RefreshFrequencyMins< 1440 minutos, caso contrário, o nó será exibido em um estado falso Unresponsive.

Exibir relatórios para nós gerenciados

Sempre que o State Configuration executar uma verificação de consistência em um nó gerenciado, o nó enviará um relatório de status de volta ao servidor de pull. Exiba esses relatórios na página do nó.

  1. Entre no portal do 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 guiaNós . Aqui, é possível ver a visão geral do estado da Configuração e os detalhes de cada nó.

    Captura de tela da página de Nó

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

    Captura de tela do painel Relatório

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 o computador não está no estado desejado.
  • A hora de início para a verificação de consistência.
  • O runtime 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 depois de um nó ser habilitado até que o primeiro relatório esteja disponível. Talvez seja necessário aguardar até 30 minutos para o primeiro relatório após você habilitar um nó.

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

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

  1. Entre no portal do 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 guiaNós .

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

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

    Captura de tela da página de detalhes do Nó, realçando o botão 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.

    Captura de tela da página Atribuir Configuração de Nó

Cancelar o registro de um nó

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

Próximas etapas