Introdução ao manipulador de extensão de Configuração de Estado Desejado do Azure

A Extensão de VM do Azure para máquinas virtuais (VM) do Azure e as extensões associadas fazem parte dos serviços de infraestrutura do Microsoft Azure. As extensões de VM do Azure são componentes de software que estendem a funcionalidade da VM e simplificam várias operações de gerenciamento de VM.

A extensão DSC apenas envia uma configuração para a VM. Nenhum relatório contínuo está disponível, exceto localmente na VM.

Versões DSC disponíveis

A extensão DSC suporta configurações da versão 1.1 da plataforma DSC. Para obter mais informações, consulte PSDesiredStateConfiguration v1.1.

Prerequisites

• Estação de trabalho do desenvolvedor: para interagir com a extensão DSC do Azure, você deve usar o portal do Azure ou o SDK do Azure PowerShell/CLI.

• Agente convidado: a VM do Azure preparada pela configuração DSC deve usar um sistema operacional que ofereça suporte ao Windows Management Framework (WMF) 4.0 ou posterior. Para obter a lista completa de versões do sistema operacional com suporte, consulte o histórico de versões da extensão DSC do Azure.

Termos e conceitos

Este artigo pressupõe familiaridade com os seguintes conceitos:

• Configuração refere-se a um documento de configuração DSC.

• O nó identifica um destino para uma configuração DSC. Neste artigo, o nó sempre se refere a uma VM do Azure.

• Os dados de configuração são armazenados em um arquivo de formato DSC do PowerShell (.psd1) que possui dados ambientais para uma configuração.

Architecture

A extensão DSC do Azure usa a estrutura de Extensão de VM do Azure para entregar, promulgar e relatar configurações de DSC em execução em VMs do Azure. A extensão DSC aceita um documento de configuração e um conjunto de parâmetros.

Quando a extensão é implantada pela primeira vez, ela instala uma versão do WMF usando a seguinte lógica:

• Se o sistema operacional da VM do Azure for o Windows Server 2016, nenhuma ação será executada. O Windows Server 2016 já tem a versão mais recente do PowerShell instalada.

• Se a wmfVersion propriedade for especificada, a versão especificada do WMF será instalada, a menos que a versão especificada seja incompatível com o sistema operacional na VM.

• Se nenhuma wmfVersion propriedade for especificada, a versão aplicável mais recente do WMF será instalada.

O processo de instalação do WMF requer uma reinicialização. Depois de reiniciar, a extensão automatiza o .zip download do arquivo especificado na modulesUrl propriedade, se fornecido. Se esse local estiver no Armazenamento de Blobs do Azure, você poderá especificar um token SAS na sasToken propriedade para acessar o arquivo. Em seguida, a função de configuração definida em configurationFunction é executada para gerar um arquivo MOF (Managed Object Format) (.mof). Em seguida, a extensão executa o Start-DscConfiguration -Force comando usando o arquivo .mof gerado. A extensão captura a saída e a grava no canal de status do Azure.

Nome da configuração do nó

Para o NodeConfigurationName parâmetro, certifique-se de fornecer o nome da configuração do nó e não a Configuração.

A configuração é definida em um script que é usado para compilar a configuração do nó (arquivo MOF). O nome da configuração do nó é sempre o nome da Configuração seguido por um ponto . e um ou um localhost nome de computador específico.

Implantação de modelo ARM

A abordagem mais comum para implantar a extensão DSC é usar modelos do Azure Resource Manager. Para obter mais informações e exemplos de como incluir a extensão DSC em modelos ARM, consulte Extensão de configuração de estado desejado com modelos ARM.

Implantação de cmdlet do PowerShell

Os cmdlets do PowerShell para gerenciar a extensão DSC são ideais para solução de problemas interativa e cenários de coleta de informações. Você pode usar os cmdlets para empacotar, publicar e monitorar implantações de extensão DSC.

Aqui estão alguns dos cmdlets do PowerShell disponíveis:

• O cmdlet Publish-AzVMDscConfiguration recebe um arquivo de configuração, verifica-o em busca de recursos DSC dependentes e cria um .zip arquivo. O .zip arquivo contém a configuração e os recursos DSC necessários para executar a configuração. O cmdlet também pode criar o pacote localmente usando o -OutputArchivePath parâmetro. Caso contrário, o cmdlet publicará o .zip arquivo no Armazenamento de Blob e, em seguida, o protegerá com um token SAS.

  O script de configuração do PowerShell (.ps1) criado pelo cmdlet está no .zip arquivo na raiz da pasta de arquivamento. A pasta do módulo é colocada na pasta de arquivo em recursos.

• O cmdlet Set-AzVMDscExtension injeta as configurações que a extensão DSC do PowerShell requer em um objeto de configuração de VM.

• O cmdlet Get-AzVMDscExtension recupera o status da extensão DSC de uma VM específica.

• O cmdlet Get-AzVMDscExtensionStatus recupera o status da configuração DSC que é executada pelo manipulador de extensão DSC. Essa ação pode ser executada em uma única VM ou em um grupo de VMs.

• O cmdlet Remove-AzVMDscExtension remove o manipulador de extensão de uma VM específica. Lembre-se de que esse cmdlet não remove a configuração, não desinstala o WMF nem altera as configurações aplicadas na VM. O cmdlet remove apenas o manipulador de extensão.

Considerações importantes

Há várias considerações a ter em mente ao trabalhar com cmdlets do Azure Resource Manager.

• Os cmdlets do Azure Resource Manager são síncronos.

• Vários parâmetros são necessários, incluindo ResourceGroupName, VMName, ArchiveStorageAccountName, Versione Location.

• ArchiveResourceGroupName é um parâmetro opcional. Especifique esse parâmetro quando sua conta de armazenamento pertencer a um grupo de recursos diferente daquele em que a VM foi criada.

• Use o AutoUpdate switch para atualizar automaticamente o manipulador de extensão para a versão mais recente quando estiver disponível. Esse parâmetro tem o potencial de causar reinicializações na VM quando uma nova versão do WMF é lançada.

Configuração com cmdlets do PowerShell

A extensão DSC do Azure pode usar documentos de configuração DSC para configurar diretamente as VMs do Azure durante a implantação. Esta etapa não registra o nó para Automação ou Configuração da Máquina. Lembre-se de que o nó não é gerenciado centralmente.

O código a seguir mostra um exemplo simples de configuração. Para trabalhar com este exemplo, salve essa configuração localmente como o arquivo de scriptiisInstall.ps1 .

configuration IISInstall
{
    node "localhost"
    {
        WindowsFeature IIS
        {
            Ensure = "Present"
            Name = "Web-Server"
        }
    }
}

Os comandos do PowerShell a seguir colocam o iisInstall.ps1 script na VM especificada. Os comandos também executam a configuração e, em seguida, relatam o status.

$resourceGroup = 'dscVmDemo'
$vmName = 'myVM'
$storageName = 'demostorage'
#Publish the configuration script to user storage
Publish-AzVMDscConfiguration -ConfigurationPath .\iisInstall.ps1 -ResourceGroupName $resourceGroup -StorageAccountName $storageName -force
#Set the VM to run the DSC configuration
Set-AzVMDscExtension -Version '2.76' -ResourceGroupName $resourceGroup -VMName $vmName -ArchiveStorageAccountName $storageName -ArchiveBlobName 'iisInstall.ps1.zip' -AutoUpdate -ConfigurationName 'IISInstall'

Implantação da CLI do Azure

A CLI do Azure pode ser usada para implantar a extensão DSC em uma VM existente. Os exemplos a seguir mostram como implantar uma VM no Windows.

Para uma VM que executa o Windows, use o seguinte comando:

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name DSC \
  --publisher Microsoft.Powershell \
  --version 2.77 --protected-settings '{}' \
  --settings '{}'

Implantação do portal do Azure

Para configurar a extensão DSC no portal do Azure, siga estes passos:

1. Vá para uma VM.

2. Em Configurações, selecione Extensões + Aplicativos.

3. Em Extensões, selecione + Adicionar.

4. Selecione Configuração de Estado Desejado do PowerShell e, em seguida, selecione Avançar.

5. Configure os seguintes parâmetros para a extensão DSC.

   • Módulos de configuração ou script: (Obrigatório) Forneça os módulos de configuração ou o arquivo de script para sua VM.

     Os módulos e scripts de configuração requerem um .ps1 arquivo que tenha um script de configuração ou um .zip arquivo com um script de .ps1 configuração na raiz. Se você usar um .zip arquivo, todos os recursos dependentes deverão ser incluídos nas pastas do .zip módulo no arquivo. Você pode criar o .zip arquivo usando o cmdletPublish-AzureVMDscConfiguration -OutputArchivePath incluído no SDK do Azure PowerShell. O .zip arquivo é carregado para o seu usuário Blob Storage e protegido por um token SAS.

   • Nome de configuração qualificado pelo módulo: (Obrigatório) Especifique essa configuração para incluir várias funções de configuração em um único .ps1 arquivo de script. Para essa configuração, digite o nome do arquivo de script de configuração .ps1 seguido por uma barra \ e, em seguida, o nome da função de configuração. Por exemplo, se o .ps1 arquivo de script tiver o nome configuration.ps1 e o nome da configuração for IisInstall, insira o valor configuration.ps1\IisInstall para a configuração.

   • Argumentos de configuração: Se a função de configuração usa argumentos, insira os valores usando o formato argumentName1=value1,argumentName2=value2. Observe que esse formato difere do formato usado para especificar argumentos de configuração em cmdlets do PowerShell ou modelos ARM.

   • Arquivo PSD1 de dados de configuração: se sua configuração exigir um arquivo de dados de configuração no .psd1 formato, use essa configuração para selecionar o arquivo de dados e carregá-lo para o armazenamento de Blob do usuário. O arquivo de dados de configuração é protegido com um token SAS no Armazenamento de Blobs.

   • Versão WMF: especifique a versão do Windows Management Framework a ser instalada em sua VM. Se você escolher mais recente, que é o valor padrão, o sistema instalará a versão mais recente do WMF. Outros valores possíveis incluem 4,0, 5,0 e 5,1. Os valores possíveis estão sujeitos a atualizações.

   • Coleta de dados: habilite essa configuração se quiser que a extensão DSC colete telemetria sobre sua VM. Para obter mais informações, consulte Coleta de dados de extensão DSC do Azure.

   • Versão: (Obrigatório) Especifique a versão da extensão DSC a ser instalada. Para obter informações sobre versões, consulte Histórico de versões da extensão DSC do Azure.

   • Versão secundária de atualização automática: essa configuração é mapeada para o AutoUpdate switch nos cmdlets. Defina essa configuração para permitir que a extensão DSC seja atualizada automaticamente para a versão mais recente durante a instalação. Sim instrui o manipulador de extensão DSC a usar a versão mais recente disponível. Nenhum (padrão) força a instalação da versão especificada na configuração Versão .

6. Depois de configurar os parâmetros, selecione Rever + Criar e, em seguida, selecione Criar.

Logs de extensão DSC

Você pode exibir logs para a extensão DSC do Azure na VM em C:\WindowsAzure\Logs\Plugins\Microsoft.Powershell.DSC\<version number>.

Próximos passos

• Para obter mais informações sobre o PowerShell DSC, vá para o centro de documentação do PowerShell.
• Examine o modelo ARM para a extensão DSC do Azure.
• Para obter mais funcionalidades que você pode gerenciar usando o DSC do PowerShell e para obter mais recursos do DSC, navegue pela galeria do PowerShell.
• Para obter detalhes sobre como passar parâmetros confidenciais para configurações, consulte Gerenciar credenciais com segurança com o manipulador de extensão DSC do Azure.