Share via

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

  • Artigo

Observação

Antes de você habilitar a State Configuration da Automação, gostaríamos de informar que uma versão mais recente da DSC agora está em disponibilidade geral, gerenciada por um recurso de Azure Policy chamado configuração de convidado. O serviço de configuração de convidado combina recursos de extensão de DSC, State Configuration da Automação do Azure e os recursos mais solicitados dos comentários dos clientes. A configuração de convidado também inclui suporte a computadores híbridos por meio de servidores habilitados para Arc.

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, permitindo que os computadores gerenciem e exibam 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 VM 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 VSCode (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, clique em Todos os recursos e, em seguida, no 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 State Configuration (DSC), clique na guia Configurações e depois em Adicionar.

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

    Screenshot of the Import Configuration blade

  6. Clique em OK.

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

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

  1. Entre no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no 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 State Configuration (DSC), clique na guia Configurações e depois em TestConfig. Esse é o nome da configuração que você importou no procedimento anterior.

  5. No painel de configuração de TestConfig, clique em Exibir origem da configuração.

    Screenshot of the TestConfig configuration blade

    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, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.

  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.

  4. Na página State Configuration (DSC), clique na guia Configurações e depois em TestConfig. Este é o nome da configuração importada anteriormente.

  5. No painel de configuração TestConfig, clique em Compilar e depois clique em Sim. Isso inicia um trabalho de compilação.

    Screenshot of the TestConfig configuration page highlighting compile button

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, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.

  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.

  4. Na página State Configuration (DSC), clique na guia Configurações e depois em TestConfig. Este é o nome da configuração importada anteriormente.

  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.

    Screenshot of the Compilation Job page

  6. Clique em um bloco no painel de trabalho de compilação para ver mais detalhes sobre o trabalho.

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 é implantado no servidor de pull e está pronto para ser submetido ao pull e aplicado por um ou mais nós. É 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, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.

  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.

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

    Screenshot of the Compiled Configurations tab

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, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.

  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.

  4. Na página State Configuration (DSC), selecione a guia Nós e, em seguida, clique em + Adicionar.

    Screenshot of the DSC Nodes page highlighting the Add Azure VM button

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

  6. No painel de detalhes da máquina virtual, clique em + 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 Reinicialize o nó, se necessário e clique em OK.

    Screenshot of the Registration blade

    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 estiver concluída, a VM aparecerá na guia Nós da página State Configuration (DSC) na conta de Automação.

Exibir a lista de nós gerenciados

É possível exibir a lista de todos os computadores que foram habilitados para gerenciamento na conta de Automação na guia Nós da página do State Configuration (DSC).

  1. Entre no portal do Azure.
  2. À esquerda, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.
  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.
  4. Na página State Configuration (DSC),clique na 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ó.
  • Not compliant – Esse status é exibido quando ocorre um descompasso em um nó e exige uma revisão próxima caso seja sistemático.
  • Unresponsive – Esse status é exibido quando um nó não é verificado há mais de 24 horas.
  • Pending – 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, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.

  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.

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

    Screenshot of Node page

  5. Na guia Nós, clique no registro do nó para abrir o relatório. Clique no relatório que você quer exibir os detalhes de relatórios adicionais.

    Screenshot of the Report blade

Na folha de um relatório individual, 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:
    • Conformidade - O nó está em conformidade com a verificação.
    • Falha - A configuração não foi aprovada na verificação.
    • Não conformidade - 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 clicar em cada recurso para ver informações mais detalhadas sobre ele.
  • O nome, o endereço IP e o modo de configuração do nó.

Você também pode clicar em Exibir relatório bruto para ver os dados reais que o nó envia para o 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, clique em Todos os recursos e, em seguida, no nome de sua conta de Automação.

  3. Na página da conta da Automação, clique em State Configuration (DSC) em Configuração.

  4. Na página State Configuration (DSC),clique na guia Nós.

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

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

    Screenshot of the Node details page highlighting the Assign node configuration button

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

    Screenshot of the Assign Node Configuration page

Cancelar o registro de um nó

Se não quiser mais que um nó seja gerenciado pelo State Configuration, você poderá cancelar seu registro. Confira Como remover uma configuração e um nó do State Configuration da Automação.

Próximas etapas