tiangolo/docker-with-compose

🚨 弃用警告 🚨

由于https://github.com/docker-library/docker/pull/361，此Docker镜像已不再需要。

您应改用官方https://hub.docker.com/_/docker/。

支持的标签及对应Dockerfile链接

• https://github.com/tiangolo/docker-with-compose/blob/master/Dockerfile

注意：存在https://hub.docker.com/r/tiangolo/docker-with-compose/tags。如需固定使用的Docker镜像版本，可选择此类标签，例如 tiangolo/docker-with-compose:2021-09-17。

Docker with Docker Compose镜像

https://hub.docker.com/_/docker/内置https://github.com/docker/compose，适用于CI环境（已弃用）。

概述

本镜像的主要用途是帮助需要docker二进制文件、docker-compose二进制文件的持续集成环境，还可能需要执行其他小型任务，如运行shell脚本或使用curl通知API。

它包含上述两个程序（docker和docker-compose），并允许运行任意shell脚本（与官方Docker Compose镜像不同）。

无需在docker:latest镜像基础上安装docker-compose，可在云数据中心的每次构建中减少约10-15秒的构建时间。在网络连接不如云服务商的环境中，节省的时间会更多。

GitHub仓库：https://github.com/tiangolo/docker-with-compose

Docker Hub镜像：https://hub.docker.com/r/tiangolo/docker-with-compose/

使用方法

拉取镜像：

console
$ docker pull docker.xuanyuan.run/tiangolo/docker-with-compose

然后运行此镜像的容器时，需将Docker sock挂载为宿主卷。

通过将Docker sock挂载为卷，容器内的docker客户端可直接与主机上的Docker（Docker守护进程/服务）通信。

这样，您可以从容器内部发送Docker命令，如拉取、运行或构建新的Docker镜像。

您可能还需要挂载包含所需文件的宿主卷。

例如，假设有如下Dockerfile：

Dockerfile
FROM docker.xuanyuan.run/nginx

RUN echo "Hello World" > /usr/share/nginx/html/index.html

您可以：

• 挂载包含该Dockerfile的本地目录。
• 挂载本地Docker sock。
• 在运行此镜像的容器内构建Nginx镜像。

console
$ docker run -v $(pwd):/app -v /var/run/docker.sock:/var/run/docker.sock tiangolo/docker-with-compose sh -c "cd /app/ && docker build -t custom-nginx ."

问题描述

存在包含docker二进制文件的官方https://hub.docker.com/_/docker/，以及https://hub.docker.com/r/docker/compose/。

但Docker Compose镜像将docker-compose作为入口点。

因此，无法在该镜像上运行其他命令，如安装软件（例如apt-get install -y curl）。

也无法直接运行docker命令，例如docker login -u ci-user -p $CI_JOB_TOKEN $CI_REGISTRY。

本镜像允许运行任意命令，如shell脚本、docker命令以及Docker Compose命令（如docker-compose build和docker-compose push）。

尽管多个持续集成系统允许在运行实际主脚本前执行前置步骤（如安装软件包），但每次下载和安装Docker Compose会导致构建变慢。

例如，一个简单的GitLab CI文件.gitlab-ci.yml可能如下：

yml
# 不要使用此示例文件
image: docker.xuanyuan.run/docker:latest

before_script:
  - apk add --no-cache py-pip
  - pip install docker-compose
  - docker login -u gitlab-ci-token -p $CI_JOB_TOKEN $CI_REGISTRY

ci:
  script:
    - docker-compose build
    - docker-compose up -d
    - docker-compose exec -T tests run-tests.sh
    - docker-compose down -v
    - docker stack deploy -c docker-compose.prod.yml --with-registry-auth prod-example-com

但当基础镜像每次必须下载并安装Docker Compose时，会增加流程时间。具体是以下行：

yml
...

  - apk add --no-cache py-pip
  - pip install docker-compose

...

本镜像的解决方案（已弃用）

本镜像包含Docker Compose，并允许运行其他任意命令。

因此，GitLab CI的.gitlab-ci.yml文件可简化为：

yml
image: docker.xuanyuan.run/tiangolo/docker-with-compose

before_script:
  - docker login -u gitlab-ci-token -p $CI_JOB_TOKEN $CI_REGISTRY

ci:
  script:
    - docker-compose build
    - docker-compose up -d
    - docker-compose exec -T tests run-tests.sh
    - docker-compose down -v
    - docker stack deploy -c docker-compose.prod.yml --with-registry-auth prod-example-com

运行速度会更快，因为无需每次安装Docker Compose。

您可以按照DockerSwarm.rocks上的GitLab CI runner指南启动初始GitLab Runner。

同样适用于Travis、Jenkins或其他CI系统。

发布说明

最新变更

• 🗑️ 弃用此项目，推荐使用官方Docker镜像 🎉。PR https://github.com/tiangolo/docker-with-compose/pull/47 由 https://github.com/tiangolo 贡献。
• ⬆️ 将actions/checkout从3.1.0升级到3.3.0。PR https://github.com/tiangolo/docker-with-compose/pull/44 由 https://github.com/apps/dependabot 贡献。
• 👷 更新Latest Changes令牌。PR https://github.com/tiangolo/docker-with-compose/pull/46 由 https://github.com/tiangolo 贡献。
• 👷 添加Docker Hub描述的GitHub Action。PR https://github.com/tiangolo/docker-with-compose/pull/41 由 https://github.com/tiangolo 贡献。
• ⬆️ 升级CI操作系统。PR https://github.com/tiangolo/docker-with-compose/pull/40 由 https://github.com/tiangolo 贡献。
• 🔧 添加资金配置。PR https://github.com/tiangolo/docker-with-compose/pull/39 由 https://github.com/tiangolo 贡献。
• 👷 添加每周一自动计划CI。PR https://github.com/tiangolo/docker-with-compose/pull/38 由 https://github.com/tiangolo 贡献。
• 👷 添加每周一自动计划CI。PR https://github.com/tiangolo/docker-with-compose/pull/37 由 https://github.com/tiangolo 贡献。
• 📝 更新README，将bash替换为shell，因为未安装Bash本身。PR https://github.com/tiangolo/docker-with-compose/pull/36 由 https://github.com/tiangolo 贡献。
• 👷 添加alls-green GitHub Action。PR https://github.com/tiangolo/docker-with-compose/pull/35 由 https://github.com/tiangolo 贡献。
• 👷 不在PR上运行双重CI，仅在master分支推送时运行。PR https://github.com/tiangolo/docker-with-compose/pull/34 由 https://github.com/tiangolo 贡献。
• ⬆️ 将tiangolo/issue-manager从0.3.0升级到0.4.0。PR https://github.com/tiangolo/docker-with-compose/pull/28 由 https://github.com/apps/dependabot 贡献。
• 将actions/checkout从2升级到3.1.0。PR https://github.com/tiangolo/docker-with-compose/pull/31 由 https://github.com/apps/dependabot 贡献。
• 🐛 修复部署。PR https://github.com/tiangolo/docker-with-compose/pull/26 由 https://github.com/tiangolo 贡献。
• 🐛 修复GitHub Actions和最新依赖。PR https://github.com/tiangolo/docker-with-compose/pull/25 由 https://github.com/tiangolo 贡献。
• 👷 从Travis迁移到GitHub Actions。PR https://github.com/tiangolo/docker-with-compose/pull/23 由 https://github.com/tiangolo 贡献。
• ✨ 添加外部依赖和Dependabot以获取自动升级PR。PR https://github.com/tiangolo/docker-with-compose/pull/27 由 https://github.com/tiangolo 贡献。
• 👷 添加Latest Changes GitHub Action。PR https://github.com/tiangolo/docker-with-compose/pull/24 由 https://github.com/tiangolo 贡献。
• 将Python升级到3.x版本。PR https://github.com/tiangolo/docker-with-compose/pull/15。
• 添加curl到已安装的可用软件包。PR https://github.com/tiangolo/docker-with-compose/pull/14 由 https://github.com/stratosgear 贡献。
• 添加Travis CI。PR https://github.com/tiangolo/docker-with-compose/pull/4。
• 升级Docker Compose安装。PR https://github.com/tiangolo/docker-with-compose/pull/3 由 https://github.com/boskiv 贡献。

许可证

本项目基于MIT许可证授权。