Partilhar via


Introdução à Configuração do Estado de Automação do Azure

Nota

Antes de habilitar a Configuração do Estado de Automação, gostaríamos que você soubesse que uma versão mais recente do DSC agora está disponível ao público, gerenciada por um recurso da Política do Azure chamado configuração de convidado. O serviço de configuração de convidado combina recursos de Extensão DSC, Configuração de Estado de Automação do Azure e os recursos mais comumente solicitados dos comentários dos clientes. A configuração de convidado também inclui suporte a máquinas híbridas por meio de servidores habilitados para Arc.

Este artigo fornece um guia passo a passo para executar as tarefas mais comuns com a Configuração do Estado de Automação do Azure, como criar, importar e compilar configurações, permitir que as máquinas gerenciem e exibir relatórios. Para obter uma visão geral da Configuração de Estado, consulte Visão geral da Configuração de Estado. Para obter a documentação da Configuração de Estado Desejado (DSC), consulte Visão geral da Configuração de Estado Desejado do Windows PowerShell.

Se desejar um ambiente de exemplo que já esteja configurado sem seguir as etapas descritas neste artigo, você pode usar o modelo de Nó Gerenciado de Automação do Azure. Este modelo configura um ambiente completo de Configuração de Estado (DSC), incluindo uma VM do Azure que é gerenciada pela Configuração de Estado (DSC).

Pré-requisitos

Para completar os exemplos neste artigo, é necessário o seguinte:

Criar uma configuração DSC

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

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. Este recurso garante a presença ou ausência do recurso Web-Server .

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

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

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, selecione Configuração de estado (DSC) em Gerenciamento de configuração.

  4. Na página Configuração de estado (DSC), clique na guia Configurações e, em seguida, clique em Adicionar.

  5. No painel Importar configuração, navegue até o TestConfig.ps1 arquivo no 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 exibi-la no portal do Azure.

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, selecione Configuração de estado (DSC) em Gerenciamento de configuração.

  4. Na página Configuração de estado (DSC), clique na guia Configurações e, em seguida, clique em TestConfig. Este é o nome da configuração importada no procedimento anterior.

  5. No painel Configuração do TestConfig, clique em Exibir fonte de configuração.

    Screenshot of the TestConfig configuration blade

    Um painel de origem TestConfig Configuration é aberto, exibindo 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 Automation DSC Pull Server. Para obter uma descrição mais detalhada da compilação de configurações na Configuração de Estado (DSC), consulte Compilar configurações na Configuração de Estado de Automação do Azure. Para obter mais informações sobre como compilar configurações, consulte Configurações DSC.

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.

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

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

    Screenshot of the TestConfig configuration page highlighting compile button

Nota

Quando você compila uma configuração na Automação do Azure, ela implanta automaticamente qualquer arquivo MOF de configuração de nó criado no servidor de recebimento.

Exibir um trabalho de compilação

Depois de iniciar uma compilação, você pode 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 tarefas de compilação, ele 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. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.

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

  5. Em Trabalhos de compilação, selecione o trabalho de compilação a ser exibido. Um painel Trabalho de compilação é aberto, rotulado com a data em que o trabalho de compilação foi iniciado.

    Screenshot of the Compilation Job page

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

Ver configurações de nó

A conclusão bem-sucedida 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 pull e pronto para ser puxado e aplicado por um ou mais nós. Você pode exibir as configurações de nó em sua conta de automação na página Configuração de estado (DSC). Uma configuração de nó tem um nome com o formulário ConfigurationName.NodeName.

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.

  4. Na página Configuração de estado (DSC), clique na guia Configurações compiladas .

    Screenshot of the Compiled Configurations tab

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

Você pode usar a Configuração de Estado para gerenciar VMs do Azure (clássicas e do Gerenciador de Recursos), VMs locais, máquinas Linux, VMs da AWS e máquinas físicas locais. Neste artigo, você aprenderá a habilitar apenas VMs do Azure Resource Manager. Para obter informações sobre como habilitar outros tipos de máquinas, consulte Habilitar máquinas para gerenciamento pela Configuração do Estado de Automação do Azure.

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.

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

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

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

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

    Importante

    A VM deve ser uma VM do Azure Resource Manager executando um sistema operacional com suporte.

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

  8. Verifique Reboot Node se necessário e, em seguida, 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 na configuração do 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 habilitação da VM. Quando estiver concluída, a VM aparecerá na guia Nós da página Configuração de estado (DSC) na conta de automação.

Exibir a lista de nós gerenciados

Você pode exibir a lista de todas as máquinas que foram habilitadas para gerenciamento em sua conta de automação na guia Nós da página Configuração de estado (DSC).

  1. Inicie sessão no portal do Azure.
  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.
  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.
  4. Na página Configuração de estado (DSC), clique na guia Nós .

Valores de status dos nós DSC

O nó DSC pode ter qualquer um dos seguintes seis valores da seguinte maneira:

  • Falha - Este status é exibido quando ocorre um erro ao aplicar uma ou mais configurações em um nó.
  • Não compatível - Este status é exibido quando ocorre desvio em um nó e requer uma revisão minuciosa se for sistemático.
  • Sem resposta - Este status é exibido quando não foi feito check-in de um nó por mais de 24 horas.
  • Pendente - Esse status é exibido quando um nó tem uma nova configuração a ser aplicada e o servidor pull está aguardando o check-in do nó.
  • Em andamento - Esse status é exibido quando um nó aplica a configuração e o servidor pull está aguardando status.
  • Compatível - Este status é exibido quando um nó tem uma configuração válida e nenhum desvio ocorre no momento.

Nota

  • RefreshFrequencyMins - Define a frequência do nó entrar em contato com o serviço do agente e pode ser fornecido como parte da integração ao DSC. Demora um valor máximo de 10080 minutos.
  • O nó será marcado como Sem resposta se o nó 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ó seria exibido em um falso estado Sem resposta.

Exibir relatórios para nós gerenciados

Cada vez que a Configuração de Estado 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 recebimento. Você pode exibir esses relatórios na página desse nó.

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.

  4. Na página Configuração de estado (DSC), clique na guia Nós . Aqui, você pode ver a visão geral do estado de 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ê deseja exibir detalhes adicionais do relatório.

    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:
    • Compatível - o nó é compatível com a verificação.
    • Falha - a configuração falhou na verificação.
    • Não compatível - o nó está no modo e a máquina não está no ApplyandMonitor estado desejado.
  • A hora de início da 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 DSC usados na configuração e o estado de cada recurso (se o nó está no estado desejado para esse recurso). Você pode clicar em cada recurso para obter informações mais detalhadas sobre esse recurso.
  • 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 ao servidor. Para obter mais informações sobre como usar esses dados, consulte Usando um servidor de relatório DSC.

Pode levar algum tempo depois que um nó é habilitado antes que o primeiro relatório esteja disponível. Talvez seja necessário aguardar até 30 minutos pelo primeiro relatório depois de 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 você atribuiu inicialmente.

  1. Inicie sessão no portal do Azure.

  2. À esquerda, clique em Todos os recursos e, em seguida, no nome da sua conta de automação.

  3. Na página Conta de automação, clique em Configuração de estado (DSC) em Gerenciamento de configuração.

  4. Na página Configuração de estado (DSC), clique na guia Nós .

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

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

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

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

    Screenshot of the Assign Node Configuration page

Cancelar o registro de um nó

Se você não quiser mais que um nó seja gerenciado pela Configuração de Estado, poderá cancelá-lo. Consulte Como remover uma configuração e um nó da Configuração do Estado de Automação.

Próximos passos

  • Para obter uma visão geral, consulte Visão geral da Configuração do Estado de Automação do Azure.
  • Para habilitar o recurso para VMs em seu ambiente, consulte Habilitar a configuração do estado de automação do Azure.
  • Para entender o DSC do PowerShell, consulte Visão geral da Configuração de Estado Desejado do Windows PowerShell.
  • Para obter informações sobre preços, consulte Preços da Configuração do Estado de Automação do Azure.
  • Para obter uma referência de cmdlet do PowerShell, consulte Az.Automation.