docker/compose-bin

compose-bin 镜像说明

镜像特点

该镜像是非可运行的，仅包含 compose 二进制文件。

适用场景

可用于两种场景：

1. 与 docker 官方镜像配合，指定使用特定版本的 Compose（如 nightly build 版本）；
2. 将 Compose 二进制文件嵌入到自定义镜像中。

使用示例

场景 1：配合 docker 官方镜像使用特定版本的 Compose

若需使用特定版本的 Compose（例如 edge 版，即 nightly build 版本），可通过以下 Dockerfile 配置：

dockerfile
# syntax=docker/dockerfile:1
FROM docker  # 基于 docker 官方镜像
# 从 compose-bin:edge 镜像复制二进制文件到 docker CLI 插件目录
COPY --from=docker/compose-bin:edge /docker-compose /usr/libexec/docker/cli-plugins/docker-compose
# 验证版本
RUN docker compose version

说明：通过 --from=docker/compose-bin:<版本标签> 指定 Compose 版本（如 edge 对应 nightly build 版，或具体版本号如 2.20.0），复制后可直接通过 docker compose 命令使用。

场景 2：将 Compose 二进制嵌入自定义镜像

若需在自定义镜像中集成 Compose，可按以下方式配置 Dockerfile：

dockerfile
# syntax=docker/dockerfile:1
FROM my-image  # 基于自定义基础镜像
# 从 compose-bin:2.17.0 镜像复制二进制文件到指定路径
COPY --from=docker/compose-bin:2.17.0 /docker-compose /usr/bin/compose
# 验证版本
RUN compose version

说明：通过指定具体版本标签（如 2.17.0）复制二进制文件到自定义路径（如 /usr/bin/compose），之后可直接在镜像中运行 compose 命令。