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ü yüklü Visual Studio 2019
• .NET Core ile geliştirme için .NET Core Geliştirme Araçları .
• Bir Azure aboneliği olan Azure Container Registry'de yayımlamak için. Ü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
• Web Geliştirme, Azure Araçları iş yükü ve/veya .NET masaüstü geliştirme iş yükü yüklü Visual Studio 2022
• Bir Azure aboneliği olan Azure Container Registry'de yayımlamak için. Ü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:

• Dockerfile dosyası
• dosya .dockerignore
• Microsoft.VisualStudio.Azure.Containers.Tools.Targets için NuGet paketi başvurusu

Eklediğiniz Dockerfile aşağıdaki koda benzer. Bu örnekte proje olarak adlandırılmıştır WebApplication-Dockerve 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

Bir .NET 7 veya sonraki bir projeye Docker desteği eklediğinizde veya etkinleştirdiğinizde, Visual Studio size işletim sistemi (Linux veya Windows) seçeneği sunan Kapsayıcı yapı iskelesi seçenekleri iletişim kutusunu, aynı zamanda Dockerfile veya .NET SDK'sı gibi kapsayıcı derleme türünü seçme olanağını gösterir. Bu iletişim kutusu .NET Framework projelerinde veya Azure İşlevleri projelerinde görünmez.

17.11 ve sonraki sürümlerde Kapsayıcı Görüntüsü Dağıtımı ve Docker Derleme Bağlamı'nı da belirtebilirsiniz.

Kapsayıcı Görüntüsü Dağıtımı , 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 sürümlerde 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
• Keskili Ubuntu
• Alpine

Docker Derleme Bağlamı , Docker derlemesi için kullanılan klasörü belirtir. Bkz. 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.

Dockerfile'ı seçerseniz Visual Studio aşağıdakini projeye ekler:

• Dockerfile dosyası
• .dockerignore dosyası
• Microsoft.VisualStudio.Azure.Containers.Tools.Targets için NuGet paketi başvurusu

Eklediğiniz Dockerfile aşağıdaki koda benzer. Bu örnekte proje olarak adlandırılmıştır WebApplication-Dockerve 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 publish ile 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ı launchSettings.json bir .json 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'yı seçin.

Kapsayıcı Görüntüsü Dağıtımı , 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'daki .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ındaki kullanılabilir ayarlar Kapsayıcınızı özelleştirme bölümünde listelenir. Örneğin, Container Image Distro özelliği olarak ContainerBaseImage proje dosyasına kaydedilir. Daha sonra proje dosyasını düzenleyerek değiştirebilirsiniz.

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