Konfiguracja winGet

Za pomocą pliku konfiguracji WinGet można skonsolidować ręczną konfigurację maszyny i dołączanie projektu do jednego polecenia, które jest niezawodne i powtarzalne. Aby to osiągnąć, funkcja WinGet wykorzystuje następujące elementy:

• Plik konfiguracji WinGet w formacie YAML, który zawiera listę wszystkich wersji oprogramowania, pakietów, narzędzi, zależności i ustawień wymaganych do skonfigurowania żądanego stanu środowiska deweloperskiego na komputerze z systemem Windows.
• Konfiguracja żądanego stanu programu PowerShell (DSC) umożliwia automatyzację konfiguracji systemu operacyjnego Windows.
• Menedżer pakietów systemu Windows używa polecenia winget configure do zainicjowania procesu konfiguracji.

Korzyści z konfiguracji maszyny i wdrażania projektu

Zalety korzystania z pliku konfiguracji WinGet obejmują:

• Konfiguracja nienadzorowana: wprowadź polecenie winget configure i pozwól Menedżerowi pakietów Windows i PowerShell DSC zautomatyzować instalację oraz skonfigurować wszystkie wymagania potrzebne do uzyskania skonfigurowanego żądanego środowiska programistycznego na komputerze z systemem Windows.
• Niezawodne i powtarzalne: usuń obawy dotyczące znajdowania odpowiednich wersji oprogramowania, pakietów, narzędzi, struktur i konfigurowania poprawnych ustawień komputera dla środowiska deweloperskiego podczas dołączania do nowego zespołu lub projektu, ponieważ są one wstępnie zdefiniowane w pliku konfiguracji WinGet przy użyciu formatu YAML (ze schematem JSON).
• obsługuje współpracę typu open source: pliki konfiguracji WinGet mogą być hostowane w repozytorium GitHub, gdzie można zgłaszać problemy lub wkłady, albo przechowywane w bezpiecznym miejscu, takim jak OneDrive, i udostępniane za pośrednictwem prywatnej poczty e-mail lub innych zabezpieczonych kanałów.

Ostrzeżenie

Pliki konfiguracji WinGet i wszystkie skojarzone zasoby DSC programu PowerShell powinny być sprawdzane, aby upewnić się, że są godne zaufania przed ich zastosowaniem.

Konfigurowanie maszyny przy użyciu pliku konfiguracji WinGet

Aby skonfigurować maszynę przy użyciu pliku konfiguracji WinGet, pobierz plik konfiguracji i kliknij dwukrotnie, aby wywołać konfigurację. Alternatywnie należy użyć winget configure w linii poleceń. Aby użyć winget configure polecenia, musisz uruchomić winGet w wersji 1.6.2631 lub nowszej.

Często zadawane pytania dotyczące konfiguracji winGet

Znajdź odpowiedzi na niektóre z najczęściej zadawanych pytań dotyczących konfiguracji winGet.

Jak działają pliki konfiguracji WinGet?

Pliki konfiguracji WinGet są zapisywane w języku YAML i definiują, co jest zainstalowane na urządzeniu w celu utworzenia środowiska programistycznego, a także stanu konfiguracji maszyny i zainstalowanych aplikacji.

Zamiast sekwencji imperatywnej kroków, które należy wykonać, plik konfiguracji WinGet jest deklaratywny, definiując wynik żądanego stanu konfiguracji maszyny. Za pomocą Menedżera pakietów systemu Windows i zasobów DSC programu PowerShell deklaratywny plik konfiguracji WinGet może instalować, konfigurować i stosować ustawienia do środowiska, co powoduje stan gotowości do kodu.

Usługa WinGet przeanalizuje plik konfiguracji, aby upewnić się, że jest prawidłowy, a następnie pobierze wszystkie skojarzone moduły programu PowerShell (zawierające zasoby DSC) wymagane do osiągnięcia żądanego stanu. Po pobraniu tych zasobów i kiedy sprawdzisz wiarygodność pliku konfiguracji WinGet oraz po potwierdzeniu, że zweryfikowałeś bezpieczeństwo pliku, WinGet przystąpi do testowania wszystkich wymaganych asercji i stosowania żądanego stanu.

Sekwencja, w której uporządkowane są zasoby pliku konfiguracji WinGet, jest niekonsekwencyjne. Niektóre procesy instalacji i konfiguracji mogą być nawet uruchamiane równolegle. Te asercje bezpośrednio odpowiadają polu dependsOn zdefiniowanemu w każdym Resource. Jeśli zasób zawiera zależność od asercji, aseracja zostanie sprawdzona jako pierwsza. Jeśli asercja się nie powiedzie, zasób zależny również zakończy się niepowodzeniem. Jednak plik konfiguracji będzie nadal działać, wykonując jak najwięcej zadań, nawet jeśli niektóre asercje lub zależności zasobów okażą się nieudane, przesuwając proces konfiguracji maszyny tak daleko, jak to możliwe, zanim zakończone zostaną wszystkie możliwe działania. Po zakończeniu konfiguracji twoim zadaniem jest sprawdzenie ewentualnych błędów.

Na przykład po uruchomieniu pliku konfiguracji WinGet może zostać wyświetlony wynik podobny do następującego:

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.

W tym przykładzie sprawdzanie asercji dla wymaganej wersji systemu operacyjnego nie powiodło się, więc zasoby DeveloperMode i WinGetPackage zawierające zależność od tej asercji dla wersji systemu operacyjnego również nie powiodły się. Jednak wszystkie inne zadania instalacji i konfiguracji wymienione w pliku konfiguracji będą nadal kontynuowane.

Zaletą deklaratywnego (nie sekwencyjnego) charakteru plików konfiguracji WinGet jest to, że pozycja nowych zasobów dodawanych do pliku nie ma znaczenia. Jest to szczególnie przydatne w przypadku długich plików konfiguracji, ponieważ można po prostu dodać dodatkowe zasoby do dołu pliku. Tak długo, jak prawidłowo zdefiniowano asercje i zależności, nie musisz martwić się o kolejność ani o to, w jakiej kolejności wykonywane są poszczególne kroki.

Jak używać pliku konfiguracji WinGet?

Aby uruchomić plik konfiguracji WinGet, możesz po prostu kliknąć dwukrotnie, aby uruchomić plik w Eksploratorze plików. Alternatywnie możesz użyć winget configure polecenia .

Jak utworzyć konfigurację WinGet?

Aby utworzyć plik konfiguracji WinGet, postępuj zgodnie ze wskazówkami zawartymi w lekcji How to author a WinGet Configuration file (Jak utworzyć plik konfiguracji WinGet ).

Jak mogę zapewnić, że plik konfiguracji WinGet jest godny zaufania?

Zalecamy zawsze weryfikowanie integralności pliku konfiguracji WinGet przed jego uruchomieniem, przeglądając jego zawartość i testując konfigurację w środowisku izolowanym. Zobacz Jak sprawdzić wiarygodność pliku konfiguracji WinGet.

Gdzie można znaleźć przykładowe pliki konfiguracji WinGet?

Przykładowe pliki konfiguracji WinGet można znaleźć w repozytorium DSC WinGet: https://aka.ms/dsc.yaml.

Gdzie można znaleźć przykłady modułów programu PowerShell zawierających zasoby DSC?

Galeria programu PowerShell hostuje setki modułów programu PowerShell zawierających zasoby usługi Desired State Configuration (DSC). Wyniki wyszukiwania można filtrować, stosując filtr "Zasób DSC" w obszarze "Kategorie".

wyniki wyszukiwania modułu

Czy mogę skonfigurować zasady blokujące używanie plików konfiguracji WinGet w mojej organizacji?

Tak. Obiekty zasad grupyEnableWindowsPackageManagerConfiguration i EnableWindowsPackageManagerConfigurationExplanation można użyć do wyłączania funkcji konfiguracji WinGet w organizacji.

Rozwiązywanie problemów z konfiguracjami WinGet

Najczęstszą przyczyną niepowodzenia konfiguracji WinGet jest zasób DSC programu PowerShell wymagający dostępu administracyjnego w celu zastosowania żądanego stanu. Nie wszystkie zasoby DSC mają jawne przyczyny niepowodzenia.

Wkrótce zostaną dodane kolejne typowe problemy. W międzyczasie sprawdź powiązane problemy złożone w repozytorium WinGet CLI w witrynie GitHub.