Vlastnosti sestavení Docker Compose

Kromě vlastností, které řídí jednotlivé projekty Dockeru popsané ve vlastnostech sestavení Nástroje kontejneru, můžete také přizpůsobit, jak Visual Studio sestaví projekty Docker Compose nastavením vlastností Docker Compose, které NÁSTROJ MSBuild používá k sestavení vašeho řešení. Můžete také řídit, jak ladicí program sady Visual Studio spouští aplikace Docker Compose nastavením popisků souborů v konfiguračních souborech Docker Compose.

Jak nastavit vlastnosti nástroje MSBuild

Chcete-li nastavit hodnotu vlastnosti, upravte soubor projektu. U vlastností Docker Compose je tento soubor projektu s příponou .dcproj , pokud není v tabulce v další části uvedeno jinak. Předpokládejme například, že chcete zadat, aby se při spuštění ladění spustil prohlížeč. Vlastnost v .dcproj souboru projektu můžete nastavit DockerLaunchAction následujícím způsobem.

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

Nastavení vlastnosti můžete přidat do existujícího PropertyGroup elementu nebo pokud neexistuje, vytvořte nový PropertyGroup prvek.

Vlastnosti nástroje MSBuild pro Docker Compose

V následující tabulce jsou uvedeny vlastnosti NÁSTROJE MSBuild dostupné pro projekty Docker Compose.

Příklad

Pokud změníte umístění docker-compose souborů tak, že nastavíte DockerComposeBaseFilePath relativní cestu, musíte se také ujistit, že je kontext sestavení změněn tak, aby odkaz na složku řešení. Pokud je například soubor docker-compose složkou s názvem DockerComposeFiles, měl by soubor Docker Compose nastavit kontext sestavení na "." nebo ".. /..", v závislosti na tom, kde je relativní ke složce řešení.

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

Soubor mydockercompose.yml by měl vypadat takto, s kontextem sestavení nastaveným na relativní cestu ke složce řešení (v tomto případě ..).

version: '3.4'

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

Přepsání konfigurace Docker Compose sady Visual Studio

Obvykle se docker-compose.override.yml používá k přepsání určitých nastavení v docker-compose.yml. Visual Studio navíc generuje přepsání souborů docker-compose.vs.debug.g.yml (pro rychlý režim) a docker-compose.vs.release.g.yml (pro běžné režimy) s nastavením, která jsou specifická pro spuštění aplikace v sadě Visual Studio. Tato nastavení sady Visual Studio můžete přepsat umístěním souboru s názvem docker-compose.vs.debug.yml (pro rychlý režim) nebo docker-compose.vs.release.yml (pro běžný režim) do stejného adresáře jako soubor docker-compose.yml . Klikněte pravým tlačítkem na projekt Docker Compose a vyberte Otevřít složku v Průzkumník souborů a pak pomocí příkazu Přidat>existující položku přidejte soubor do projektu Docker Compose.

Popisky souborů Docker Compose

V docker-compose.vs.debug.yml nebo docker-compose.vs.release.yml můžete definovat popisky specifické pro přepsání následujícím způsobem:

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

Použijte dvojité uvozovky kolem hodnot, jako v předchozím příkladu, a použijte zpětné lomítko jako řídicí znak pro zpětné lomítka v cestách.

Přizpůsobení procesu sestavení Dockeru

Můžete deklarovat, která fáze se má sestavit v souboru Dockerfile pomocí target nastavení ve build vlastnosti. Toto přepsání lze použít pouze v docker-compose.vs.debug.yml nebo docker-compose.vs.release.yml

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

Přizpůsobení procesu spuštění aplikace

Před spuštěním aplikace můžete spustit příkaz nebo vlastní skript pomocí entrypoint nastavení a nastavit ho jako závislý na objektu DockerDevelopmentMode. Pokud například potřebujete nastavit certifikát pouze v rychlém režimu spuštěním update-ca-certificates, ale ne v normálním režimu, můžete do docker-compose.vs.debug.yml přidat následující kód:

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

Další informace najdete v tématu Vstupní bod kontejneru.

Další kroky

Obecné informace o vlastnostech nástroje MSBuild naleznete v tématu Vlastnosti nástroje MSBuild.

Viz také

Vlastnosti sestavení Nástroje kontejneru

Nastavení spuštění nástroje kontejneru

Správa spouštěcích profilů pro Docker Compose v sadě Visual Studio

Rezervované a dobře známé vlastnosti nástroje MSBuild