Strumenti per i contenitori di Visual Studio per Docker

Prerequisiti

• Docker Desktop
• visual Studio 2019 con il carico di lavoro sviluppo Web, azure Tools e/o carico di lavoro sviluppo multipiattaforma .NET Core installato
• strumenti di sviluppo .NET Core per lo sviluppo con .NET Core.
• Per pubblicare in Azure Container Registry è necessaria una sottoscrizione di Azure. Iscriviti per una prova gratuita.

Supporto di Docker in Visual Studio

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

Il supporto per Docker in Visual Studio è cambiato in diverse versioni in risposta alle esigenze dei clienti. Esistono due livelli di supporto per Docker che è possibile aggiungere 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 solo un contenitore per un singolo progetto, senza usare l'orchestrazione, è possibile farlo aggiungendo il supporto Docker. Il livello successivo è il supporto dell'orchestrazione dei contenitori, che aggiunge i file di supporto appropriati per l'orchestratore specifico che scegli.

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, esaminare il file system, collegare un debugger o aprire una finestra del terminale all'interno dell'ambiente contenitore. Consultare Usare la finestra Contenitori.

Prerequisiti

• Docker Desktop
• Visual Studio 2022 con il carico di lavoro di sviluppo Web, Azure Tools e/o carico di lavoro di sviluppo di applicazioni desktop .NET installato
• Per pubblicare in Azure Container Registry è necessaria una sottoscrizione di Azure. Iscriviti per una prova gratuita.

Supporto di Docker in Visual Studio

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

Il supporto per Docker in Visual Studio è cambiato in diverse 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 solo un contenitore per un singolo progetto, senza usare l'orchestrazione, è possibile farlo aggiungendo il supporto Docker. Il livello successivo è il supporto dell'orchestrazione dei contenitori, che aggiunge i file di supporto appropriati per l'orchestratore specifico che scegli.

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 variabili di ambiente, log e mapping delle porte, esaminare il file system, collegare un debugger o aprire una finestra del terminale all'interno dell'ambiente contenitore. Consultare Usare la finestra Contenitori.

Aggiungere il supporto di Docker

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

• un file Dockerfile
• un file .dockerignore
• Riferimento a un pacchetto NuGet di Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Il Dockerfile aggiunto sarà simile al codice seguente. In questo esempio il progetto è stato denominato WebApplication-Dockered è stato scelto 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 di 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 di 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 dell'immagine del 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:

Finestre:

• Windows Nano Server (consigliato, disponibile solo dalla versione 8.0 e successive, non preimpostato per progetti di distribuzione di compilazione nativa anticipata (AOT))
• Windows Server Core (disponibile solo 8.0 e versioni successive)

Linux:

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

contesto di compilazione Docker specifica la cartella usata per la compilazione Docker. Consulta contesto di compilazione Docker. L'impostazione predefinita è la cartella della soluzione, fortemente raccomandata. 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 .dockerignore
• Riferimento a un pacchetto NuGet di Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Il Dockerfile aggiunto sarà simile al codice seguente. In questo esempio il progetto è stato denominato WebApplication-Dockered è stato scelto 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 Containerizzare un'app .NET con 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 file di configurazione .jsonlaunchSettings.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 dell'immagine del 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 del contenitore viene salvata nel file di progetto come la proprietà ContainerBaseImage. È possibile modificarlo in un secondo momento modificando il file di progetto.

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