Strumenti contenitore di Visual Studio per Docker

Prerequisiti

• Docker Desktop
• Visual Studio 2019 con il carico di lavoro Sviluppo Web, Strumenti di Azure e/o Sviluppo multipiattaforma .NET Core installato
• Strumenti di sviluppo .NET Core per lo sviluppo con .NET Core.
• Per pubblicare in Registro Azure Container, una sottoscrizione di Azure. registrarsi per la versione di prova gratuita.

Supporto di Docker in Visual Studio

Il supporto di Docker è disponibile per i progetti ASP.NET, i progetti ASP.NET Core e i progetti di console .NET Core e .NET Framework.

Il supporto per Docker in Visual Studio è cambiato nel corso di varie versioni in risposta alle esigenze dei clienti. Esistono due livelli di supporto di Docker che è possibile aggiungere a un progetto e le opzioni supportate variano a seconda del tipo di progetto e della versione di Visual Studio. Con alcuni tipi di progetto supportati, se si vuole semplicemente un contenitore per un singolo progetto, senza usare l'orchestrazione, è possibile farlo aggiungendo il supporto di Docker. Il livello successivo è rappresentato dal supporto dell'orchestrazione dei contenitori, che aggiunge i file di supporto appropriati per lo specifico agente di orchestrazione scelto.

Con Visual Studio 2019 è possibile usare Docker Compose, Kubernetes e Service Fabric come servizi di orchestrazione dei contenitori.

In Visual Studio 2019 versione 16.4 e successive è disponibile la finestra Contenitori, che consente di visualizzare i contenitori in esecuzione, esplorare le immagini disponibili, visualizzare le variabili di ambiente, i log e i mapping delle porte, controllare il file system, collegare un debugger o aprire una finestra del terminale all'interno dell'ambiente contenitore. Vedere Usare la finestra Contenitori.

Prerequisiti

• Docker Desktop
• Visual Studio 2022 con il carico di lavoro Sviluppo Web, Strumenti di Azure e/o Sviluppo desktop .NET installato
• Per pubblicare in Registro Azure Container, una sottoscrizione di Azure. registrarsi per la versione di prova gratuita.

Supporto di Docker in Visual Studio

Il supporto di Docker è disponibile per i progetti ASP.NET, i progetti ASP.NET Core e i progetti di console .NET Core e .NET Framework.

Il supporto per Docker in Visual Studio è cambiato nel corso di varie versioni in risposta alle esigenze dei clienti. Sono disponibili diverse opzioni per aggiungere il supporto Docker a un progetto e le opzioni supportate variano in base al tipo di progetto e alla versione di Visual Studio. Con alcuni tipi di progetto supportati, se si vuole semplicemente un contenitore per un singolo progetto, senza usare l'orchestrazione, è possibile farlo aggiungendo il supporto di Docker. Il livello successivo è rappresentato dal supporto dell'orchestrazione dei contenitori, che aggiunge i file di supporto appropriati per lo specifico agente di orchestrazione scelto.

Con Visual Studio 2022 versione 17.9 e successive, quando si aggiunge il supporto Docker a un progetto .NET 7 o versione successiva, sono disponibili due tipi di compilazione del contenitore tra cui scegliere per l'aggiunta del supporto docker. È possibile scegliere di aggiungere un Dockerfile per specificare come compilare le immagini del contenitore oppure scegliere di usare il supporto predefinito del contenitore fornito da .NET SDK.

Inoltre, con Visual Studio 2022 e versioni successive, quando si sceglie l'orchestrazione dei contenitori, è possibile usare Docker Compose o Service Fabric come servizi di orchestrazione dei contenitori.

In Visual Studio 2022 è disponibile la finestra Contenitori , che consente di visualizzare i contenitori in esecuzione, esplorare le immagini disponibili, visualizzare le variabili di ambiente, i log e i mapping delle porte, controllare il file system, collegare un debugger o aprire una finestra del terminale all'interno dell'ambiente contenitore. Vedere Usare la finestra Contenitori.

Aggiungere il supporto di Docker

Quando si aggiunge o si abilita il supporto di Docker, Visual Studio aggiunge quanto segue al progetto:

• Un file Dockerfile
• un .dockerignore file
• Un riferimento al pacchetto NuGet per Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Il Dockerfile aggiunto sarà simile al codice seguente. In questo esempio il progetto è stato denominato WebApplication-Dockere sono stati scelti contenitori Linux:

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

Aggiungere il supporto docker usando il tipo di compilazione del contenitore Dockerfile

Quando si aggiunge o si abilita il supporto Docker a un progetto .NET 7 o versione successiva, Visual Studio visualizza la finestra di dialogo Opzioni di scaffolding dei contenitori, che offre la scelta del sistema operativo (Linux o Windows), ma anche la possibilità di scegliere il tipo di compilazione del contenitore, Dockerfile o .NET SDK. Questa finestra di dialogo non viene visualizzata nei progetti .NET Framework o nei progetti Funzioni di Azure.

Nella versione 17.11 e successive è anche possibile specificare la distribuzione dell'immagine del contenitore e il contesto di compilazione Docker.

Distribuzione immagine contenitore specifica l'immagine del sistema operativo usata dai contenitori come immagine di base. Questo elenco cambia se si passa da Linux a Windows come tipo di contenitore.

Sono disponibili le immagini seguenti:

Windows:

• Windows Nano Server (consigliato, disponibile solo 8.0 e versioni successive, non preimpostato per i progetti di distribuzione AOT (Native Ahead-of-Time)
• Windows Server Core (disponibile solo 8.0 e versioni successive)

Linux:

• Predefinito (Debian, ma il tag è "8.0")
• Debian
• Ubuntu
• Ubuntu cesellato
• Alpine

Docker Build Context specifica la cartella usata per la compilazione Docker. Vedere Contesto di compilazione docker. Il valore predefinito è la cartella della soluzione, consigliata. Tutti i file necessari per una compilazione devono trovarsi in questa cartella, che in genere non è il caso se si sceglie la cartella del progetto o un'altra cartella.

Se si sceglie Dockerfile, Visual Studio aggiunge quanto segue al progetto:

• Un file Dockerfile
• Un file con estensione dockerignore
• Un riferimento al pacchetto NuGet per Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Il Dockerfile aggiunto sarà simile al codice seguente. In questo esempio il progetto è stato denominato WebApplication-Dockere sono stati scelti contenitori Linux:

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

Inserire in un contenitore un'app .NET senza un Dockerfile

Con Visual Studio 2022 17.9 e versioni successive con .NET 7 SDK installato, nei progetti ASP.NET Core destinati a .NET 6 o versione successiva, è possibile usare il supporto predefinito di .NET SDK per le compilazioni di contenitori, il che significa che non è necessario un Dockerfile; vedere Containerize a .NET app with dotnet publish (Containerize a .NET app with dotnet publish). I contenitori vengono invece configurati usando le proprietà MSBuild nel file di progetto e le impostazioni per l'avvio dei contenitori con Visual Studio vengono codificate in un .json file di configurazione launchSettings.json.

In questo caso, scegliere .NET SDK come tipo di compilazione del contenitore per usare la gestione dei contenitori di .NET SDK anziché un Dockerfile.

Distribuzione immagine contenitore specifica l'immagine del sistema operativo usata dai contenitori come immagine di base. Questo elenco cambia se si passa da Linux a Windows come contenitore. Per un elenco delle immagini disponibili, vedere la sezione precedente.

La voce di compilazione del contenitore .NET SDK in launchSettings.json è simile al codice seguente:

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

.NET SDK gestisce alcune delle impostazioni che sarebbero state codificate in un Dockerfile, ad esempio l'immagine di base del contenitore e le variabili di ambiente da impostare. Le impostazioni disponibili nel file di progetto per la configurazione del contenitore sono elencate in Personalizzazione del contenitore. Ad esempio, la distribuzione dell'immagine contenitore viene salvata nel file di progetto come ContainerBaseImage proprietà . È possibile modificarlo in un secondo momento modificando il file di progetto.

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