Launch a subset of Compose services

If you have an application that consists of multiple services and uses Docker Compose, you can configure which services run and debug by creating or editing an existing launch profile in Docker Compose launch settings. Launch profiles allow you to dynamically run only the services that matter to your current scenario. You can create and select from launch profiles in order to customize your debugging experience and set specific launch actions such as Browser Launch URL. You will also have the option of either choosing each service individually or by choosing a Docker Compose profile, which also looks at your Compose file to determine the group of services to run.

For information about Docker Compose profiles, see Using profiles with Compose.

Prerequisites

Manage launch settings

Consider the following Docker Compose project in which the docker-compose.yml has five services and three Compose profiles (web, web1 and web2).

version: '3.9'

services:
  webapplication1:
    image: ${DOCKER_REGISTRY-}webapplication1
    profiles: [web, web1]
    build:
      context: .
      dockerfile: WebApplication1/Dockerfile

  webapplication2:
    image: ${DOCKER_REGISTRY-}webapplication2
    profiles: [web, web2]
    build:
      context: .
      dockerfile: WebApplication2/Dockerfile

  webapplication3:
    image: ${DOCKER_REGISTRY-}webapplication3
    profiles: [web]
    build:
      context: .
      dockerfile: WebApplication3/Dockerfile

  external1:
    image: redis

  external2:
    image: redis

There are a few options to open the Docker Compose launch settings dialog:

• In Visual Studio, choose Debug > Manage Docker Compose Launch Settings:

  

  

• Right-click on the Visual Studio docker-compose project and select Manage Docker Compose Launch Settings

  

  

• Use the Quick Launch (Ctrl+Q) and search for Docker Compose to find the same command.

In the example below, the web1 Compose profile is selected, which filters the Services list to only the three out of five included in that profile:

The next example demonstrates selecting between individual services instead of filtering to the services in a Compose profile. Here, we show how the dialog would look if you created a new launch profile named test2 that only starts two out of the five services, webapplication1 with debugging and webapplication2 without debugging. This launch profile also launches a browser when the application starts and opens it to the home page of webapplication1.

And this information will be saved in launchSettings.json as shown below

{
    "profiles": {
      "test2": {
        "commandName": "DockerCompose",
        "composeLaunchServiceName": "webapplication1",
        "serviceActions": {
          "external1": "DoNotStart",
          "external2": "DoNotStart",
          "webapplication1": "StartDebugging",
          "webapplication2": "StartWithoutDebugging",
          "webapplication3": "DoNotStart"
        },
        "composeLaunchAction": "LaunchBrowser",
        "commandVersion": "1.0",
        "composeLaunchUrl": "{Scheme}://localhost:{ServicePort}"
      }
   }
}

Create a launch profile that uses a Docker Compose profile

You can also further customize launch behaviors by creating Visual Studio launch profiles that make use of the Compose profiles.

To create another profile that makes use of the Compose profile, select Use Docker Compose profiles and choose web1. Now the launch profile includes three services – webapplication1 (which belongs to both web and web1 Compose profiles), external1 and external2. By default, the services without source code such as external1 and external2 have the default action of Start without debugging. .NET applications with source code will default to Start debugging.

This information will be saved as shown in the following code. The configuration for the service and its default action are not saved unless you change the default action.

{
  "profiles": {
    "test1": {
      "commandName": "DockerCompose",
      "composeProfile": {
         "includes": [
            "web1"
         ]
      },
      "commandVersion": "1.0"
    }
  }
}

You can also change the action of webapplication1 to Start without debugging. The settings in launchSettings.json then look like the following code:

{
  "profiles": {
    "test1": {
        "commandName": "DockerCompose",
        "composeProfile": {
          "includes": [
              "web1"
              ],
          "serviceActions": {
              "webapplication1": "StartWithoutDebugging"
          }
        },
    "commandVersion": "1.0"
    }
  }
}

Properties

Here is a description of each property in the launchSettings.json:

Related content

• Visual Studio Container Tools build and debug overview
• Visual Studio Container Tools launch settings
• Docker Compose build settings