docker-compose

最新推荐文章于 2025-06-04 09:41:05 发布

哒哒-blog

最新推荐文章于 2025-06-04 09:41:05 发布

阅读量840

点赞数

CC 4.0 BY-SA版权

分类专栏： docker 文章标签： docker

本文链接：https://blog.csdn.net/weixin_44102152/article/details/115429159

docker 专栏收录该内容

5 篇文章

订阅专栏

Docker Compose是用于管理多容器Docker应用的工具，简化了启动和管理复杂应用的过程。通过docker-compose.yml文件定义服务、网络和卷，一键启动所有服务。本文介绍了Docker Compose的安装、基本使用步骤，如`docker-compose up`、`docker-compose down`等常用命令，并详细解释了模板文件中的指令，如`build`、`command`、`container_name`、`depend_on`、`env_file`、`image`、`networks`、`ports`、`volumes`等。此外，还提到了健康检查、容器内核参数设置和数据卷挂载等高级特性。最后，提及了Portainer作为Docker的可视化管理工具。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

介绍

Compose是 Docker 的服务编排工具，主要用来构建基于Docker的复杂应用Compose 通过一个配置文件来管理多个 Docker 容器，非常适合组合使用多个容器进行开发的场景。 docker-compose 是编排容器的。

例如，你有一个 php 镜像，一个 mysql 镜像，一个 nginx 镜像。如果没有 dockercompose ，那么每次启动的时候，你需要敲各个容器的启动参数，环境变量，容器命名，指定不同容器的链接参数等等一系列的操作，相当繁琐。而用了 docker-composer 之后，你就可以把这些命令一次性写在 docker-composer.yml 文件中，以后每次启动这一整个环境（含3个容器）的时候，你只要敲一个 docker-composer up命令就ok了。

dockerfile 的作用是从无到有的构建镜像。它包含安装运行所需的环境、程序代码等。这个创建过程就是使用 dockerfile 来完成的。 Dockerfile -为 docker build 命令准备的，用于建立一个独立的 image，在 docker-compose 里也可以用来实时 build

安装compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
#修改权限
sudo chmod +x /usr/local/bin/docker-compose
#安装完成后可以查看版本
docker-compose --version

使用

一般步骤
1、定义Dockerfile，方便迁移到任何地方；
2、编写docker-compose.yml文件；
3、运行docker-compose up启动服务
后台运行，可以：
docker-compose up –d
服务后台后，可以使用下列命令查看状态： docker-compose ps
停止服务： docker-compose stop
重新启动服务： docker-compose restart

version: "3.8"
services:
	mysqldb:
		image: mysql:5.7.19
		container_name: mysql
		ports:
			- "3306:3306"
		volumes:
			- /root/docker-compose/mysql/conf:/etc/mysql/conf.d
			- /root/docker-compose/mysql/logs:/logs
			- /root/docker-compose/mysql/data:/var/lib/mysql
		environment:
			MYSQL_ROOT_PASSWORD: root
		networks:
			- my-net
		depends_on:
			- redis
	redis:
		image: redis:6.0.9
		container_name: redis
		ports:
			- "6379:6379"
		networks:
			- my-net
		volumes:
			- /root/docker-compose/redis/data:/data
		command: redis-server
		networks:
		my-net:

version指定本 yml 依从的 compose 哪个版本制定的。

docker-compose 模板文件及指令介绍

模板文件是使用 Compose 的核心，涉及到的指令关键字也比较多。这里面大部分指令跟 docker run 相关参数的含义都是类似的。
默认的模板文件名称为 docker-compose.yml ，格式为 YAML 格式。

version: "3.8"
services:
	webapp:
		image: examples/web
		ports:
			- "80:80"
		volumes:
			- "/data"

注意每个服务都必须通过 image 指令指定镜像或 build 指令（需要 Dockerfile）等来自动构建生成镜像。
如果使用 build 指令，在 Dockerfile 中设置的选项(例如： CMD , EXPOSE , VOLUME , ENV 等) 将会自动被获取，无需在 docker-compose.yml 中重复设置。
下面分别介绍各个指令的用法。

build

指定 Dockerfile 所在文件夹的路径（可以是绝对路径，或者相对 docker-compose.yml 文件的路径）。 Compose 将会利用它自动构建这个镜像，然后使用这个镜像。

version: '3.8'
services:
	webapp:
		build: ./dir

你也可以使用 context 指令指定 Dockerfile 所在文件夹的路径。
使用 dockerfile 指令指定 Dockerfile 文件名。
使用 arg 指令指定构建镜像时的变量。

version: '3.8'
services:
	webapp:
		build:
		context: ./dir
		dockerfile: Dockerfile-alternate
		args:
			buildno: 1

command

覆盖容器启动后默认执行的命令。

command: echo "hello world"

container_name

指定容器名称。默认将会使用项目名称_服务名称_序号这样的格式。
注意: 指定容器名称后，该服务将无法进行扩展（scale），因为 Docker 不允许多个容器具有相同的名称。

depend _on

解决容器的依赖、启动先后的问题。以下例子中会先启动 redis db 再启动 web

version: '3.8'
services:
	web:
		build: .
		depends_on:
			- db
			- redis
	redis:
		image: redis
	db:
		image: postgres

注意： web 服务不会等待 redis db 「完全启动」之后才启动。

env_file

从文件中获取环境变量，可以为单独的文件路径或列表。
如果通过 docker-compose -f FILE方式来指定 Compose 模板文件，则 env_file 中变量的路径会基于模板文件路径。
如果有变量名称与 environment 指令冲突，则按照惯例，以后者为准。

env_file: .env

env_file:
	- ./common.env
	- ./apps/web.env
	- /opt/secrets.env

环境变量文件中每一行必须符合格式，支持 # 开头的注释行。

# common.env: Set development environment
PROG_ENV=development

environment

设置环境变量。你可以使用数组或字典两种格式。
只给定名称的变量会自动获取运行 Compose 主机上对应变量的值，可以用来防止泄露不必要的数据。

environment:
	RACK_ENV: development
	SESSION_SECRET:
environment:
	- RACK_ENV=development
	- SESSION_SECRET

如果变量名称或者值中用到 true|false，yes|no 等表达布尔含义的词汇，最好放到引号里，避免YAML 自动解析某些内容为对应的布尔语义。这些特定词汇，包括

y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|O
FF

healthcheck

通过命令检查容器是否健康运行。

healthcheck:
	test: ["CMD", "curl", "-f", "http://localhost"]
	interval: 1m30s
	timeout: 10s
	retries: 3

image

指定为镜像名称或镜像 ID。如果镜像在本地不存在， Compose 将会尝试拉取这个镜像。

image: ubuntu
image: orchardup/postgresql
image: a4bc65fd

networks

配置容器连接的网络。

version: "3.8"
services:
	some-service:
		networks:
			- some-network
			- other-network
	networks:
		some-network:
		other-network:

ports

暴露端口信息。
使用宿主端口：容器端口 (HOST:CONTAINER) 格式，或者仅仅指定容器的端口（宿主将会随机选择端口）都可以。

ports:
	- "3000"
	- "8000:8000"
	- "49100:22"
	- "127.0.0.1:8001:8001"

注意：当使用 HOST:CONTAINER 格式来映射端口时，如果你使用的容器端口小于 60 并且没放到引号里，可能会得到错误结果，因为 YAML 会自动解析 xx:yy 这种数字格式为 60 进制。为避免出现这种问题，建议数字串都采用引号包括起来的字符串格式。

sysctls

配置容器内核参数。

sysctls:
	net.core.somaxconn: 1024
	net.ipv4.tcp_syncookies: 0
sysctls:
	- net.core.somaxconn=1024
	- net.ipv4.tcp_syncookies=0

ulimits

指定容器的 ulimits 限制值。
例如，指定最大进程数为 65535，指定文件句柄数为 20000（软限制，应用可以随时修改，不能超过硬限制）和 40000（系统硬限制，只能 root 用户提高）。

ulimits:
	nproc: 65535
	nofile:
		soft: 20000
		hard: 40000

volumes

数据卷所挂载路径设置。可以设置为宿主机路径( HOST:CONTAINER )或者数据卷名称( VOLUME:CONTAINER )，并且可以设置访问模式（ HOST:CONTAINER:ro ）。
该指令中路径支持相对路径。

volumes:
	- /var/lib/mysql
	- cache/:/tmp/cache
	- ~/configs:/etc/configs/:ro

如果路径为数据卷名称，必须在文件中配置数据卷。

version: "3.8"
services:
	my_src:
		image: mysql:8.0
		volumes:
			- mysql_data:/var/lib/mysql
volumes:
	mysql_data:

docker-compose 常用命令

命令对象与格式

对于 Compose 来说，大部分命令的对象既可以是项目本身，也可以指定为项目中的服务或者容器。如果没有特别的说明，命令对象将是项目，这意味着项目中所有的服务都会受到命令影响。

执行 docker-compose [COMMAND] --help 或者 docker-compose help [COMMAND] 可以查看具体某个命令的使用格式。

docker-compose 命令的基本的使用格式是

docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]

命令选项

-f, --file FILE 指定使用的 Compose 模板文件，默认为 docker-compose.yml ，可以多次指定。
-p, --project-name NAME 指定项目名称，默认将使用所在目录名称作为项目名。
–x-networking 使用 Docker 的可拔插网络后端特性
–x-network-driver DRIVER 指定网络后端的驱动，默认为 bridge
–verbose 输出更多调试信息。
-v, --version 打印版本并退出。

.命令使用说明

up

格式为 docker-compose up [options] [SERVICE…] 。

该命令十分强大，它将尝试自动完成包括构建镜像，（重新）创建服务，启动服务，并关联服务相关容器的一系列操作。
链接的服务都将会被自动启动，除非已经处于运行状态。
可以说，大部分时候都可以直接通过该命令来启动一个项目。
默认情况， docker-compose up 启动的容器都在前台，控制台将会同时打印所有容器的输出信息，可以很方便进行调试。
当通过 Ctrl-C 停止命令时，所有容器将会停止。
如果使用 docker-compose up -d ，将会在后台启动并运行所有的容器。一般推荐生产环境下使用该选项。
默认情况，如果服务容器已经存在， docker-compose up 将会尝试停止容器，然后重新创建（保持使用 volumes-from 挂载的卷），以保证新启动的服务匹配 docker-compose.yml 文件的最新内容。

down
此命令将会停止 up 命令所启动的容器，并移除网络

exec
进入指定的容器。

格式为 docker-compose ps [options] [SERVICE…] 。
列出项目中目前的所有容器。
选项：
-q 只打印容器的 ID 信息。

restart

格式为 docker-compose restart [options] [SERVICE…] 。
重启项目中的服务。
选项：
-t, --timeout TIMEOUT 指定重启前停止容器的超时（默认为 10 秒）。

格式为 docker-compose rm [options] [SERVICE…] 。
删除所有（停止状态的）服务容器。推荐先执行 docker-compose stop 命令来停止容器。
选项：
-f, --force 强制直接删除，包括非停止状态的容器。一般尽量不要使用该选项。
-v 删除容器所挂载的数据卷。

start
格式为 docker-compose start [SERVICE…] 。
启动已经存在的服务容器。

stop

格式为 docker-compose stop [options] [SERVICE…] 。
停止已经处于运行状态的容器，但不删除它。通过 docker-compose start 可以再次启动这些容器。
选项：
-t, --timeout TIMEOUT 停止容器时候的超时（默认为 10 秒）。

top
查看各个服务容器内运行的进程。

unpause
格式为 docker-compose unpause [SERVICE…] 。
恢复处于暂停状态中的服务。

logs

格式为 docker-compose logs [options] [SERVICE…] 。
查看服务容器的输出。默认情况下，docker-compose 将对不同的服务输出使用不同的颜色来区分。可以通过 --no-color 来关闭颜色。
该命令在调试问题的时候十分有用。

只列举了部分常用的命令，更多操作命令：https://docker_practice.gitee.io/zh-cn/compose/commands.html

docker可视化工具

portainer文档：https://documentation.portainer.io/v2.0/deploy/linux/

docker pull portainer/portainer
docker pull portainer/portainer
docker run -d -p 8000:8000 -p 9005:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer