Napsat soubor vlastního nastavení uživatele pro vývojový box

2025-05-30

Funkce přizpůsobení uživatelů Dev Boxu vám pomůže zjednodušit nastavení vývojových polí. Zahájení nového projektu nebo připojení k týmu je často složité a časově náročné. Pomocí přizpůsobení můžete nakonfigurovat vývojové pole pomocí aplikací, nástrojů, úložišť, knihoven kódu, balíčků a skriptů sestavení, které potřebujete. Tento článek vás provede procesem vytváření, testování a úprav souboru přizpůsobení uživatele pro vaše vývojové prostředí pomocí editoru Visual Studio Code (VS Code).

Vlastní nastavení můžete v Microsoft Dev Boxu použít dvěma způsoby. Přizpůsobení týmu slouží k vytvoření sdílené konfigurace pro tým vývojářů. Přizpůsobení uživatelů se používá k vytvoření osobní konfigurace pro jednotlivé vývojáře. Následující tabulka shrnuje rozdíly mezi dvěma typy přizpůsobení.

Vlastnost	Přizpůsobení týmu	Přizpůsobení uživatelů
Konfigurace zapnutá	Fond vývojových boxů	Pole Pro vývoj
Vlastní nastavení se vztahují na	Všechny vývojové boxy ve fondu	Individuální vývojové prostředí
Snadné sdílení	Ano	Ne
Název souboru vlastního nastavení	Imagedefinition.yaml	myfilename.yaml nebo workload.yaml
Zdroj od:	Katalog	Nahrané nebo z osobního úložiště
Podporuje tajné kódy trezoru klíčů.	Ano	Ano

Požadavky

Pokud chcete dokončit kroky v tomto článku, musíte:

Nakonfigurujte vývojové centrum s definicí vývojového pole, fondem vývojových boxů a projektem vývojového boxu, abyste mohli vytvořit vývojové pole.
Buďte členem skupiny zabezpečení Dev Box Users alespoň pro jeden projekt.
Katalog je připojený k vývojovému centru s úlohami, které můžete použít v souboru vlastního nastavení. Pokud katalog nemáte, přečtěte si téma Přidání a konfigurace katalogu z GitHubu nebo Azure Repos.

Oprávnění potřebná ke konfiguraci vlastních nastavení

Pokud chcete provést požadované akce pro vytváření a aplikování vlastních nastavení na vývojové pole, potřebujete následující oprávnění:

Činnost	Oprávnění nebo role
Vytvořte soubor vlastního nastavení.	Žádný není uveden. Soubor vlastního nastavení může vytvořit kdokoli.
Pomocí portálu pro vývojáře nahrajte a použijte soubor YAML během vytváření vývojového pole.	Uživatel Dev Boxu

Vytvoření souboru vlastního nastavení uživatele

Soubory přizpůsobení můžete vytvářet a spravovat pomocí nástroje VS Code. Rozšíření Microsoft Dev Box v editoru VS Code můžete použít ke zjištění úloh v připojeném katalogu a otestování souboru přizpůsobení.

Vytvoření vývojového pole (nebo použití existujícího vývojového pole) k testování
V testovacím vývojovém poli nainstalujte VS Code a pak nainstalujte rozšíření Dev Box.
Stáhněte si ukázkový soubor přizpůsobení YAML z úložiště ukázek a otevřete ho ve VS Code.
Objevte úkoly dostupné v katalogu pomocí palety příkazů. Vyberte Zobrazit>Paleta příkazů>Dev Box: Seznam dostupných úkolů pro tento Dev Box.
Otestujte přizpůsobení v editoru VS Code pomocí palety příkazů. Výběr Zobrazit>Paleta příkazů>Dev Box: Použít úkoly přizpůsobení.
Soubor přizpůsobení se spustí a použije zadané úlohy na testovací vývojovou stanici. Zkontrolujte změny a v terminálu VS Code zkontrolujte případné chyby nebo upozornění vygenerovaná během provádění úlohy. V terminálu VS Code zkontrolujte chyby nebo upozornění během provádění úlohy.
Když se soubor přizpůsobení úspěšně spustí, nahrajte ho do katalogu.

Volitelné: Přizpůsobení vývojového pole pomocí existujících konfiguračních souborů WinGet

Konfigurace WinGet používá přístup "konfigurace jako kód" k definování jedinečných sad softwaru a konfiguračních nastavení, které jsou potřeba, aby vaše prostředí Windows bylo připravené na programování. Tyto konfigurační soubory můžete také použít k nastavení vývojového pole pomocí úlohy WinGet zahrnuté v katalogu Rychlý start od Microsoftu.

Tento příklad ukazuje soubor přizpůsobení vývojového pole, který používá existující soubor DSC (WinGet Desired State Configuration):

tasks:
    - name: winget
      parameters:
          configure: "projectConfiguration.dsc.yaml"

Další informace najdete v tématu Konfigurace WinGet.

Vytvořte vývojářský box pomocí souboru uživatelského přizpůsobení

Soubor individuálního přizpůsobení můžete použít tak, že ho nahrajete z místního disku při vytváření vývojového pole nebo ho stáhnete z úložiště. Soubory přizpůsobení uložené v úložišti se musí jmenovat workload.yaml. Soubory přizpůsobení uložené místně pro nahrávání by se měly jmenovat myfilename.yaml. Soubory pro přizpůsobení jmen uložené místně k nahrání jako myfilename.yaml.

Odeslání souboru

Na portálu pro vývojáře vyberte Nové>nové vývojové pole.
V podokně Přidat vývojové pole přidejte podrobnosti o vývojovém poli.
Vyberte Použít vlastní nastavení a pak vyberte Pokračovat.
Vyberte Nahrát soubor vlastního nastavení, vyberte Přidat vlastní nastavení ze souboru, a poté přejděte k souboru myfilename.yaml a vyberte jej.
Abyste ověřili, že se úlohy v souboru vlastních nastavení použijí správně, musíte je před pokračováním ověřit. Vyberte Ověřit.
Projděte si souhrn vytvoření vývojového pole a pak vyberte Vytvořit.

Získání souboru z úložiště

Na portálu pro vývojáře vyberte Nové>nové vývojové pole.
V podokně Přidat vývojové pole přidejte podrobnosti o vývojovém poli.
Vyberte Použít vlastní nastavení a pak vyberte Pokračovat.
Vyberte Nahrát soubory vlastního nastavení, vyberte Zvolit soubor vlastního nastavení z úložiště a pak zadejte adresu URL úložiště, do kterého se uloží váš soubor workload.yaml .
Abyste ověřili, že se úlohy v souboru vlastních nastavení použijí správně, musíte je před pokračováním ověřit. Vyberte Ověřit.
Projděte si souhrn vytvoření vývojového pole a pak vyberte Vytvořit.

Sdílet prostřednictvím