Vytvořte definiční soubor obrázku pro úpravy týmu Dev Box.

Funkce přizpůsobení Microsoft Dev Boxu vám pomůže zjednodušit nastavení cloudových vývojových prostředí. Zahájení práce vývojářů na novém projektu nebo s novým týmem je často složité a časově náročné. Pomocí přizpůsobení můžete nakonfigurovat pracovní stanice připravené k kódování pomocí aplikací, nástrojů, úložišť, knihoven kódu, balíčků a skriptů sestavení. Tento článek vás provede procesem vytváření, testování a úprav souboru definice obrázku pro vývojové pole pomocí editoru Visual Studio Code.

Existují dva způsoby použití přizpůsobení v Dev Boxu. Přizpůsobení týmu vytvoří sdílenou konfiguraci pro tým vývojářů. Přizpůsobení uživatelů vytvoří osobní konfiguraci 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

• Mít vývojové centrum nakonfigurované s fondem vývojových boxů a projektem vývojového boxu, abyste mohli vytvořit vývojový box.
• 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 definičním souboru obrázku. 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í

Činnost	Oprávnění nebo role
Povolte katalogy na úrovni projektu pro vývojové centrum.	Inženýr platformy s oprávněním k zápisu v rámci předplatného.
Povolte nastavení synchronizace katalogu pro projekt.	Inženýr platformy s oprávněním k zápisu v rámci předplatného.
Připojte katalog k projektu.	Oprávnění správce projektu nebo přispěvatele centra Dev Center k projektu
Vytvořte definiční soubor obrázku.	Žádný není uveden. Každý může vytvořit definiční soubor obrázku.
Přidejte úkoly do katalogu.	Oprávnění k přidání do úložiště, které je hostitelem katalogu.

Volba zdroje pro úlohy přizpůsobení

Úkoly Dev Boxu můžete vytvářet z úloh integrovaných na platformě nebo můžete použít vlastní úlohy uložené v katalogu. Vyberte zdroj, který nejlépe odpovídá vašim potřebám přizpůsobení a požadavkům projektu.

• Použijte předdefinované úlohy WinGet a PowerShellu. Vývojová centra Dev Box podporují úkoly PowerShellu a WinGetu automaticky. S těmito integrovanými úkoly můžete začít. Pokud vaše vlastní nastavení vyžadují jenom PowerShell a WinGet, pokračujte vytvořením souboru vlastních nastavení. Další informace najdete v tématu Vytvoření definičního souboru obrázku.

  Vestavěná úloha WinGet není spustitelný soubor WinGet. Vestavěná úloha WinGet je založená na cmdletu WinGet PowerShellu.

• K definování vlastních úkolů použijte katalog. Můžete vytvořit vlastní úkoly. Pokud chcete zpřístupnit vlastní úkoly pro celou organizaci, připojte k vývojovému centru katalog, který obsahuje vlastní definice úkolů. Dev Box podporuje katalogy Azure Repos a GitHub. Vzhledem k tomu, že úlohy jsou definovány pouze v centru pro vývoj, ukládejte úlohy a definice obrázků v samostatných úložištích.

  Další informace o tom, jak definovat vlastní úkoly, najdete v tématu Vytváření úkolů pro přizpůsobení týmu Dev Boxu.

Vytváření definic obrázků na úrovni projektu

Projekty vám můžou pomoct efektivně spravovat prostředky Dev Boxu. Když každému vývojářskému týmu přiřadíte vlastní projekt, můžete efektivně uspořádat prostředky. V úložišti katalogu můžete vytvořit několik definic imagí, z nichž každá je ve své vlastní složce určená pro cílení na různé vývojářské týmy v rámci vašeho projektu.

Přiřazení oprávnění pro správce projektu

Pokud chcete k projektu připojit katalog, musíte mít pro projekt oprávnění správce projektu nebo přispěvatele. Informace o přiřazování oprávnění správce projektu najdete v tématu Udělení přístupu správce k projektům Dev Box.

Povolení katalogů na úrovni projektu

Katalogy na úrovni projektu musíte povolit na úrovni dev center, abyste mohli přidat katalog do projektu. Povolení použití katalogů na úrovni projektu na úrovni dev center:

1. Na webu Azure Portal přejděte do vývojového centra.

2. V nabídce vlevo v části Nastavení vyberte Nastavení Dev Center.

3. V části Katalogy na úrovni projektu vyberte Povolit katalogy na jeden projekt a pak vyberte Použít.

   

Další informace o tom, jak přidat katalogy do projektů, najdete v tématu Přidání a konfigurace katalogu z GitHubu nebo Azure Repos.

Vytvoření definičního souboru obrázku

Soubory definic obrázků můžete vytvářet a testovat pomocí editoru Visual Studio Code. Kromě použití předdefinovaných úloh můžete pomocí rozšíření Dev Box v editoru Visual Studio Code zjistit vlastní úlohy, které jsou dostupné prostřednictvím vývojového centra.

1. Vytvoření vývojového pole (nebo použití existujícího vývojového pole) k testování

2. V testovacím vývojovém poli nainstalujte Visual Studio Code a pak nainstalujte rozšíření Dev Box.

3. Stáhněte si ukázkový soubor definice image YAML z úložiště ukázek. Otevřete ho v editoru Visual Studio Code.

4. Pomocí palety příkazů objevte úlohy, které jsou v katalogu k dispozici. Vyberte Zobrazit>Paleta příkazů>Dev Box: Seznam dostupných úkolů pro tento Dev Box.

   

5. Otestujte přizpůsobení v editoru Visual Studio Code pomocí palety příkazů. Výběr Zobrazit>Paleta příkazů>Dev Box: Použít úkoly přizpůsobení.

   

6. Soubor definice obrázku se spustí a použije zadané úlohy do testovacího vývojového pole. Zkontrolujte změny a zkontrolujte v terminálu editoru Visual Studio Code případné chyby nebo upozornění vygenerované během provádění úlohy.

7. Po úspěšném spuštění definičního souboru obrázku ho nahrajte do katalogu.

Systémové úlohy a uživatelské úkoly

V definičním souboru obrázku můžete použít systémové i uživatelské úlohy. Oddíl úkolů definičního souboru obrázku je rozdělený do následujících částí. Obě oddíly sdílejí stejné parametry na základě definic úloh v katalogu.

• Systémové úlohy: Tyto úlohy se spouštějí jako LocalSystem ve fázi zřizování vývojového pole. Obvykle se používají pro konfigurace na úrovni systému, jako je instalace softwaru nebo konfigurace nastavení systému, která vyžadují oprávnění správce.
• Uživatelské úlohy: Tyto úlohy se spustí jako uživatel po prvním přihlášení uživatele do vývojového pole. Obvykle se používají pro konfigurace na úrovni uživatele, jako je instalace aplikací specifických pro uživatele nebo konfigurace uživatelských nastavení v kontextu uživatele. Uživatelé například často dávají přednost instalaci Pythonu a editoru Visual Studio Code v kontextu uživatele místo celého systému. Dejte úkoly WinGet do části userTasks, aby byly výsledky lepší, pokud nefungují v rámci úkolů.

Standardní uživatelé, kteří konfigurují vlastní nastavení uživatelů, můžou používat jenom uživatelské úlohy. Nemůžou používat systémové úlohy.

Volitelné: Přizpůsobení vývojového pole pomocí existujících souborů konfigurace požadovaného stavu

Desired State Configuration (DSC) je platforma pro správu v PowerShellu, která umožňuje spravovat vývojové prostředí pomocí konfigurace jako kódu. DSC můžete použít k definování požadovaného stavu vývojového pole, včetně instalací softwaru, konfigurací a nastavení.

Konfigurační soubory DSC můžete použít také k nastavení vývojového pole pomocí integrované úlohy WinGet.

Následující příklad ukazuje definiční soubor image vývojového boxu, který volá existující soubor WinGet DSC:

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

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

Konfigurace nastavení synchronizace katalogu pro projekt

Nakonfigurujte projekt tak, aby synchronizoval definice obrázků z katalogu. Pomocí tohoto nastavení můžete pomocí definic obrázků v katalogu vytvořit fondy vývojových boxů.

1. Přihlaste se do Azure Portalu.

2. Do vyhledávacího pole zadejte projekty. V seznamu výsledků vyberte Projekty.

3. Otevřete projekt Dev Boxu, pro který chcete nakonfigurovat nastavení synchronizace katalogu.

4. Vyberte Katalogy.

5. Vyberte Nastavení synchronizace.

   

6. V podokně Nastavení synchronizace vyberte Definice obrázků a pak vyberte Uložit.

   

Připojení katalogu obsahujícího definiční soubor

Než budete moct jako definici obrázku použít soubor přizpůsobení, musíte k vývojovému centru nebo projektu připojit katalog, který obsahuje definiční soubor. Katalog může být z GitHubu nebo Azure Repos.

Podokno Definice obrázků obsahuje seznam definic obrázků, ke kterým má váš projekt přístup.

Další informace o připojení katalogů najdete v tématu Přidání a konfigurace katalogu z GitHubu nebo Azure Repos.

Konfigurace fondu vývojových boxů pro použití definice obrázku

Zpřístupněte přizpůsobení svým vývojovým týmům tím, že nakonfigurujete fond vývojových prostředků k použití souboru přizpůsobení (imagedefinition.yaml). Uložte soubor přizpůsobení v úložišti propojeném s katalogem ve vývojovém centru nebo projektu. Tento soubor zadejte jako definici image pro fond a vlastní nastavení se použijí pro nová vývojová pole.

Následující kroky ukazují, jak vytvořit fond vývojových boxů a zadat definici image:

1. Přihlaste se do Azure Portalu.

2. Do vyhledávacího pole zadejte projekty. V seznamu výsledků vyberte Projekty.

3. Otevřete projekt Dev Boxu, ke kterému chcete přidružit nový fond vývojových boxů.

4. Vyberte fondy vývojových boxů a vyberte Vytvořit.

5. V podokně Vytvořit fond vývojových boxů zadejte následující hodnoty:

   Nastavení	Hodnota
   název	Zadejte název pro bazén. Název fondu je viditelný pro vývojáře, aby si ho mohli zvolit při vytváření vývojového prostředí. Musí být jedinečný v rámci projektu.
   definice	Toto pole obsahuje seznam definic obrázků z přístupných katalogů a definic vývojového rámečku. Vyberte soubor definice obrázku.
   Síťové připojení	Vyberte Nasadit do sítě hostované Microsoftem nebo použijte existující síťové připojení.
   Povolení jednotného přihlašování	Chcete-li povolit jednotné přihlašování pro vývojové boxy v tomto fondu, vyberte Ano. Pro organizaci musí být nakonfigurované jednotné přihlašování. Další informace najdete v tématu Povolení jednotného přihlašování pro vývojová pole.
   Oprávnění pro tvůrce vývojového prostředí	Vyberte místního správce nebo standardního uživatele.
   Povolení automatického zastavení	Ano je výchozí hodnota. Chcete-li zakázat plán automatického zastavení, vyberte Ne. Po vytvoření fondu můžete nakonfigurovat plán automatického zastavení.
   Čas zastavení	Vyberte čas k vypnutí všech vývojových boxů ve fondu.
   Časové pásmo	Vyberte časové pásmo, ve které je čas zastavení.
   Licencování	Zaškrtnutím tohoto políčka potvrďte, že vaše organizace má licence Azure Hybrid Benefit, které chcete použít pro vývojové boxy v této kolekci.

   

6. Vyberte Vytvořit.

7. Ověřte, že se v seznamu zobrazí nový fond vývojových boxů. Možná budete muset obrazovku aktualizovat.

Vytvoření vývojového pole pomocí portálu pro vývojáře

Pokud chcete ověřit, že se použijí vlastní nastavení ze souboru definice obrázku, vytvořte vývojové pole na portálu pro vývojáře Dev Boxu. Postupujte podle kroků v rychlém startu: Vytvoření a připojení k vývojovému poli pomocí vývojářského portálu Dev Boxu. Pak se připojte k nově vytvořenému vývojovému poli a ověřte, že přizpůsobení funguje podle očekávání.

Můžete upravit soubor přizpůsobení a vytvořit nové vývojové pole pro otestování změn. Pokud jste si jistí, že jsou vlastní nastavení správná, můžete vytvořit opakovaně použitelnou image.

Další krok

Teď, když máte soubor definice obrázku, nahrajte ho do katalogu a připojte katalog k projektu. Soubor definice obrázku slouží ke konfiguraci a vytváření vývojových polí pro vývojové týmy.

Konfigurace vytváření obrázků pro přizpůsobení týmu Dev Boxu