Tworzenie zadań dla dostosowań zespołu usługi Dev Box
Podczas tworzenia zadań dla dostosowań zespołu usługi Microsoft Dev Box można zdefiniować konkretne akcje dla pól deweloperskich, aby zapewnić spójne i wydajne środowisko programistyczne. Tworzenie nowych zadań w katalogu umożliwia definiowanie składników wielokrotnego użytku dostosowanych do zespołów programistycznych i dodawanie barier zabezpieczających wokół możliwych konfiguracji. Ten artykuł przeprowadzi Cię przez proces tworzenia wykazu pod kątem zadań dostosowywania, dodawania zadań i dołączania katalogu do centrum deweloperskiego lub projektu.
Ważne
Funkcja dostosowywania zespołu usługi Dev Box jest obecnie dostępna w wersji zapoznawczej. Aby uzyskać więcej informacji na temat stanu wersji zapoznawczej, zobacz Dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure. Dokument definiuje postanowienia prawne, które dotyczą funkcji platformy Azure, które są w wersji beta, w wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane do ogólnej dostępności.
Wymagania wstępne
Aby wykonać kroki opisane w tym artykule, musisz mieć następujące elementy:
- Centrum deweloperskie skonfigurowane przy użyciu projektu dev box.
- Istniejący wykaz w usłudze GitHub lub Azure Repos.
Uprawnienia wymagane do konfigurowania dostosowań
Aby wykonać wymagane akcje tworzenia i stosowania dostosowań w polu deweloperskim, potrzebne są następujące uprawnienia:
| Akcja | Uprawnienie/rola |
|---|---|
| Włącz katalogi na poziomie projektu dla centrum deweloperów. | Inżynier platformy z dostępem do zapisu w subskrypcji. |
| Włącz ustawienia synchronizacji katalogu dla projektu. | Inżynier platformy z dostępem do zapisu w subskrypcji. |
| Dołączanie wykazu do projektu. | Uprawnienia administratora lub współautora projektu. |
| Utwórz plik dostosowywania. | Nie określono żadnego. Każdy może utworzyć plik dostosowywania. |
| Użyj portalu dla deweloperów, aby przekazać i zastosować plik YAML podczas tworzenia pola deweloperskiego. | Użytkownik usługi Dev Box. |
| Dodawanie zadań do wykazu. | Uprawnienie do dodawania do repozytorium hostujące wykaz. |
Co to są zadania?
Zadanie wykonuje określoną akcję, na przykład instalowanie oprogramowania. Każde zadanie składa się z co najmniej jednego skryptu programu PowerShell wraz z plikiem task.yaml, który zawiera parametry i definiuje sposób uruchamiania skryptów. Możesz również dołączyć polecenie programu PowerShell do pliku task.yaml.
Kolekcję wyselekcjonowanych zadań można przechowywać w katalogu dołączonym do centrum deweloperów z każdym zadaniem w osobnym folderze. Usługa Dev Box obsługuje używanie repozytorium GitHub lub repozytorium usługi Azure Repos jako katalogu. Usługa Dev Box skanuje określony folder katalogu cyklicznie w celu znalezienia definicji zadań.
Zestaw WinGet i program PowerShell są dostępne w dowolnym centrum deweloperskim bez konieczności używania wykazu. Jeśli dostosowania używają tylko polecenia WinGet lub PowerShell, możesz tworzyć zadania, które używają ich w pliku dostosowywania. Jeśli musisz użyć innych narzędzi lub skryptów, możesz utworzyć zadania w katalogu.
Firma Microsoft udostępnia katalog szybkiego startu, który ułatwia rozpoczęcie pracy z dostosowaniami. Zawiera on domyślny zestaw zadań, które definiują typowe akcje:
- Instalowanie oprogramowania przy użyciu menedżera pakietów WinGet.
- Wdróż konfigurację żądanego stanu (DSC) przy użyciu konfiguracji WinGet.
- Sklonuj repozytorium przy użyciu polecenia
git-clone. - Konfigurowanie aplikacji, takich jak instalowanie rozszerzeń programu Visual Studio.
- Uruchom skrypty programu PowerShell.
Tworzenie zadań w wykazie
Zadania, takie jak instalowanie oprogramowania lub uruchamianie skryptów, są zorganizowane w wykazie. Zadania można tworzyć w wykazie i zarządzać nimi, definiować nowe zadania i dołączać katalog do centrum deweloperów. W katalogu szybki start firmy Microsoft możesz rozpocząć pracę z typowymi zadaniami, takimi jak instalowanie oprogramowania, wdrażanie DSC, klonowanie repozytoriów i konfigurowanie aplikacji.
Definiowanie nowych zadań
Aby utworzyć zadania dostosowywania zespołu usługi Dev Box i zarządzać nimi, wykonaj następujące kroki:
Utwórz repozytorium do przechowywania zadań. Opcjonalnie możesz utworzyć kopię katalogu szybkiego startu we własnym repozytorium, aby użyć go jako punktu początkowego.
Utwórz zadania w repozytorium, modyfikując istniejące skrypty programu PowerShell lub tworząc nowe skrypty. Aby rozpocząć tworzenie zadań, możesz użyć przykładów w repozytorium GitHub dla przykładów centrum deweloperów i w dokumentacji programu PowerShell.
Dołącz repozytorium do centrum deweloperów jako wykaz.
Utwórz plik konfiguracji dla tych zadań, wykonując kroki opisane w artykule Zapisywanie pliku dostosowywania.
Używanie wpisów tajnych z usługi Azure Key Vault
Możesz użyć wpisów tajnych z magazynu kluczy platformy Azure w konfiguracjach YAML, aby sklonować repozytoria prywatne lub za pomocą dowolnego niestandardowego zadania, które wymaga tokenu dostępu.
Centrum deweloperskie wymaga dostępu do magazynu kluczy. Program DevCenter nie obsługuje tagów usługi, więc jeśli magazyn kluczy jest przechowywany jako prywatny, musisz zezwolić na obejście zapory przez zaufane usługi firmy Microsoft.
Aby skonfigurować wpisy tajne magazynu kluczy do użycia w konfiguracjach YAML:
Upewnij się, że tożsamość zarządzana projektu centrum deweloperskiego ma rolę Czytelnik usługi Key Vault i Rolę Użytkownika wpisów tajnych usługi Key Vault w magazynie kluczy.
Udziel roli Użytkownik wpisów tajnych usługi Key Vault dla wpisu tajnego magazynu kluczy dla każdego użytkownika lub grupy użytkowników, która powinna mieć możliwość korzystania z wpisu tajnego podczas dostosowywania pola deweloperskiego. Użytkownik lub grupa, któremu udzielono roli, musi zawierać tożsamość zarządzaną centrum deweloperów, własne konto użytkownika oraz dowolny użytkownik lub grupę, która wymaga wpisu tajnego podczas dostosowywania pola deweloperskiego.
Aby uzyskać więcej informacji na temat używania wpisów tajnych magazynu kluczy w pliku dostosowywania, zobacz Klonowanie repozytorium prywatnego przy użyciu pliku dostosowywania.
Dołączanie wykazu
Katalog można dołączyć do projektu, aby udostępnić zadania zespołowi deweloperów. Aby dołączyć wykaz do projektu, wykonaj kroki opisane w temacie Dodawanie i konfigurowanie wykazu z repozytoriów GitHub lub Azure Repos.