Docker Compose derleme özellikleri

Kapsayıcı Araçları derleme özellikleri bölümünde açıklanan tek tek Docker projelerini denetleyen özelliklere ek olarak, MSBuild'in çözümünüzü derlemek için kullandığı Docker Compose özelliklerini ayarlayarak Visual Studio'nın Docker Compose projelerinizi nasıl derlediğini de özelleştirebilirsiniz. Ayrıca, Docker Compose yapılandırma dosyalarında dosya etiketleri ayarlayarak Visual Studio hata ayıklayıcının Docker Compose uygulamalarınızı nasıl çalıştırabileceğini denetleyebilirsiniz.

MSBuild özelliklerini ayarlama

Bir özelliğin değerini ayarlamak için proje dosyasını düzenleyin. Docker Compose özellikleri için, sonraki bölümde tabloda aksi belirtilmediği sürece bu proje dosyası uzantısı olan dosyadır .dcproj . Örneğin, hata ayıklamaya başladığınızda tarayıcının başlatılmasını belirtmek istediğinizi varsayalım. Proje .dcproj dosyasında özelliğini DockerLaunchAction aşağıdaki gibi ayarlayabilirsiniz.

<PropertyGroup>
   <DockerLaunchAction>LaunchBrowser</DockerLaunchAction>
</PropertyGroup>

Özellik ayarını var olan PropertyGroup bir öğeye ekleyebilir veya yoksa yeni PropertyGroup bir öğe oluşturabilirsiniz.

Docker Compose MSBuild özellikleri

Aşağıdaki tabloda Docker Compose projeleri için kullanılabilen MSBuild özellikleri gösterilmektedir.

Örnek

Dosyaların konumunu docker-compose göreli bir yola ayarlayarak DockerComposeBaseFilePath değiştirirseniz, derleme bağlamının çözüm klasörüne başvuracak şekilde değiştirildiğinden de emin olmanız gerekir. Örneğin, dosyanız docker-compose DockerComposeFiles adlı bir klasörse Docker Compose dosyası derleme bağlamını ".." veya ".. olarak ayarlamalıdır. /..", çözüm klasörüne göre konumuna bağlı olarak.

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" Sdk="Microsoft.Docker.Sdk">
  <PropertyGroup Label="Globals">
    <ProjectVersion>2.1</ProjectVersion>
    <DockerTargetOS>Windows</DockerTargetOS>
    <ProjectGuid>154022c1-8014-4e9d-bd78-6ff46670ffa4</ProjectGuid>
    <DockerLaunchAction>LaunchBrowser</DockerLaunchAction>
    <DockerServiceUrl>{Scheme}://{ServiceIPAddress}{ServicePort}</DockerServiceUrl>
    <DockerServiceName>webapplication1</DockerServiceName>
    <DockerComposeBaseFilePath>DockerComposeFiles\mydockercompose</DockerComposeBaseFilePath>
    <AdditionalComposeFilePaths>AdditionalComposeFiles\myadditionalcompose.yml</AdditionalComposeFilePaths>
  </PropertyGroup>
  <ItemGroup>
    <None Include="DockerComposeFiles\mydockercompose.override.yml">
      <DependentUpon>DockerComposeFiles\mydockercompose.yml</DependentUpon>
    </None>
    <None Include="DockerComposeFiles\mydockercompose.yml" />
    <None Include=".dockerignore" />
  </ItemGroup>
</Project>

mydockercompose.yml dosyası, derleme bağlamı çözüm klasörünün göreli yoluna ayarlanmış olarak şöyle görünmelidir (bu örnekte). ..

version: '3.4'

services:
  webapplication1:
    image: ${DOCKER_REGISTRY-}webapplication1
    build:
      context: ..
      dockerfile: WebApplication1\Dockerfile

Visual Studio'nun Docker Compose yapılandırmasını geçersiz kılma

genellikle docker-compose.override.yml, docker-compose.yml bazı ayarları geçersiz kılmak için kullanılır. Ayrıca Visual Studio, uygulamayı Visual Studio'da çalıştırmaya özgü ayarlarla docker-compose.vs.debug.g.yml (Hızlı mod için) ve docker-compose.vs.release.g.yml (Normal mod için) dosyaları geçersiz kılma dosyaları oluşturur. docker-compose.yml dosyanızla aynı dizine docker-compose.vs.debug.yml (Hızlı mod için) veya docker-compose.vs.release.yml (Normal mod için) adlı bir dosya yerleştirerek bu Visual Studio ayarlarını geçersiz kılabilirsiniz. Docker Compose projesine sağ tıklayın ve Dosya Gezgini Klasör Aç'ı seçin, ardından Dosyayı Docker Compose projenize eklemek için Varolan ÖğeYi Ekle'yi>kullanın.

Docker Compose dosya etiketleri

docker-compose.vs.debug.yml veya docker-compose.vs.release.yml geçersiz kılmaya özgü etiketleri aşağıdaki gibi tanımlayabilirsiniz:

services:
  webapplication1:
    labels:
      com.microsoft.visualstudio.debuggee.workingdirectory: "C:\\my_app_folder"

Önceki örnekte olduğu gibi değerlerin çevresinde çift tırnak işareti kullanın ve yollardaki ters eğik çizgilerde kaçış karakteri olarak ters eğik çizgiyi kullanın.

Docker derleme işlemini özelleştirme

Özelliğindeki ayarını kullanarak Dockerfile'ınızda hangi aşamanın derleneceklerini target build bildirebilirsiniz. Bu geçersiz kılma yalnızca docker-compose.vs.debug.yml veya docker-compose.vs.release.yml kullanılabilir

services:
  webapplication1:
    build:
      target: customStage
    labels:
      ...

Uygulama başlatma işlemini özelleştirme

Ayarı kullanarak entrypoint uygulamanızı başlatmadan önce bir komut veya özel betik çalıştırabilir ve bunu öğesine bağımlı DockerDevelopmentModehale getirebilirsiniz. Örneğin, bir sertifikayı yalnızca Hızlı modda, ancak Normal modda çalıştırarak update-ca-certificatesayarlamanız gerekiyorsa, aşağıdaki kodu yalnızca docker-compose.vs.debug.yml ekleyebilirsiniz:

services:
  webapplication1:
    entrypoint: "sh -c 'update-ca-certificates && tail -f /dev/null'"
    labels:
      ...

Daha fazla bilgi için bkz. Kapsayıcı giriş noktası

Sonraki adımlar

MSBuild özellikleri hakkında genel bilgi için bkz . MSBuild Özellikleri.

Ayrıca bkz.

Kapsayıcı Araçları derleme özellikleri

Kapsayıcı Araçları başlatma ayarları

Visual Studio'da Docker Compose için başlatma profillerini yönetme

MSBuild ayrılmış ve iyi bilinen özellikler