Compartilhar via

Visão geral do Microsoft Desired State Configuration

A DSC (Configuração de Estado Desejado) da Microsoft é uma plataforma de configuração declarativa. Com o DSC, o estado de um computador é descrito usando um formato que deve ser claro para entender, mesmo que o leitor não seja um especialista no assunto. Ao contrário das ferramentas imperativas, com a DSC a definição de um ambiente de aplicativo é separada da lógica de programação que impõe essa definição.

O aplicativo de linha de comando DSC (dsc) abstrai o gerenciamento de componentes de software de forma declarativa e idempotente. A DSC é executada no Linux, macOS e Windows sem dependências externas.

Com o DSC, você pode:

  • Crie recursos DSC para gerenciar seus sistemas em qualquer idioma.
  • Invocar recursos individuais diretamente.
  • Crie documentos de configuração que definem o estado desejado de um sistema.

Documentos de configuração

Os Documentos de Configuração de DSC são arquivos de dados declarativos que definem instâncias de recursos. Normalmente, os documentos de configuração definem qual estado aplicar. A DSC dá suporte à gravação de documentos de configuração em JSON e YAML.

Os cenários de exemplo incluem requisitos para um ambiente de aplicativo ou padrões operacionais/de segurança.

Recursos DSC

Os recursos de DSC definem como gerenciar o estado de um determinado componente do sistema ou do aplicativo. Os recursos descrevem um esquema para as configurações gerenciáveis do componente. Cada recurso pode ser usado com as operações Get e Test para recuperar o estado atual de uma instância de recurso e validar se ele está no estado desejado. A maioria dos recursos também dá suporte à imposição do estado desejado com a operação Definir.

Alguns cenários de exemplo incluem:

  • Como atualizar o conteúdo de um arquivo.
  • Como executar um utilitário que altera o estado de uma máquina.
  • Como definir as configurações de um aplicativo.

Diferenças do DSC do PowerShell

A DSC difere da PSDSC (Configuração de Estado Desejado) do PowerShell de algumas maneiras importantes:

  • A DSC não depende do PowerShell, do Windows PowerShell ou do módulo PSDesiredStateConfiguration do PowerShell. O DSC fornece compatibilidade total com recursos PSDSC por meio dos recursos do Microsoft.DSC/PowerShelladaptador e Microsoft.Windows/WindowsPowerShell .

    Com o recurso do Microsoft.DSC/PowerShell adaptador, você pode usar qualquer recurso PSDSC implementado como uma classe do PowerShell. O recurso lida com a descoberta, validação e invocação de recursos PSDSC no PowerShell. O recurso está incluído no pacote de instalação do DSC para cada plataforma.

    Com o recurso do adaptador, você pode usar qualquer recurso PSDSC compatível com o Microsoft.Windows/WindowsPowerShell Windows PowerShell. O recurso lida com a descoberta, validação e invocação de recursos PSDSC no Windows PowerShell. O recurso está incluído nos pacotes de instalação do DSC somente para Windows.

  • Como a DSC não depende do PowerShell, você pode usar a DSC sem o PowerShell instalado e gerenciar recursos escritos em bash, Python, C#, Rust ou qualquer outra linguagem.

  • O DSC não inclui um gerenciador de configuração local. O DSC é invocado como um comando. Ele não é executado como um serviço.

  • Novos recursos de DSC definem seus esquemas com arquivos JSON ou YAML, não arquivos MOF. Os recursos independentes definem um manifesto de recurso que indica como a DSC deve invocar o recurso e quais propriedades o recurso pode gerenciar. Para recursos adaptados, como aqueles implementados no PowerShell, o recurso do adaptador informa ao DSC quais são as propriedades disponíveis para o recurso e manipula a invocação dos recursos adaptados.

  • Os documentos de configuração são definidos em arquivos JSON ou YAML, não em arquivos de script do PowerShell. Os documentos de configuração dão suporte a um subconjunto de funcionalidades em modelos do ARM, incluindo parâmetros, variáveis, metadados e funções de expressão para resolver dinamicamente os dados na configuração.

Instalação

Instalar o DSC manualmente

Para instalar o DSC em qualquer plataforma:

  1. Baixe a versão mais recente do do repositório do PowerShell/DSC.
  2. Expanda o arquivo de lançamento.
  3. Adicione a pasta que contém o conteúdo de arquivo morto expandido ao PATH.

Instalar o DSC no Windows com o WinGet

Os seguintes comandos podem ser usados para instalar o DSC usando os pacotes publicados winget da Microsoft Store:

Pesquise a versão mais recente do DSC:

winget search DesiredStateConfiguration --source msstore

Name                              Id           Version Source
---------------------------------------------------------------
DesiredStateConfiguration         9NVTPZWRC6KQ Unknown msstore
DesiredStateConfiguration-Preview 9PCX3HX4HZ0Z Unknown msstore

Instale o DSC usando o id parâmetro:

# Install latest stable
winget install --id 9NVTPZWRC6KQ --source msstore

# Install latest preview
winget install --id 9PCX3HX4HZ0Z --source msstore

Integração com DSC

A DSC é uma ferramenta de plataforma que abstrai as preocupações para definir e invocar recursos. Ferramentas de ordem superior, como WinGet, Microsoft Dev Box e Azure Machine Configuration , são os primeiros parceiros da DSC como agentes de orquestração.

A DSC usa esquemas JSON para definir a estrutura de recursos, documentos de configuração e as saídas que a DSC retorna. Esses esquemas facilitam a integração do DSC com outras ferramentas, pois padronizam e documentam como fazer interface com o DSC.

Para obter mais informações, consulte Visão geral de referência do esquema JSON DSC.

Consulte Também