Visual Studio Konténer Eszközök Dockerhez

Előfeltételek

• Docker Desktop
• Visual Studio 2019 a webfejlesztési, Azure Tools számítási feladattal és/vagy telepített .NET Core platformfüggetlen fejlesztési számítási feladattal
• .NET Core fejlesztői eszközök a .NET Core-val való fejlesztéshez.
• Azure-előfizetés az Azure Container Registryben való közzétételhez. Regisztráljon ingyenes próbaidőszakra.

Docker-támogatás a Visual Studióban

A Docker-támogatás ASP.NET projektekhez, ASP.NET Core-projektekhez, valamint .NET Core- és .NET-keretrendszer-konzolprojektekhez érhető el.

A Docker támogatása a Visual Studióban több kiadásban is megváltozott az ügyfél igényeinek megfelelően. A Docker-támogatásnak két szintje van, amelyeket hozzáadhat egy projekthez, és a támogatott lehetőségek a projekt típusától és a Visual Studio verziójától függően változnak. Néhány támogatott projekttípus esetén, ha csak egyetlen projekthez szeretne tárolót használni, vezénylés nélkül, ezt a Docker-támogatás hozzáadásával teheti meg. A következő szint a tárolóvezénylés támogatása, amely megfelelő támogatási fájlokat ad hozzá a kiválasztott vezénylőhöz.

A Visual Studio 2019-ben a Docker Compose, a Kubernetes és a Service Fabric tárolóvezénylési szolgáltatásként használható.

A Visual Studio 2019 16.4-es és újabb verzióiban elérhető a Tárolók ablak, amely lehetővé teszi a futó tárolók megtekintését, a rendelkezésre álló képek tallózását, a környezeti változók, naplók és portleképezések megtekintését, a fájlrendszer vizsgálatát, hibakereső csatolását vagy egy terminálablak megnyitását a tárolókörnyezetben. Lásd: Tárolók ablak használata.

Előfeltételek

• Docker Desktop
• Visual Studio 2022 a Web Development, Azure Tools munkaterheléssel és/vagy a .NET asztali fejlesztési munkaterhelés telepítésével
• Azure-előfizetés az Azure Container Registryben való közzétételhez. Regisztráljon ingyenes próbaidőszakra.

Docker-támogatás a Visual Studióban

A Docker-támogatás ASP.NET projektekhez, ASP.NET Core-projektekhez, valamint .NET Core- és .NET-keretrendszer-konzolprojektekhez érhető el.

A Docker támogatása a Visual Studióban több kiadásban is megváltozott az ügyfél igényeinek megfelelően. A Docker-támogatás a projekthez többféleképpen is hozzáadható, és a támogatott lehetőségek a projekt típusától és a Visual Studio verziójától függően változnak. Néhány támogatott projekttípus esetén, ha csak egyetlen projekthez szeretne tárolót használni, vezénylés nélkül, ezt a Docker-támogatás hozzáadásával teheti meg. A következő szint a tárolóvezénylés támogatása, amely megfelelő támogatási fájlokat ad hozzá a kiválasztott vezénylőhöz.

A Visual Studio 2022 17.9-es és újabb verziójával, amikor Docker-támogatást ad hozzá egy .NET 7-es vagy újabb projekthez, két tároló buildtípus közül választhat a Docker-támogatás hozzáadásához. Hozzáadhat egy Dockerfile-t a tárolólemezképek összeállításának módjához, vagy használhatja a .NET SDK által biztosított beépített tárolótámogatást.

A Visual Studio 2022-ben és újabb verzióiban a tárolóvezénylés kiválasztásakor a Docker Compose vagy a Service Fabric is használható tárolóvezénylési szolgáltatásként.

A Visual Studio 2022-ben elérhető a Tárolók ablak, amely lehetővé teszi a tárolók futtatását, a rendelkezésre álló képek tallózását, a környezeti változók, naplók és portleképezések megtekintését, a fájlrendszer vizsgálatát, hibakereső csatolását vagy egy terminálablak megnyitását a tárolókörnyezetben. Lásd: Tárolók ablak használata.

Docker-támogatás hozzáadása

A Docker-támogatás hozzáadásakor vagy engedélyezésekor a Visual Studio a következőket adja hozzá a projekthez:

• egy Dockerfile fájl
• .dockerignore fájl
• NuGet-csomaghivatkozás a Microsoft.VisualStudio.Azure.Containers.Tools.Targets fájlra

A hozzáadott Dockerfile az alábbi kódhoz fog hasonlítni. Ebben a példában a projekt neve WebApplication-Dockervolt, és a Linux-tárolókat választotta:

#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"]

Docker-támogatás hozzáadása a Dockerfile-tároló buildtípusával

Ha a Docker-támogatást egy .NET 7-es vagy újabb projekthez adja hozzá vagy engedélyezi, a Visual Studio megjeleníti a Tárolóállványozási beállítások párbeszédpanelt, amely lehetővé teszi az operációs rendszer (Linux vagy Windows) kiválasztását, de a tároló buildtípusának kiválasztását is, Dockerfile vagy .NET SDK. Ez a párbeszédpanel nem jelenik meg a .NET-keretrendszer-projektekben vagy az Azure Functions-projektekben.

A 17.11-es és újabb verziókban megadhatja a konténerképfelosztást és a Docker építési környezetet.

Tárolórendszerkép-disztribúció határozza meg, hogy a tárolók melyik operációsrendszer-lemezképet használják alaprendszerképként. Ez a lista akkor változik, ha a Linux és a Windows között vált tárolótípusként.

A következő képek érhetők el:

Windows:

• Windows Nano Server (ajánlott, csak a 8.0-s és újabb verziókban érhető el, nincs előre beállítva natív előzetes (AOT) üzembe helyezési-projektekhez)
• Windows Server Core (csak a 8.0-s és újabb verziókban érhető el)

Linux:

• Alapértelmezett (Debian, de a címke "8.0")
• Debian
• Ubuntu
• Vésett Ubuntu
• Alpesi

Docker buildkörnyezet a Docker-buildhez használt mappát adja meg. Lásd: Docker build-környezet. Az alapértelmezett a megoldásmappa, amely erősen ajánlott. A buildhez szükséges összes fájlnak ebben a mappában kell lennie, ami általában nem így van, ha a projektmappát vagy más mappát választja.

Ha Dockerfileválaszt, a Visual Studio a következőket adja hozzá a projekthez:

• egy Dockerfile fájl
• .dockerignore fájl
• NuGet-csomaghivatkozás a Microsoft.VisualStudio.Azure.Containers.Tools.Targets fájlra

A hozzáadott Dockerfile az alábbi kódhoz fog hasonlítni. Ebben a példában a projekt neve WebApplication-Dockervolt, és a Linux-tárolókat választotta:

#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"]

.NET-alkalmazás tárolóba helyezése Dockerfile nélkül

A Visual Studio 2022 17.9 és az újabb verziókban, amikor a .NET 7 SDK telepítve van, az ASP.NET Core-projektekben, amelyek a .NET 6 vagy annál újabb verziót céloznak meg, lehetősége van a .NET SDK beépített támogatását használni a tároló build-ekhez, ami azt jelenti, hogy nincs szükség Dockerfile-ra; lásd egy .NET-alkalmazás tárolóba helyezése a dotnet publishsegítségével. Ehelyett az MSBuild tulajdonságok használatával konfigurálja a tárolókat a projektfájlban, és a tárolók Visual Studióval való elindításának beállításai egy .json konfigurációs fájlba vannak kódolva, launchSettings.json.

Itt válassza .NET SDK tároló buildtípusként, hogy a .NET SDK tárolókezelését használja Dockerfile helyett.

Tárolórendszerkép-disztribúció határozza meg, hogy a tárolók melyik operációsrendszer-lemezképet használják alaprendszerképként. Ez a lista akkor változik, ha a tárolóként használt rendszert Linuxról Windowsra vagy fordítva váltja. Az elérhető képek listáját az előző szakaszban találja.

A .NET SDK-tároló buildbejegyzése launchSettings.json a következő kódhoz hasonlóan néz ki:

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

A .NET SDK kezeli a Dockerfile-ban kódolt beállítások némelyikét, például a tároló alaprendszerképét és a beállítandó környezeti változókat. A tárolókonfiguráció projektfájljában elérhető beállítások A tárolótestreszabása című témakörben találhatók. A konténer képelosztás például a ContainerBaseImage tulajdonságként mentésre kerül a projektfájlban. Később módosíthatja a projektfájl szerkesztésével.

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