Egenskaper för Docker Compose-kompilering

Förutom de egenskaper som styr enskilda Docker-projekt, som beskrivs i Container Tools-byggegenskaper, kan du också anpassa hur Visual Studio skapar dina Docker Compose-projekt genom att ange de Docker Compose-egenskaper som MSBuild använder för att skapa din lösning. Du kan också styra hur Visual Studio-felsökningsprogrammet kör dina Docker Compose-appar genom att ange filetiketter i Docker Compose-konfigurationsfiler.

Så här ställer du in MSBuild-egenskaperna

Om du vill ange värdet för en egenskap redigerar du projektfilen. För Docker Compose-egenskaper är den här projektfilen den med ett .dcproj-tillägg, om inget annat anges i tabellen i nästa avsnitt. Anta till exempel att du vill ange att webbläsaren ska startas när du börjar felsöka. Du kan ange egenskapen DockerLaunchAction i .dcproj-projektfilen på följande sätt.

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

Du kan lägga till egenskapsinställningen i ett befintligt PropertyGroup-element eller, om det inte finns något, skapa ett nytt PropertyGroup element.

Egenskaper för Docker Compose MSBuild

I följande tabell visas de MSBuild-egenskaper som är tillgängliga för Docker Compose-projekt (.dcproj-filer).

Dessutom anger egenskapen DockerComposeProjectPath i en .csproj- eller .vbproj-projektfil den relativa sökvägen till Docker Compose-projektet (.dcproj) filen. Ange den här egenskapen när du publicerar tjänstprojektet för att hitta de associerade avbildningsversionsinställningarna som lagras i filen docker-compose.yml.

Exempel

Om du ändrar platsen för docker-compose filer genom att ange DockerComposeBaseFilePath till en relativ sökväg måste du också se till att byggkontexten ändras så att den refererar till lösningsmappen. Om din docker-compose-fil till exempel är en mapp med namnet DockerComposeFilesska Docker Compose-filen ange byggkontexten till ".." eller ".. /..", beroende på var den är relativ till lösningsmappen.

<?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>

Den mydockercompose.yml filen bör se ut så här, med byggkontexten inställd på den relativa sökvägen för lösningsmappen (i det här fallet ..).

version: '3.4'

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

Åsidosätta Visual Studios Docker Compose-konfiguration

Vanligtvis används docker-compose.override.yml för att åsidosätta vissa inställningar i docker-compose.yml. Visual Studio genererar dessutom åsidosättningsfiler docker-compose.vs.debug.g.yml (för snabbt-läge) och docker-compose.vs.release.g.yml filer (för regelbundet läge) med inställningar som är specifika för att köra programmet i Visual Studio. Du kan åsidosätta dessa Visual Studio-inställningar genom att placera en fil med namnet docker-compose.vs.debug.yml (för läget Snabb) eller docker-compose.vs.release.yml (för normal läge) i samma katalog som din docker-compose.yml fil. Högerklicka på Docker Compose-projektet och välj Öppna mapp i Utforskaren och använd sedan Lägg till>befintligt objekt för att lägga till filen i Docker Compose-projektet.

Docker Compose-filetiketter

I docker-compose.vs.debug.yml eller docker-compose.vs.release.ymlkan du definiera åsidosättningsspecifika etiketter på följande sätt:

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

Använd dubbla citattecken runt värdena, som i föregående exempel, och använd omvänt snedstreck som ett escape-tecken för omvänt snedstreck i sökvägar.

Anpassa Docker-byggprocessen

Du kan deklarera vilken fas som ska skapas i Dockerfile med hjälp av inställningen target i egenskapen build. Den här åsidosättningen kan endast användas i docker-compose.vs.debug.yml eller docker-compose.vs.release.yml

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

Anpassa appstartprocessen

Du kan köra ett kommando eller ett anpassat skript innan du startar appen med hjälp av inställningen entrypoint och göra den beroende av DockerDevelopmentMode. Om du till exempel bara behöver konfigurera ett certifikat i läge för snabb genom att köra update-ca-certificates, men inte i läge för normal, kan du lägga till följande kod i endastdocker-compose.vs.debug.yml:

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

Mer information finns i containerinmatningspunkt

Nästa steg

Mer information om MSBuild-egenskaper finns i MSBuild Properties.

Se även

Container Tools-byggegenskaper

Startinställningar för containerverktyg

Hantera startprofiler för Docker Compose i Visual Studio

reserverade och välkända egenskaper för MSBuild