tiangolo/docker-with-compose

🚨 弃用警告 🚨

由于https://github.com/docker-library/docker/pull/361%EF%BC%8C%E6%AD%A4Docker%E9%95%9C%E5%83%8F%E5%B7%B2%E4%B8%8D%E5%86%8D%E9%9C%80%E8%A6%81%E3%80%82

您应改用官方https://hub.docker.com/_/docker/%E3%80%82

https://github.com/tiangolo/docker-with-compose/workflows/Test/badge.svg](https://github.com/tiangolo/docker-with-compose/actions?query=workflow%3ATest) https://github.com/tiangolo/docker-with-compose/workflows/Deploy/badge.svg](https://github.com/tiangolo/docker-with-compose/actions?query=workflow%3ADeploy)

支持的标签及对应Dockerfile链接

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

注意：存在https://hub.docker.com/r/tiangolo/docker-with-compose/tags%E3%80%82%E5%A6%82%E9%9C%80%E5%9B%BA%E5%AE%9A%E4%BD%BF%E7%94%A8%E7%9A%84Docker%E9%95%9C%E5%83%8F%E7%89%88%E6%9C%AC%EF%BC%8C%E5%8F%AF%E9%80%89%E6%8B%A9%E6%AD%A4%E7%B1%BB%E6%A0%87%E7%AD%BE%EF%BC%8C%E4%BE%8B%E5%A6%82 tiangolo/docker-with-compose:2021-09-17。

Docker with Docker Compose镜像

https://hub.docker.com/_/docker/%E5%86%85%E7%BD%AEhttps://github.com/docker/compose%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8ECI%E7%8E%AF%E5%A2%83%EF%BC%88%E5%B7%B2%E5%BC%83%E7%94%A8%EF%BC%89%E3%80%82

概述

本镜像的主要用途是帮助需要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 tiangolo/docker-with-compose

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

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

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

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

例如，假设有如下Dockerfile：

Dockerfile
FROM 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/%EF%BC%8C%E4%BB%A5%E5%8F%8Ahttps://hub.docker.com/r/docker/compose/%E3%80%82

但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: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: 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%E3%80%82
• 添加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%E3%80%82
• 升级Docker Compose安装。PR https://github.com/tiangolo/docker-with-compose/pull/3 由 https://github.com/boskiv 贡献。

许可证

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