Visual Studio Container Tools for Docker

Požadavky

• Docker Desktop
• Visual Studio 2019 s nainstalovanou úlohou Vývoj webu, Azure Tools a/nebo .NET Core pro různé platformy
• Vývojové nástroje .NET Core pro vývoj s .NET Core
• Pokud chcete publikovat do služby Azure Container Registry, předplatné Azure. Zaregistrujte si bezplatnou zkušební verzi.

Podpora Dockeru v sadě Visual Studio

Podpora Dockeru je dostupná pro projekty ASP.NET, projekty ASP.NET Core a konzolové projekty .NET Core a .NET Framework.

Podpora Dockeru v sadě Visual Studio se v reakci na potřeby zákazníků změnila v několika verzích. Do projektu můžete přidat dvě úrovně podpory Dockeru a podporované možnosti se liší podle typu projektu a verze sady Visual Studio. Pokud u některých podporovaných typů projektů chcete jenom kontejner pro jeden projekt bez použití orchestrace, můžete to udělat přidáním podpory Dockeru. Další úrovní je podpora orchestrace kontejnerů, která přidává odpovídající soubory podpory pro konkrétního orchestrátora, který zvolíte.

V sadě Visual Studio 2019 můžete jako služby orchestrace kontejnerů používat Docker Compose, Kubernetes a Service Fabric.

V sadě Visual Studio 2019 verze 16.4 a novější je k dispozici okno Kontejnery, které umožňuje zobrazit spuštěné kontejnery , procházet dostupné image, zobrazit proměnné prostředí, protokoly a mapování portů, zkontrolovat systém souborů, připojit ladicí program nebo otevřít okno terminálu v prostředí kontejneru. Viz Použití okna Kontejnery.

Požadavky

• Docker Desktop
• Visual Studio 2022 s nainstalovanou úlohou Vývoj webu, Azure Tools a/nebo .NET desktopový vývoj
• Pokud chcete publikovat do služby Azure Container Registry, předplatné Azure. Zaregistrujte si bezplatnou zkušební verzi.

Podpora Dockeru v sadě Visual Studio

Podpora Dockeru je dostupná pro projekty ASP.NET, projekty ASP.NET Core a konzolové projekty .NET Core a .NET Framework.

Podpora Dockeru v sadě Visual Studio se v reakci na potřeby zákazníků změnila v několika verzích. Existuje několik možností, jak do projektu přidat podporu Dockeru a podporované možnosti se liší podle typu projektu a verze sady Visual Studio. Pokud u některých podporovaných typů projektů chcete jenom kontejner pro jeden projekt bez použití orchestrace, můžete to udělat přidáním podpory Dockeru. Další úrovní je podpora orchestrace kontejnerů, která přidává odpovídající soubory podpory pro konkrétního orchestrátora, který zvolíte.

Když v sadě Visual Studio 2022 verze 17.9 a novějším přidáte podporu Dockeru do projektu .NET 7 nebo novějším, máte dva typy sestavení kontejneru, ze kterých si můžete vybrat pro přidání podpory Dockeru. Můžete přidat soubor Dockerfile a určit, jak se mají sestavit image kontejneru, nebo můžete použít integrovanou podporu kontejneru poskytovanou sadou .NET SDK.

Při výběru orchestrace kontejnerů můžete také se sadou Visual Studio 2022 a novějšími používat Docker Compose nebo Service Fabric jako služby orchestrace kontejnerů.

V sadě Visual Studio 2022 je k dispozici okno Kontejnery , které umožňuje zobrazit spuštěné kontejnery, procházet dostupné image, zobrazovat proměnné prostředí, protokoly a mapování portů, kontrolovat systém souborů, připojit ladicí program nebo otevřít okno terminálu v prostředí kontejneru. Viz Použití okna Kontejnery.

Přidání podpory Dockeru

Když přidáte nebo povolíte podporu Dockeru, Visual Studio do projektu přidá následující:

• soubor Dockerfile
• .dockerignore soubor
• Odkaz na balíček NuGet na Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Soubor Dockerfile, který přidáte, bude vypadat podobně jako následující kód. V tomto příkladu byl projekt pojmenován WebApplication-Dockera zvolili jste kontejnery Linuxu:

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:3.1 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:3.1 AS build
WORKDIR /src
COPY ["WebApplication-Docker/WebApplication-Docker.csproj", "WebApplication-Docker/"]
RUN dotnet restore "WebApplication-Docker/WebApplication-Docker.csproj"
COPY . .
WORKDIR "/src/WebApplication-Docker"
RUN dotnet build "WebApplication-Docker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication-Docker.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication-Docker.dll"]

Přidání podpory Dockeru pomocí typu sestavení kontejneru Dockerfile

Když do projektu .NET 7 nebo novějšího přidáte nebo povolíte podporu Dockeru, sada Visual Studio zobrazí dialogové okno Možnosti generování uživatelského rozhraní kontejneru, které vám umožní zvolit operační systém (Linux nebo Windows), ale také možnost zvolit typ sestavení kontejneru, buď Dockerfile , nebo sadu .NET SDK. Toto dialogové okno se nezobrazuje v projektech rozhraní .NET Framework ani v projektech Azure Functions.

V 17.11 a novějších verzích můžete také zadat distribuci image kontejneru a kontext sestavení Dockeru.

Distribuce image kontejneru určuje, kterou image operačního systému vaše kontejnery používají jako základní image. Tento seznam se změní, pokud jako typ kontejneru přepnete mezi Linuxem a Windows.

K dispozici jsou následující obrázky:

Windows:

• Windows Nano Server (doporučeno, dostupné jenom 8.0 a novější, není přednastavené pro nativní projekty nasazení AOT (Head-of-Time)
• Windows Server Core (k dispozici pouze 8.0 a novější)

Linux:

• Výchozí (Debian, ale značka je 8,0)
• Debian
• Ubuntu
• Chiseled Ubuntu
• Alpine

Kontext sestavení Dockeru určuje složku, která se používá pro sestavení Dockeru. Viz kontext sestavení Dockeru. Výchozí je složka řešení, která se důrazně doporučuje. Všechny soubory potřebné pro sestavení musí být v této složce, což obvykle neplatí, pokud zvolíte složku projektu nebo jinou složku.

Pokud zvolíte Soubor Dockerfile, Visual Studio do projektu přidá následující:

• soubor Dockerfile
• soubor .dockerignore
• Odkaz na balíček NuGet na Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Soubor Dockerfile, který přidáte, bude vypadat podobně jako následující kód. V tomto příkladu byl projekt pojmenován WebApplication-Dockera zvolili jste kontejnery Linuxu:

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApplication-Docker/WebApplication-Docker.csproj", "WebApplication-Docker/"]
RUN dotnet restore "WebApplication-Docker/WebApplication-Docker.csproj"
COPY . .
WORKDIR "/src/WebApplication-Docker"
RUN dotnet build "WebApplication-Docker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication-Docker.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication-Docker.dll"]

Kontejnerizace aplikace .NET bez souboru Dockerfile

S nainstalovanou sadou Visual Studio 2022 17.9 a novější se sadou .NET 7 SDK v projektech ASP.NET Core, které cílí na .NET 6 nebo novější, máte možnost použít integrovanou podporu sady .NET SDK pro sestavení kontejnerů, což znamená, že nepotřebujete soubor Dockerfile; viz Kontejnerizace aplikace .NET s publikováním dotnet. Místo toho nakonfigurujete kontejnery pomocí vlastností NÁSTROJE MSBuild v souboru projektu a nastavení pro spuštění kontejnerů pomocí sady Visual Studio se zakóduje do konfiguračního .json souboru launchSettings.json.

V této části zvolte jako typ sestavení kontejneru sadu .NET SDK , abyste místo souboru Dockerfile používali správu kontejnerů sady .NET SDK.

Distribuce image kontejneru určuje, kterou image operačního systému vaše kontejnery používají jako základní image. Tento seznam se změní, pokud jako kontejner přepnete mezi Linuxem a Windows. Seznam dostupných imagí najdete v předchozí části.

Položka sestavení kontejneru .NET SDK v launchSettings.json vypadá jako následující kód:

"Container (.NET SDK)": {
  "commandName": "SdkContainer",
  "launchBrowser": true,
  "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
  "environmentVariables": {
    "ASPNETCORE_HTTPS_PORTS": "8081",
    "ASPNETCORE_HTTP_PORTS": "8080"
  },
  "publishAllPorts": true,
  "useSSL": true
}

Sada .NET SDK spravuje některá nastavení, která by byla zakódována v souboru Dockerfile, jako je základní image kontejneru, a proměnné prostředí, které se mají nastavit. Nastavení dostupná v souboru projektu pro konfiguraci kontejneru jsou uvedená v části Přizpůsobení kontejneru. Například distribuce image kontejneru je uložena v souboru projektu jako ContainerBaseImage vlastnost. Soubor projektu můžete později změnit úpravou souboru projektu.

<PropertyGroup>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/runtime:8.0-alpine-amd64</ContainerBaseImage>
</PropertyGroup>