Jak používat vývojové tunely v sadě Visual Studio 2022 s aplikacemi ASP.NET Core

Funkce dev tunnels sady Visual Studio 2022 umožňuje ad hoc připojení mezi počítači, které se k sobě nemůžou připojit přímo. Vytvoří se adresa URL, která umožňuje všem zařízením s připojením k internetu připojit se k projektu ASP.NET Core, když běží na localhost.

Případy použití

Některé scénáře, které vývojové tunely umožňují:

  • Otestujte webovou aplikaci na jiných zařízeních, jako jsou mobilní telefony a tablety.
  • Otestujte aplikaci s externími službami. Můžete například testovat a ladit konektory Power Platform, rozhraní API služeb Azure Communication Services nebo webhooky Twilio.
  • Zpřístupněte aplikaci dočasně ostatním uživatelům přes internet, pro prezentaci nebo k pozvání ostatních, aby posoudili vaši práci ve webové aplikaci nebo API.
  • Jako alternativa k jiným řešením přesměrování portů.

Předpoklady

  • Visual Studio 2022 verze 17.6 nebo novější s nainstalovanou úlohou vývoje pro ASP.NET a web . Abyste mohli vytvářet a používat vývojové tunely, musíte být přihlášeni do aplikace Visual Studio.
  • Jeden nebo více projektů ASP.NET Core. Tento článek používá řešení se dvěma ukázkovými projekty k předvedení funkce.

Vytvořit tunel

Chcete-li vytvořit tunel:

V sadě Visual Studio 2022 otevřete webový projekt ASP.NET Core nebo řešení s alespoň jedním webovým projektem nastaveným jako spouštěný projekt.

V rozevírací nabídce ladění vyberte Dev TunnelsCreate A Tunnel.

Rozevírací seznam ladění zobrazující možnost vývojových tunelů s vybranou možností Vytvořit tunel

Otevře se dialogové okno pro vytvoření tunelu.

Dialogové okno pro vytvoření vývojového tunelu

  • Vyberte účet, který chcete použít k vytvoření tunelu. Mezi typy účtů, které je možné použít k vytváření tunelů, patří Azure, účet Microsoft (MSA) a GitHub.
  • Zadejte název tunelu. Tento název identifikuje tunel v uživatelském rozhraní sady Visual Studio.
  • Zvolte typ tunelu, trvalý nebo dočasný:
    • Dočasný tunel získá novou adresu URL při každém spuštění sady Visual Studio.
    • Trvalý tunel získá stejnou adresu URL při každém spuštění sady Visual Studio. Další informace naleznete v části Trvalé a dočasné tunely dále v tomto článku.
  • Zvolte ověřování, které se vyžaduje pro přístup k tunelu. K dispozici jsou následující možnosti:
    • Privátní: Tunel je přístupný pouze pro účet, který ho vytvořil.
    • Organizace: Tunel je přístupný pro účty ve stejné organizaci jako účet, který ho vytvořil. Pokud je tato možnost vybrána pro osobní účet Microsoft (MSA), efekt je stejný jako výběr možnosti Soukromé. Podpora organizace pro účty GitHub není podporovaná.
    • Veřejné: Nevyžaduje se žádné ověřování. Tuto možnost zvolte jenom v případě, že je bezpečné zpřístupnit webovou aplikaci nebo rozhraní API komukoli na internetu.
  • Vyberte OK.

Visual Studio zobrazí potvrzení vytvoření tunelu:

Oznámení o úspěšném vytvoření tunelu

Tunel se zobrazí v rozbalovací nabídce ladění Dev Tunnels:

Rozevírací seznam ladění Dev Tunnels s rozevírací nabídkou zobrazující nový tunel.

Zadejte aktivní tunel

Projekt nebo řešení může mít více tunelů, ale v jednu chvíli je aktivní pouze jeden. Místní nabídka Dev Tunnels v rozevíracím seznamu ladění umožňuje vybrat aktivní tunel. Pokud je aktivní tunel, používá se pro všechny projekty ASP.NET Core, které jsou spuštěné v sadě Visual Studio. Jakmile je tunel vybraný jako aktivní, zůstane aktivní, dokud se Visual Studio nezavře. Na následujícím obrázku je My Temporary Tunnel aktivní:

Rozevírací seznam ladění zobrazující aktivní tunel v informačním rámečku Vývojové tunely

Tunel nepoužívejte výběrem možnosti Žádné v rozbalovacím panelu. Po restartování sady Visual Studio se ve výchozím nastavení vrátí zpět na Žádné.

Použijte tunel

Když je tunel aktivní a Visual Studio spustí webovou aplikaci, otevře se webový prohlížeč na adresu URL tunelu místo adresy URL místního hostitele. Adresa URL tunelu vypadá jako v následujícím příkladu:

https://0pbvlk3m-7032.usw2.devtunnels.ms

Teď může jakýkoli ověřený uživatel otevřít stejnou adresu URL na jakémkoli jiném zařízení připojeném k internetu. Dokud projekt bude dál běžet místně, bude mít jakékoli zařízení s připojením k internetu přístup k webové aplikaci spuštěné na vývojovém počítači.

U webových projektů, které mají podporu v prohlížeči, se při prvním požadavku odeslaném na adresu URL tunelu z každého zařízení zobrazí stránka s upozorněním:

Stránka s oznámením o tunelech pro vývojáře

Jakmile je vybraná možnost Pokračovat , požadavek se přesměruje do místní webové aplikace. Tato stránka oznámení se nezobrazuje pro požadavky rozhraní API využívající vývojové tunely.

Použijte tunel k otestování na telefonu nebo tabletu

Pokud chcete otestovat webovou aplikaci z externího zařízení, jako je telefon nebo tablet, přejděte na adresu URL tunelu. Pokud chcete usnadnit reprodukci adresy URL na externím zařízení:

  • Přejděte na adresu URL tunelu v prohlížeči Edge na místním počítači.
  • Vygenerujte kód QR na adresu URL v prohlížeči Edge na místním počítači:
    • Vyberte panel adres URL a zobrazí se tlačítko kódu QR.
    • Vyberte tlačítko Kód QR a vygenerujte a zobrazte kód QR. Kód QR se zvýrazněným tlačítkem pro jeho vytvoření.
  • Naskenujte tento kód QR telefonem nebo tabletem a přejděte na adresu URL.

Okno výstupu Dev Tunnels

Pokud chcete zobrazit adresu URL tunelu spuštěného projektu, v rozevíracím seznamu Zobrazit výstup z vyberte Vývojové tunely.

Okno výstupu Dev Tunnels

Toto okno je zvlášť užitečné pro projekty, které se ve výchozím nastavení neotevírají v prohlížeči. Například při práci s funkcí Azure Functions to může být nejjednodušší způsob, jak zjistit veřejnou adresu URL, kterou používá vývojový tunel.

Okno nástroje Dev Tunnels

Zobrazte a spravujte vývojové tunely v okně nástroje Dev Tunnels:

Okno nástroje Dev Tunnels

Okno Dev Tunnels otevřete tak, že v rozevírací nabídce ladění vyberete Zobrazit okno Dev Tunnels. Případně vyberte Zobrazit>Další okna>Dev Tunnels.

V okně Dev Tunnels vytvořte nový tunel výběrem zeleného + tlačítka.

Odstraňte tunel pomocí červeného x tlačítka napravo od tunelu.

Místní nabídka tunelu nabízí následující možnosti:

  • Resetovat aktivní tunel: Zobrazí se, když je tunel nakonfigurovaný jako aktivní (označený zaškrtnutím na levé straně), tím se tunel resetuje, aby řešení nepoužívalo tunel.
  • Nastavit jako aktivní: Zobrazí se pro tunely, které nejsou nakonfigurované jako aktivní.
  • Kopírovat přístupový token tunelu: Poskytuje se pro scénáře, kdy se tunel vytváří s privátním přístupem nebo přístupem k organizaci a aplikace je webové rozhraní API. Pokud se chcete ověřit pro tunel, zkopírujte přístupový token tunelu a vložte ho jako hlavičku ve tvaru X-Tunnel-Authorization tunnel <TOKEN> v požadavku. Pokud není tato hlavička zadaná, požadavek se zablokuje, protože kontrola ověřování selhala.
  • Odstranit

Proměnné prostředí tunelové adresy URL

Funkce vývojových tunelů poskytuje způsob, jak získat adresu URL tunelu projektu programově za běhu. Při spuštění aplikace, která používá tunel, Visual Studio vytvoří proměnnou prostředí VS_TUNNEL_URL. Hodnota VS_TUNNEL_URL je adresa URL tunelu, který se používá pro aktuální projekt. VS_TUNNEL_URL může být užitečné při integraci aplikace s externí službou, kde musí být adresa URL tunelu předána externí službě.

Pokud je pro spuštění v sadě Visual Studio nakonfigurovaných více projektů ASP.NET Core, aplikace, která se spouští, získá proměnnou prostředí pro každý projekt, který se spustil dříve. Vzor pro tento název proměnné je VS_TUNNEL_URL_{ProjectName}, kde {ProjectName} je název druhého projektu. Představte si například tento příklad znázorňující dva projekty nastavené na spuštění:

Stránka výběru projektů zobrazující MyWebApi a MyWebApp s oběma spouštěnými projekty v daném pořadí.

Vzhledem k tomu, že MyWebApi je nad MyWebApp, spustí se před projektem MyWebApp. Po spuštění projektu MyWebApi obdrží adresu URL tunelu v proměnné prostředí VS_TUNNEL_URL. Po spuštění projektu MyWebApp obdrží vlastní adresu URL tunelu v VS_TUNNEL_URL a adresa URL tunelu jiného projektu se poskytne v proměnné prostředí VS_TUNNEL_URL_MyWebApi.

Pro ilustraci byly do souboru Program.cs v MyWebApp přidány následující zvýrazněné řádky kódu:

public class Program
{
    public static void Main(string[] args)
    {
        Console.WriteLine($"Tunnel URL: {Environment.
            GetEnvironmentVariable("VS_TUNNEL_URL")}");
        Console.WriteLine($"API project tunnel URL: {Environment.
            GetEnvironmentVariable("VS_TUNNEL_URL_MyWebApi")}");

Po spuštění webové aplikace bude výstup konzoly vypadat jako v následujícím příkladu:

Tunnel URL: https://lxm0ltdt-7175.usw2.devtunnels.ms/
API project tunnel URL: https://lxm0ltdt-7042.usw2.devtunnels.ms/
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:7175
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5228
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\DevTunnelsDemo\MyWebApp

Informace o nastavení více spouštěcích projektů naleznete v tématu Postupy: Nastavení více spouštěcích projektů.

Trvalé a dočasné tunely

Trvalý tunel je ten, který po ukončení a restartování sady Visual Studio používá stejnou adresu URL. Adresa URL, která se nezmění, může být užitečná při integraci webové aplikace s externí službou. Například implementace webhooku GitHubu nebo vývoj rozhraní API pro integraci s aplikací Power Platform. V takových případech může být potřeba zadat adresu URL zpětného volání externí služby. U trvalého tunelu je potřeba adresu URL externí služby nakonfigurovat jenom jednou. Při použití dočasného tunelu musí být adresa URL tunelu nakonfigurovaná po každém restartování sady Visual Studio.

Trvalý neznamená, že tunel funguje, když visual Studio není otevřené. Adresa URL tunelu se připojí k místnímu počítači jenom v případě, že projekt ASP.NET Core, ke kterému se adresa URL tunelu připojuje, je spuštěný v aplikaci Visual Studio.

Dočasný tunel je v pořádku, když adresa URL vývojového tunelu musí chvíli fungovat. Například sdílení probíhající práce na webové aplikaci s ostatními nebo testování aplikace na externím zařízení. V některých případech může být nejlepší získat novou adresu URL při každém spuštění sady Visual Studio.

Viz také

Následující zdroje informací používají ranou předběžnou verzi funkce vývojových tunelů, takže jejich části jsou zastaralé: