[Ubuntu, Windows] Docker Compose v1 will be removed from images on July, 29

[mikhailkoliada]

Breaking changes

Docker compose v1 will be removed from Ubuntu & Windows images.

Target date

The images rollout process will start on July, 29 and take 3-4 days.

The motivation for the changes

Docker compose v1 has been deprecated since July 2023 and customers are encouraged to migrate to v2, apart from that, as per our support policy it has been more that 6 months since the deprecation announcement so we would like to finally remove it. More information can also be found on the GitHub blog.

Possible impact

If your pipelines or workflows still depend on docker compose v1 they might be broken.

Platforms affected

• Azure DevOps
• GitHub Actions

Runner images affected

• Ubuntu 20.04
• Ubuntu 22.04
• macOS 11
• macOS 12
• macOS 13
• macOS 13 Arm64
• macOS 14
• macOS 14 Arm64
• Windows Server 2019
• Windows Server 2022

Mitigation ways

The last release of the v1 branch is still available on GitHub and can be downloaded and installed manually in runtime for both Ubuntu and Windows.

[daveisfera]

I understand removing it from new images (like the Ubuntu 24.04 one that was just released), but why remove it from existing images?
That means that if I make a branch from an old tag to release a bug fix that I have to also worry about patching this as well?

[Alexey-Ayupov]

The removal of Docker Compose v1 is postponed till 29 of July.

[ShaharM7]

@Alexey-Ayupov
My workaround for that on **Azure DevOps Pipelines ** is to pass the path of the docker-compose plugin (of course before it needs to install it on the Agents - in my case, it is Redhat 8 machines):

And the variable: $(docker_compose_exe_path) is - an example:

  - job: start_application_and_testing_for
    displayName: "Run E2E Tests For - "
    variables:
      - name: docker_compose_exe_path
        value: '/usr/libexec/docker/cli-plugins/docker-compose'`

    - task: DockerCompose@0
      displayName: 'Build Service Images'
      inputs:
        action: Build services
        dockerComposeFile: $(docker_compose_file_path)
        dockerComposePath: $(docker_compose_exe_path)
        detached: true
        dockerComposeFileArgs: |
          NPM_TOKEN=$(NPM_TOKEN)
          CI_BUILD_ID=$(Build.BuildId)
          AGENT_NAME=$(Agent.Name)

[sandywangkpmg]

@Alexey-Ayupov could you confirm if v2 executable will still be available at this path after the removal of v1? /usr/libexec/docker/cli-plugins/docker-compose

Found out the answer after looking into the source code.

runner-images/images/ubuntu/scripts/build/install-docker.sh

Line 44 in e81c480

install "$binary_path" "/usr/libexec/docker/cli-plugins/docker-$plugin"

runner-images/images/ubuntu/toolsets/toolset-2204.json

Line 250 in e81c480

"plugin": "compose",

[Nichebiche]

Breaking changes

Docker compose v1 will be removed from Ubuntu & Windows images.

Target date

The images rollout process will start on July, 29 and take 3-4 days.

The motivation for the changes

Docker compose v1 has been deprecated since July 2023 and customers are encouraged to migrate to v2, apart from that, as per our support policy it has been more that 6 months since the deprecation announcement so we would like to finally remove it. More information can also be found on the GitHub blog.

Possible impact

If your pipelines or workflows still depend on docker compose v1 they might be broken.

Platforms affected

• Azure DevOps
• GitHub Actions

Runner images affected

• Ubuntu 20.04
• Ubuntu 22.04
• macOS 11
• macOS 12
• macOS 13
• macOS 13 Arm64
• macOS 14
• macOS 14 Arm64
• Windows Server 2019
• Windows Server 2022

Mitigation ways

The last release of the v1 branch is still available on GitHub and can be downloaded and installed manually in runtime for both Ubuntu and Windows.

Agree