Sdílet prostřednictvím

Aspire Visual Studio Code rozšíření

Rozšíření AspireVisual Studio Code poskytuje sadu příkazů a nástrojů pro zjednodušení práce v Aspire rámci Visual Studio Code. Součástí rozšíření jsou příkazy pro vytváření projektů, přidávání integrací, konfigurace řešení a správa nasazení. Rozšíření vyžaduje rozhraní příkazového Aspire řádku a poskytuje na Visual Studio Code paletě příkazů podobnou funkcionalitu.

Požadavky

Pokud chcete pracovat s Aspire, potřebujete místně nainstalovat následující:

Další informace najdete v tématu Aspire nastavení a nástroje a Aspire SDK.

Než také budete moct použít rozšíření , musíte mít nainstalované rozhraní příkazového řádku a dostupné na cestě PATH.

Instalovat Aspire rozšíření

Aspire Instalace rozšíření VS Code:

  1. Otevřete VS Code.

  2. Otevřete zobrazení Rozšíření výběrem možnosti Zobrazit>rozšíření nebo stisknutím kombinace kláves Ctrl+Shift+X (Windows/Linux) nebo Cmd+Shift+X (macOS).

  3. Na trhu s doplňky vyhledejte "Aspire".

  4. Aspire Vyberte rozšíření publikované Microsoftem.

  5. Vyberte volbu Instalovat.

    Snímek obrazovky editoru VS Code znázorňující, jak nainstalovat Aspire rozšíření

Případně můžete rozšíření nainstalovat přímo z marketplace VS Code.

Příkazy rozšíření aplikace Access

Všechny Aspire příkazy rozšíření jsou k dispozici z palety příkazů VS Code:

  1. Stisknutím kombinace kláves Ctrl+Shift+P (Windows/Linux) nebo Cmd+Shift+P (macOS) otevřete paletu příkazů.
  2. Zadáním "Aspire" vyfiltrujte a zobrazte všechny dostupné Aspire příkazy.
  3. V seznamu vyberte požadovaný příkaz.

Všechny příkazy jsou seskupené do Aspire kategorie v paletě příkazů, aby bylo snadné zjišťování.

Dostupné příkazy

Rozšíření Aspire VS Code poskytuje následující příkazy:

Command Description Availability
Aspire: Nový Aspire projekt Vytvořte nový Aspire apphost nebo úvodní aplikaci ze šablony. K dispozici
Aspire: Přidání integrace Přidejte integraci hostingu (Aspire.Hosting.*) do apphostu Aspire. K dispozici
Aspire: Konfigurujte launch.json Přidá do pracovního prostoru launch.json výchozí konfiguraci spuštění ladicího programu Aspire, která rozpozná a spustí apphost v pracovním prostoru. K dispozici
Aspire: Správa nastavení konfigurace Umožňuje spravovat nastavení konfigurace včetně příznaků funkcí. K dispozici
Aspire: Otevřený Aspire terminál Aspire Otevřete terminál VS Code pro práci s Aspire projekty. K dispozici
Aspire: Publikování nasazovacích artefaktů Generuje artefakty nasazení pro Aspire hostitele aplikace. Preview
Aspire: Nasazení aplikace Nasaďte obsah Aspire apphostu do jeho definovaných cílů nasazení. Preview
Aspire: Aktualizace integrací Aktualizace integrací hostování a Aspire sady SDK v apphostu Preview

Vytvoření nové Aspire aplikace

Vytvoření nové Aspire aplikace pomocí rozšíření:

  1. Otevřete paletu příkazů (Ctrl+Shift+P nebo Cmd+Shift+P).

  2. Spusťte příkaz Aspire: Nový Aspire projekt

  3. Vyberte požadovanou šablonu:

  4. Zadejte název a umístění projektu.

    Snímek obrazovky editoru VS Code znázorňující, jak vytvořit nové Aspire řešení pomocí Aspire rozšíření

Rozšíření vytvoří projekt a otevře ho ve VS Code.

Přidání integrace do Aspire řešení

Aspire integrace poskytují předem nakonfigurovaná připojení k různým cloudovým službám a závislostem. Přidání integrace:

  1. Otevřete paletu příkazů.
  2. Spusťte příkaz Aspire: Přidání integračního příkazu.
  3. Prohlížejte nebo vyhledejte požadovaný balíček integrace.
  4. Vyberte integraci a přidejte ji do projektu AppHost.

Rozšíření přidá příslušný odkaz na balíček NuGet do projektu AppHost.

Poznámka:

Příkaz Přidat integraci přidá integraci hostování do projektu AppHost. Nepřidá odpovídající integraci klienta do žádných náročných projektů.

Konfigurujte Aspire řešení

Rozšíření Aspire obsahuje několik příkazů, které během vývoje konfigurují chování Aspire a Aspire rozhraní příkazového řádku:

Konfigurace launch.json pro ladění

Pokud chcete spustit a ladit aplikaci Aspire ve VS Code, musíte soubor nakonfigurovat launch.json :

  1. Otevřete paletu příkazů.
  2. Spusťte příkaz : Konfigurace launch.json.Aspire
  3. Rozšíření přidá do souboru pracovního prostoru Aspire výchozí launch.json konfiguraci ladicího programu.

Výchozí konfigurace vypadá takto:

{
    "type": "aspire",
    "request": "launch",
    "name": "Aspire: Launch Default AppHost",
    "program": "${workspaceFolder}"
}

Pole můžete přizpůsobit program tak, aby odkazovalo na konkrétní soubor projektu AppHost. Například:

{
    "type": "aspire",
    "request": "launch",
    "name": "Aspire: Launch MyAppHost",
    "program": "${workspaceFolder}/MyAppHost/MyAppHost.csproj"
}

Správa nastavení konfigurace

Příkaz Aspire: Spravovat nastavení konfigurace spustí aspire config možnosti požadavku a zobrazí výsledky v terminálu VS Code. Použijte get a set příkazy ke konfiguraci Aspire CLI. list Pomocí příkazu zobrazíte aktuální hodnoty konfigurace.

Spusťte řešení v režimu vývoje Aspire

Spusťte Aspire aplikaci v režimu vývoje:

  1. Ujistěte se, že jste nakonfigurovali, jak je popsáno launch.json v části Konfigurace launch.json pro ladění .
  2. Otevřete zobrazení Běh a ladění výběrem možnosti Zobrazení> a Běh nebo stisknutím Ctrl+Shift+D (Windows/Linux) nebo Cmd+Shift+D (macOS).
  3. Aspire V rozevíracím seznamu vyberte konfiguraci spuštění.
  4. Vyberte zelené tlačítko Spustit ladění nebo stiskněte klávesu F5.

Rozšíření sestaví projekt AppHost, spustí ho, otevře řídicí panel Aspire ve vašem prohlížeči a povolí ladění pro všechny prostředky ve vašem řešení.

Případně můžete otevřít Aspire terminál VS Code pomocí Aspire: Open Aspire terminal a spustit aspire run --start-debug-session ladicí relaci ve VS Code.

Spuštění nebo ladění kódu v editoru

Když se v pracovním prostoru zjistí projekt AppHost, můžete ho také spustit nebo ladit přímo z editoru. Při prohlížení souboru AppHost použijte tlačítka pro spuštění v záhlaví editoru.

Publikování artefaktů nasazení

Důležité

Tato funkce je ve verzi Preview.

Příkaz Aspire: Vytvořit generuje artefakty nasazení pro váš Aspire AppHost. Tento příkaz serializuje prostředky na disk, aby je mohly využívat nástroje pro nasazení.

Publikování nasazovacích artefaktů:

  1. Otevřete paletu příkazů.
  2. Spusťte příkaz Publikování nasazovacích artefaktůAspire.
  3. Vyberte výstupní umístění pro vygenerované artefakty.

Příkaz vyvolá registrované anotace zpětného volání pro publikování za účelem generování artefaktů, jako jsou:

  • Soubory formátu Bicep pro prostředky Azure
  • Docker Vytváření souborů YAML
  • Kubernetes Helm charty.

Další informace o publikování najdete v AspiretématuAspire Přehled publikování a nasazení.

Nasadit Aspire řešení

Důležité

Tato funkce je ve verzi Preview.

Příkaz Aspire: Nasazení hostitele aplikace nasadí obsah AppHost do definovaných Aspire cílů nasazení.

Chcete-li nasadit řešení Aspire:

  1. Otevřete paletu příkazů.
  2. Spusťte příkaz : Nasazení hostitele aplikace.Aspire
  3. Podle pokynů vyberte cíle nasazení a zadejte požadovanou konfiguraci.

Příkaz publikuje artefakty nasazení a potom vyvolá poznámky zpětného volání nasazení k nasazení prostředků do určených cílů.

Další informace o nasazení najdete v Aspire tématu Aspire Přehled publikování a nasazení.

Otevření Aspire terminálu

Příkaz Aspire: Otevřít Aspire terminál otevře okno terminálu nakonfigurované pro práci s Aspire projekty. Tento terminál poskytuje snadný přístup k Aspire příkazům rozhraní příkazového řádku a je předem nakonfigurovaný s příslušnými proměnnými prostředí.

Zpětná vazba a problémy

Pro ohlášení problémů nebo požádání o funkce pro rozšíření Aspire VS Code:

  1. Aspire GitHub Navštivte úložiště.
  2. Vytvořte nový problém a přidejte area-extension popisek.

Viz také

  • Last updated on