Docker için Visual Studio Kapsayıcı Araçları

Önkoşullar

• Docker Desktop
• Web Geliştirme, Azure Araçları iş yükü ve/veya .NET Core platformlar arası geliştirme iş yükünün yüklü olduğu visual studio 2019
• .NET Core ile geliştirme için .NET Core Geliştirme Araçları.
• Azure Container Registry'ye yayımlamak için bir Azure aboneliği gereklidir. Ücretsiz deneme için kaydolun.

Visual Studio'da Docker desteği

Docker desteği ASP.NET projeleri, ASP.NET Core projeleri ve .NET Core ve .NET Framework konsol projeleri için kullanılabilir.

Visual Studio'da Docker desteği, müşteri ihtiyaçlarına yanıt olarak bir dizi sürümde değişti. Projeye ekleyebileceğiniz iki Docker desteği düzeyi vardır ve desteklenen seçenekler projenin türüne ve Visual Studio sürümüne göre değişir. Desteklenen bazı proje türlerinde, düzenleme kullanmadan yalnızca tek bir proje için kapsayıcı istiyorsanız, Docker desteği ekleyerek bunu yapabilirsiniz. Sonraki düzey, seçtiğiniz düzenleyici için uygun destek dosyalarını ekleyen kapsayıcı düzenleme desteğidir.

Visual Studio 2019 ile Docker Compose, Kubernetes ve Service Fabric'i kapsayıcı düzenleme hizmetleri olarak kullanabilirsiniz.

Visual Studio 2019 sürüm 16.4 ve sonraki sürümlerinde çalışan kapsayıcıları görüntülemenize, kullanılabilir görüntülere göz atmanıza, ortam değişkenlerini, günlükleri ve bağlantı noktası eşlemelerini görüntülemenize, dosya sistemini incelemenize, hata ayıklayıcı eklemenize veya kapsayıcı ortamının içinde bir terminal penceresi açmanıza olanak tanıyan Kapsayıcılar penceresi kullanılabilir. bkz. Kapsayıcılar penceresini kullanma.

Önkoşullar

• Docker Desktop
• Visual Studio 2022 ile Web Geliştirme, Azure Araçları iş yükü ve/veya .NET masaüstü geliştirme iş yükü yüklü
• Azure Container Registry'ye yayımlamak için bir Azure aboneliği gereklidir. Ücretsiz deneme için kaydolun.

Visual Studio'da Docker desteği

Docker desteği ASP.NET projeleri, ASP.NET Core projeleri ve .NET Core ve .NET Framework konsol projeleri için kullanılabilir.

Visual Studio'da Docker desteği, müşteri ihtiyaçlarına yanıt olarak bir dizi sürümde değişti. Projeye Docker desteği eklemek için çeşitli seçenekler vardır ve desteklenen seçenekler projenin türüne ve Visual Studio sürümüne göre farklılık gösterir. Desteklenen bazı proje türlerinde, düzenleme kullanmadan yalnızca tek bir proje için kapsayıcı istiyorsanız, Docker desteği ekleyerek bunu yapabilirsiniz. Sonraki düzey, seçtiğiniz düzenleyici için uygun destek dosyalarını ekleyen kapsayıcı düzenleme desteğidir.

Visual Studio 2022 sürüm 17.9 ve üzeri ile bir .NET 7 veya sonraki bir projeye Docker desteği eklediğinizde, Docker desteği eklemek için aralarından seçim yapabileceğiniz iki kapsayıcı derleme türü vardır. Kapsayıcı görüntülerinin nasıl derleneceğini belirtmek için bir Dockerfile eklemeyi veya .NET SDK tarafından sağlanan yerleşik kapsayıcı desteğini kullanmayı seçebilirsiniz.

Ayrıca Visual Studio 2022 ve sonraki sürümlerde kapsayıcı düzenlemeyi seçtiğinizde docker Compose veya Service Fabric'i kapsayıcı düzenleme hizmetleri olarak kullanabilirsiniz.

Visual Studio 2022'de çalışan kapsayıcıları görüntülemenize, kullanılabilir görüntülere göz atmanıza, ortam değişkenlerini, günlükleri ve bağlantı noktası eşlemelerini görüntülemenize, dosya sistemini incelemenize, hata ayıklayıcı eklemenize veya kapsayıcı ortamının içinde bir terminal penceresi açmanıza olanak tanıyan Kapsayıcılar penceresi kullanılabilir. bkz. Kapsayıcılar penceresini kullanma.

Docker desteği ekleme

Docker desteğini eklediğinizde veya etkinleştirdiğinizde Visual Studio aşağıdakini projeye ekler:

• bir Dockerfile dosyası
• .dockerignore dosyası
• Microsoft.VisualStudio.Azure.Containers.Tools.Targets için NuGet paketi referansı

Eklediğiniz Dockerfile aşağıdaki koda benzer. Bu örnekte proje WebApplication-Dockerolarak adlandırılmıştır ve Linux kapsayıcılarını seçtiniz:

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

Dockerfile kapsayıcı derleme türünü kullanarak Docker desteği ekleme

Docker desteğini bir .NET 7 veya sonraki bir projeye eklediğinizde veya etkinleştirdiğinizde Visual Studio, Kapsayıcı yapı iskelesi seçenekleri iletişim kutusunu gösterir. Bu iletişim kutusu size işletim sistemi (Linux veya Windows) seçeneği sunar, ayrıca dockerfile veya .NET SDK kapsayıcı derleme türünü seçebilirsiniz. Bu iletişim kutusu .NET Framework projelerinde veya Azure İşlevleri projelerinde görünmez.

17.11 ve üstü sürümlerde, Container Image Distro ve Docker Derleme Bağlamıbelirtebilirsiniz.

Container Image Distro kapsayıcılarınızın temel görüntü olarak hangi işletim sistemi görüntüsünü kullandığını belirtir. Kapsayıcı türü olarak Linux ve Windows arasında geçiş yaptığınızda bu liste değişir.

Aşağıdaki görüntüler kullanılabilir:

Windows:

• Windows Nano Server (önerilen, yalnızca 8.0 ve üzeri kullanılabilir, Önceden Yerel (AOT) dağıtım projeleri için önceden ayarlanmamıştır)
• Windows Server Core (yalnızca 8.0 ve üzeri sürümlerde kullanılabilir)

Linux:

• Varsayılan (Debian, ancak etiket "8.0")
• Debian
• Ubuntu
• İşlenmiş Ubuntu
• Alpine

Docker Derleme Bağlamı Docker derlemesi için kullanılan klasörü belirtir. Bakınız Docker derleme bağlamı. Varsayılan, kesinlikle önerilen çözüm klasörüdür. Bir derleme için gereken tüm dosyaların bu klasörün altında olması gerekir; proje klasörünü veya başka bir klasörü seçerseniz genellikle böyle olmaz.

Dockerfileseçerseniz, Visual Studio aşağıdakini projeye ekler:

• bir Dockerfile dosyası
• .dockerignore dosyası
• Microsoft.VisualStudio.Azure.Containers.Tools.Targets için NuGet paketi referansı

Eklediğiniz Dockerfile aşağıdaki koda benzer. Bu örnekte proje WebApplication-Dockerolarak adlandırılmıştır ve Linux kapsayıcılarını seçtiniz:

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

Dockerfile olmadan bir .NET uygulamasını kapsayıcıya alma

Visual Studio 2022 17.9 ve üzeri .NET 7 SDK yüklüyken, .NET 6 veya üzerini hedefleyen ASP.NET Core projelerinde. Kapsayıcı derlemeleri için .NET SDK'nın yerleşik desteğini kullanma seçeneğiniz vardır; bu da Dockerfile'a ihtiyacınız olmadığı anlamına gelir; bkz. dotnet publishile bir .NET uygulamasını kapsayıcıya alma. Bunun yerine, proje dosyasındaki MSBuild özelliklerini kullanarak kapsayıcılarınızı yapılandırırsınız ve Visual Studio ile kapsayıcıları başlatma ayarları .jsonbir yapılandırma dosyasında kodlanır.

Burada Dockerfile yerine .NET SDK'sının kapsayıcı yönetimini kullanmak için kapsayıcı derleme türü olarak .NET SDK seçin.

Container Image Distro kapsayıcılarınızın temel görüntü olarak hangi işletim sistemi görüntüsünü kullandığını belirtir. Kapsayıcı olarak Linux ve Windows arasında geçiş yaptığınızda bu liste değişir. Kullanılabilir görüntülerin listesi için önceki bölüme bakın.

launchSettings.json içindeki .NET SDK kapsayıcı derleme girdisi aşağıdaki koda benzer:

"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'sı, kapsayıcı temel görüntüsü ve ayarlanacağı ortam değişkenleri gibi dockerfile içinde kodlanmış olabilecek bazı ayarları yönetir. Kapsayıcı yapılandırması için proje dosyasında bulunan ayarlar Kapsayıcınızı özelleştirmealtında listelenir. Örneğin, Kapsayıcı İmaj Dağıtımı proje dosyasına ContainerBaseImage özellik olarak kaydedilir. Daha sonra proje dosyasını düzenleyerek değiştirebilirsiniz.

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

kapsayıcılar penceresinin ekran görüntüsü

kapsayıcılar penceresinin ekran görüntüsü