1. 简介
我们知道使用一个Dockerfile模板文件,可以很方便地定义一个单独的应用容器。然 而,在日常工作中, 经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个Web 项目,除了Web服务容器本身,往往还需要再加上后端的数据库服务容器,甚至还包括负载均衡容器 等。
Compose定位是“定义和运行多个Docker容器的应用”,它允许用户通过一个单独的docker- compose.yml模板文件(YAML格式)来定义一组相关联的应用容器为一个项目(project)。
2. Compose的概念
Docker Compose 将所管理的容器分为三层,分别是项目(project)、服务(service)、容器(container)
- 项目(project):由一组关联的应用容器组成的一个完整业务单元,在docker-compose.yml文件 中定义
- 服务(service):一个应用的容器,实际上可以包括若干运行相同镜像的容器实例
- 容器(container):docker容器
Docker Compose 运行目录下的所有文件(docker-compose.yml)组成一个项目,一个项目包含多个服 务,每个服务中定义了容器运行的镜像、参数、依赖,一个服务可包括多个容器实例
Compose的默认管理对象是项目,通过子命令对项目中的一组容器进行便捷地生命周期管理。
Compose项目由Python编写,实现上调用了Docker服务提供的API来对容器进行管理。因此,只要所操作的平台支持Docker API,就可以在其上利用Compose来进行编排管理。
3. Compose的安装
官方地址:https://github.com/docker/docker.github.io/blob/master/compose/install.md
3.1 安装
- 运行以下命令以下载Docker 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
[root@rpp ~]# echo $(uname -s)-$(uname -m)
Linux-x86_64
- 将可执行权限应用于二进制文件:
chmod +x /usr/local/bin/docker-compose
- 添加到环境中
#ln -s : 软链接
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
- 测试安装。
[root@rpp ~]# docker-compose version
docker-compose version 1.27.4, build 40524192
docker-py version: 4.3.1
CPython version: 3.7.7
OpenSSL version: OpenSSL 1.1.0l 10 Sep 2019
卸载Docker Compose
rm /usr/local/bin/docker-compose
3.2 docker-compose.yml
模板文件是使用Compose的核心,默认的模板文件名称为docker-compose.yml,格式为YAML格式。
示例:
version: '2.0'
services:
nginx:
image: nginx:1.18.0 #Nginx:latest 镜像 先拉镜像 指定镜像的版本
ports:
- 80:80 #映射端口
- 433:433
volumes: #挂载数据 宿主机目录(一定要存在):容器的目录
- /data/log:/var/log/nginx
- /data/www:/var/www
- /etc/letsencrypt:/etc/letsencrypt
3.3 常见语法
- version:版本
version: '2.0' #版本2.0 与swarm结合 要3.0以上
- services:定义服务
services: #定义服务
- image:指定服务的镜像名称或镜像 ID。如果镜像在本地不存在,Compose 将会拉取镜像
image: nginx #Nginx:latest 镜像 先拉镜像 指定镜像的版本
- ports:端口映射 HOST:CONTAINER
ports:
- 8000:80 #映射端口
- build:
指定dockerfile Compose 将会利用它自动构建这个镜像,然后使用这个镜像启动服务容器 构建自己的应用
build: /path/dockerfilename
build:./path/dockerfilename
- command:使用 command 可以覆盖容器启动后默认执行的命令
command:echo $HOME
command:[ "echo", "$HOME" ]
command: redis-server /usr/local/etc/redis/redis.conf #先创建目录和文件
- depends_on:确定容器的启动顺序
depends_on:
- db #服务名
- redis
- environment:设置镜像变量
environment:
RACK_ENV: development
SHOW: 'true'
SESSION_SECRET:
- volumes
挂载一个目录或者一个已存在的数据卷容器,可以直接使用 [HOST:CONTAINER] 这样的格 式,或者使用 [HOST:CONTAINER:ro] 这样的格式,后者对于容器来说,数据卷是只读的,这样可以有 效保护宿主机的文件系统,Compose的数据卷指定路径可以是绝对路径或相对路径
volumes: #挂载数据
- /data/nginx/conf.d:/etc/nginx/conf.d # 如果不写将使用默认
- /data/log:/var/log/nginx
- /data/www:/var/www
注意:如果目录或文件不存在将启动不成功,所以要先创建好目录或文件
- network_mode:网络模式
默认bridge
[root@rpp ~]# docker network ls
NETWORK ID NAME DRIVER SCOPE
a39d07880424 bridge bridge local
288862b6b32c docker_gwbridge bridge local
2adfe1d1fe52 host host local
utyvugfliue6 ingress overlay swarm
3529f920aa59 none null local
- networks:定义网络
# 默认网络
networks:
default:
driver: bridge
#自定义网络
networks:
front:
driver: bridge
back:
driver: bridge
driver_opts:
foo: "1"
bar: "2"
#使用现有网络
docker network create net-a --driver bridge networks:
default:
external:
name: net-a
3.4 案例
version: "2.0"
services:
nginx:
image: nginx:1.18.0
restart: always
container_name: nginx
environment:
- TZ=Asia/beijing
ports:
- 80:80
- 443:443
volumes:
- /docker/nginx/log:/var/log/nginx
- /docker/nginx/www:/etc/nginx/html
- /etc/letsencrypt:/etc/letsencrypt
mysql:
restart: always
image: mysql:5.7.30
container_name: mysql5.7
ports:
- 13306:3306
command:
--default-authentication-plugin=mysql_native_password
--character-set-server=utf8mb4
--collation-server=utf8mb4_general_ci
--explicit_defaults_for_timestamp=true
--lower_case_table_names=1
--default-time-zone=+8:00
environment:
MYSQL_ROOT_PASSWORD: "root"
volumes:
- "/docker/mysql/db:/var/lib/mysql"
redis:
image: redis:5.0.9
container_name: redis
environment:
- TZ=Asia/beijing
ports:
- 6379:6379
volumes:
- /docker/redis/data:/data
运行
[root@rpp docker-compose-demo]# docker-compose up -d
WARNING: The Docker Engine you're using is running in swarm mode.
Compose does not use swarm mode to deploy services to multiple nodes in a swarm. All containers will be scheduled on the current node.
To deploy your application across the swarm, use `docker stack deploy`.
Creating network "docker-compose-demo_default" with the default driver
Creating nginx ... done
Creating redis ... done
Creating mysql5.7 ... done
查看
[root@rpp docker-compose-demo]# docker-compose ps
Name Command State Ports
--------------------------------------------------------------------------------------------
mysql5.7 docker-entrypoint.sh --def ... Up 0.0.0.0:13306->3306/tcp, 33060/tcp
nginx /docker-entrypoint.sh ngin ... Up 0.0.0.0:443->443/tcp, 0.0.0.0:80->80/tcp
redis docker-entrypoint.sh redis ... Up 0.0.0.0:6379->6379/tcp
[root@rpp docker-compose-demo]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
ea79c326e5f6 mysql:5.7.30 "docker-entrypoint.s…" 13 seconds ago Up 12 seconds 33060/tcp, 0.0.0.0:13306->3306/tcp mysql5.7
cca3b0c60c88 redis:5.0.9 "docker-entrypoint.s…" 13 seconds ago Up 12 seconds 0.0.0.0:6379->6379/tcp redis
b71f15edc96d nginx:1.18.0 "/docker-entrypoint.…" 13 seconds ago Up 12 seconds 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp nginx
4. Compose的常见命令
ps:列出所有运行容器
docker-compose ps
logs:查看服务日志输出
docker-compose logs
port:打印绑定的公共端口
docker-compose port nginx 80
build:构建或者重新构建服务
docker-compose build
start:启动指定服务已存在的容器
docker-compose start nginx
up以后没有down 可以运行start
stop:停止已运行的服务的容器
docker-compose stop nginx
不删除容器
rm:删除指定服务的容器
docker-compose rm nginx
up:通过docker-compose.yml,自动完成包括构建镜像,(重新)创建服务,启动服务,并关联服务 相关容器的一系列操作
docker-compose up -d
可以说,大部分时候都可以直接通过该命令来启动一个项目。默认情况,docker-compose up启动的容 器都在前台,控制台将会同时打印所有容器的输出信息,可以很方便进行调试。当通过Ctrl-C停止命令 时,所有容器将会停止。
如果使用docker-compose up-d,将会在后台启动并运行所有的容器。一般推荐生产环境下使用该选 项。
run:在一个服务上执行一个命令
docker-compose run nginx bash
down 停止并删除容器
docker-compose down
-v : 可以删除容器使用的数据
5. 与Swarm一起使用Compose
我们知道使用 docker-compose.yml可以来一次配置、启动多个容器,在 Swarm 集群中也可以使用 compose 文件 (docker-compose.yml) 来配置、启动多个服务。
使用 docker service create 一次只能部署一个服务,使用 docker-compose.yml 我们可以一次启动多 个关联的服务。
打开前面的docker-compose.yml (有多个容器)
修改:
version: "3.0"
deploy:
mode: replicated
replicas: 2
去掉不支持的:
restart: always
container_name: nginx
修改后的配置文件为
version: "3.0"
services:
nginx:
image: nginx:1.18.0
environment:
- TZ=Asia/beijing
ports:
- 80:80
- 443:443
volumes:
- /docker/nginx/log:/var/log/nginx
- /docker/nginx/www:/etc/nginx/html
- /etc/letsencrypt:/etc/letsencrypt
deploy:
mode: replicated
replicas: 2
mysql:
image: mysql:5.7.30
ports:
- 13306:3306
command:
--default-authentication-plugin=mysql_native_password
--character-set-server=utf8mb4
--collation-server=utf8mb4_general_ci
--explicit_defaults_for_timestamp=true
--lower_case_table_names=1
--default-time-zone=+8:00
environment:
MYSQL_ROOT_PASSWORD: "root"
volumes:
- "/docker/mysql/db:/var/lib/mysql"
deploy:
mode: replicated
replicas: 2
redis:
image: redis:5.0.9
environment:
- TZ=Asia/beijing
ports:
- 6379:6379
volumes:
- /docker/redis/data:/data
deploy:
mode: replicated
replicas: 2
运行,先停止并删除容器 docker-compose down
[root@rpp docker-compose-demo]# docker stack deploy -c docker-compose.yml web
Creating network web_default
Creating service web_nginx
Creating service web_mysql
Creating service web_redis
查看服务:docker stack services web
[root@rpp docker-compose-demo]# docker stack services web
ID NAME MODE REPLICAS IMAGE PORTS
rpw42ro4ofob web_mysql replicated 2/2 mysql:5.7.30 *:13306->3306/tcp
vosdm3uvi5ly web_nginx replicated 2/2 nginx:1.18.0 *:80->80/tcp, *:443->443/tcp
w1sje4tsiqec web_redis replicated 2/2 redis:5.0.9 *:6379->6379/tcp
[root@rpp docker-compose-demo]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
5b6c18fb1093 redis:5.0.9 "docker-entrypoint.s…" About a minute ago Up About a minute 6379/tcp web_redis.2.uxijr48ax3mvjz6kbx0gw9yay
a256fd20a332 mysql:5.7.30 "docker-entrypoint.s…" About a minute ago Up About a minute 3306/tcp, 33060/tcp web_mysql.2.mn557qdno19c7yc75qa9j1ay6
e5e0d2e3e2cf nginx:1.18.0 "/docker-entrypoint.…" 2 minutes ago Up 2 minutes 80/tcp web_nginx.1.8tmw63zm9678r141r1sfg256d
删除服务:
[root@rpp docker-compose-demo]# docker stack down web
Removing service web_mysql
Removing service web_nginx
Removing service web_redis
Removing network web_default