Partilhar via

Visão geral da Configuração de Estado Desejado da Microsoft

A Configuração de Estado Desejado (DSC) da Microsoft é uma plataforma de configuração declarativa. Com o DSC, o estado de uma máquina é 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 o 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 declarativa e idempotente. O DSC é executado em Linux, macOS e Windows sem dependências externas.

Com o DSC, você pode:

  • Crie Recursos DSC para gerenciar seus sistemas em qualquer idioma.
  • Invoque 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 DSC são arquivos de dados declarativos que definem instâncias de recursos. Normalmente, os documentos de configuração definem qual estado deve ser imposto. O DSC suporta a escrita de documentos de configuração em JSON e YAML.

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

Recursos DSC

Os Recursos DSC definem como gerenciar o estado de um determinado sistema ou componente de 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 ela está no estado desejado. A maioria dos recursos também suporta a imposição do estado desejado com a operação set.

Os 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

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

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

    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 apenas para Windows.

  • Como o DSC não depende do PowerShell, você pode usar o 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. DSC é invocado como um comando. Ele não é executado como um serviço.

  • Novos recursos DSC definem seus esquemas com arquivos JSON ou YAML, não arquivos MOF. Recursos autônomos definem um manifesto de recurso que indica como o 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 invocar os 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 suportam um subconjunto de funcionalidades em modelos 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 repositório PowerShell/DSC.
  2. Expanda o arquivo de versão.
  3. Adicione a pasta que contém o conteúdo do arquivo expandido ao PATH.

Instale 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:

Procure 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

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

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

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

Ver também

  • Last updated on