Configuração do WinGet

Usando um arquivo de configuração do WinGet, você pode consolidar a configuração manual da máquina e a integração do projeto em um único comando confiável e repetível. Para conseguir isso, WinGet utiliza:

• Um arquivo de configuração do WinGet formatado em YAML que lista todas as versões de software, pacotes, ferramentas, dependências e configurações necessárias para configurar o estado desejado do ambiente de desenvolvimento em sua máquina Windows.
• Configuração de Estado Desejado (DSC) do PowerShell para automatizar a configuração do seu sistema operativo Windows.
• O comando winget configure do Windows Package Manager inicia o processo de configuração.

Benefícios para a configuração da máquina e integração do projeto

Os benefícios de usar um arquivo de configuração do WinGet incluem:

• Configuração autônoma: insira o comando e permita que o winget configure Gerenciador de Pacotes do Windows e o PowerShell DSC automatizem a instalação e a configuração de todos os requisitos necessários para configurar o ambiente de desenvolvimento desejado em sua máquina Windows.
• Confiável e repetível: Remova a preocupação em encontrar as versões certas de software, pacotes, ferramentas, estruturas e definir as configurações corretas da máquina para seu ambiente de desenvolvimento ao integrar a uma nova equipe ou projeto, pois elas são predefinidas no arquivo de configuração do WinGet usando um formato YAML (com um esquema JSON).
• Suporta colaboração Open Source: os arquivos de configuração do WinGet podem ser hospedados em um repositório GitHub onde problemas ou contribuições podem ser arquivados ou podem ser mantidos privados em um local de armazenamento seguro (como o OneDrive) e compartilhados via e-mail privado ou outros canais seguros.

Advertência

Os arquivos de configuração do WinGet e quaisquer recursos DSC do PowerShell associados devem ser verificados para garantir que sejam confiáveis antes de aplicá-los.

Use um arquivo de configuração do WinGet para configurar sua máquina

Para configurar sua máquina usando um arquivo de configuração do WinGet, baixe o arquivo de configuração e clique duas vezes para invocar a configuração. Como alternativa, use winget configure na linha de comando. Para usar o comando, você deve estar executando WinGet winget configure versão v1.6.2631 ou posterior.

Perguntas frequentes sobre configuração do WinGet

Encontre respostas para algumas das perguntas mais frequentes sobre a Configuração do WinGet.

Como funcionam os arquivos de configuração do WinGet?

Os arquivos de configuração do WinGet são escritos em YAML e definem o que está instalado no dispositivo para compor seu ambiente de desenvolvimento, bem como o estado de configuração para sua máquina e aplicativos instalados.

Em vez de uma sequência imperativa de etapas a serem seguidas, um arquivo de configuração do WinGet é declarativo, definindo o resultado desejado do estado de configuração da máquina. Usando o Gerenciador de Pacotes do Windows e os Recursos DSC do PowerShell, o arquivo declarativo de Configuração do WinGet pode instalar, configurar e aplicar configurações ao seu ambiente, resultando em um estado pronto para codificar.

O WinGet analisará o arquivo de configuração para garantir que ele seja válido e, em seguida, baixará todos os módulos do PowerShell associados (contendo os recursos DSC) necessários para atingir o estado desejado. Uma vez que esses recursos tenham sido baixados e você tenha verificado a confiabilidade do arquivo de configuração do WinGet, concordando que você verificou a segurança do arquivo, o WinGet começará a testar todas as asserções necessárias e aplicar o estado desejado.

A sequência na qual os recursos do arquivo de configuração do WinGet são ordenados é inconsequente. Alguns processos de instalação e configuração podem até ser executados em paralelo. As asserções correspondem diretamente ao campo dependsOn definido em cada Recurso. Se o recurso incluir uma dependência de uma asserção, a asserção será verificada primeiro. Se a asserção falhar, o recurso dependente também falhará. No entanto, o arquivo de configuração continuará a ser executado, realizando o maior número possível de tarefas, mesmo que algumas das asserções ou dependências de recursos falhem, levando sua máquina o mais longe possível no processo de configuração antes de concluir. Uma vez concluída a configuração, é sua responsabilidade verificar se há falhas.

Por exemplo, depois de executar o arquivo de configuração do WinGet, você pode ver um resultado como:

Assert:: OsVersion
The configuration unit could not be found.
Apply :: DeveloperMode
  This configuration unity was not run because an assert failed or was false.
Apply :: WinGetPackage [vsPackage]
  This configuration unity was not run because an assert failed or was false.

Neste exemplo, a verificação de asserção para a versão necessária do sistema operacional falhou, portanto, os recursos DeveloperMode e WinGetPackage que incluíam uma dependência dessa asserção para a versão do sistema operacional também falharam. No entanto, quaisquer outras tarefas de instalação e configuração listadas no arquivo de configuração continuariam a avançar.

Um benefício para a natureza declarativa (não sequencial) dos arquivos de configuração do WinGet é que a posição dos novos recursos que estão sendo adicionados ao arquivo não importa. Isso é especialmente útil para arquivos de configuração longos, pois você pode apenas adicionar recursos adicionais à parte inferior do arquivo. Desde que você tenha definido corretamente as asserções e dependências, você não precisa se preocupar com a sequência, ou quais etapas de configuração ocorrem primeiro, segundo, etc.

Como faço para usar um arquivo de configuração do WinGet?

Para executar um arquivo de configuração do WinGet, você pode simplesmente clicar duas vezes para executar o arquivo no explorador de arquivos. Como alternativa, você pode usar o winget configure comando.

Como faço para criar uma configuração do WinGet?

Para criar um arquivo de configuração do WinGet, siga as orientações no documento Como criar um arquivo de configuração do WinGet .

Como posso garantir que um arquivo de configuração do WinGet é confiável?

Recomendamos SEMPRE validar a integridade de um arquivo de configuração do WinGet antes de executá-lo, revisando seu conteúdo e testando a configuração em um ambiente isolado. Consulte Como verificar a confiabilidade de um arquivo de configuração do WinGet.

Onde posso encontrar arquivos de configuração WinGet de exemplo?

Você pode encontrar exemplos de arquivos de configuração do WinGet no repositório WinGet DSC: https://aka.ms/dsc.yaml.

Onde posso encontrar exemplos de módulos do PowerShell que contêm recursos DSC?

A Galeria do PowerShell hospeda centenas de módulos do PowerShell que contêm recursos de configuração de estado desejado (DSC). Você pode filtrar os resultados da pesquisa aplicando o filtro "Recurso DSC" em "Categorias".

Posso configurar uma política para bloquear o uso de arquivos de configuração do WinGet em minha organização?

Sim. Objetos de Política de GrupoEnableWindowsPackageManagerConfiguration e EnableWindowsPackageManagerConfigurationExplanation podem ser utilizados para desabilitar o recurso Configuração do WinGet em sua organização.

Solução de problemas de configurações do WinGet

O motivo mais comum para uma configuração do WinGet falhar é devido a um recurso DSC do PowerShell que requer acesso administrativo para aplicar o estado desejado. Nem todos os recursos do DSC apresentam razões explícitas para a falha.

Questões de resolução de problemas mais comuns serão adicionadas em breve. Enquanto isso, verifique os problemas relacionados arquivados no repositório WinGet CLI no GitHub.