Docker Compose的使用

文章首发于我的博客：https://blog.liuzijian.com/post/docker-compose.html

  
Docker Compose是什么

Docker Compose是Docker官方的开源项目，负责实现对Docker容器的快速编排，Docker发起每个容器只运行一项服务，因为容器运行的开销很小，但是同时部署多个应用须要每个容器都单独编写Dockerfile会显得非常复杂，因而Docker官方提供了多容器部署的编排工具Docker Compose
Docker Compose允许用户通过一个单独的配置文件来界说一组相关联的应用容器为一个项目，Docker Compose可以管理多个Docker容器构成的一个应用，只须要界说好一个yaml格式的配置文件docker-compose.xml，写很多多少个容器之间的调用关系，然后只要一个下令就可以实现一键部署和一键启动和关闭这些容器。
Docker Compose文件格式版本有多种，这里以最为主流的3.x为例
Docker Compose安装

先去下载docker-compose的可执行文件，Docker Compose发布在GitHub上面(https://github.com/docker/compose/releases/)，我下载的版本是linux64位的v2.30.3，下载地址：

• docker-compose-linux-x86_64
  

安装很简朴，只要将下载下来的可执行文件赋予执行权限，并链接即可，先将下载下来的文件docker-compose-linux-x86_64放到/opt目录下，然后作为可执行文件，并建立软链接

1. chmod +x ./docker-compose-linux-x86_64

复制代码

1. ln -s /opt/docker-compose-linux-x86_64 /usr/local/bin/docker-compose

复制代码

之后，就可以在恣意目录执行docker-compose的下令了
Docker Compose文件

一个DockerCompose文件就是一个工程，工程由服务构成，服务就是一个个的应用实例，由一组关联的容器构成一个完整的业务单位就是工程。
文件内包含以下顶级元素：

• version docker-compose文件版本，大多用3
  
• name 应用部署的名称
  
• services 服务，下面可以界说多个部署的应用
  
• networks 自界说网络，供services下的应用使用
  
• volumes 卷，应用用到的卷配置
  
• configs 配置
  
• secrets 密钥
  

每个顶级元素下又有以下常用配置项：

• services.$service-name.image 使用的镜像和TAG
  
• services.$service-name.privileged 设置容器权限
  
• services.$service-name.container_name 容器名
  
• services.$service-name.environment 环境变量
  
• services.$service-name.restart 自启动，常见配置：总是always，出错时自启on-failure/on-failure:3
  
• services.$service-name.command 自界说下令行参数
  
• services.$service-name.ports 端口映射
  
• services.$service-name.volumes 数据卷挂载
  
• services.$service-name.depends_on 依赖哪个服务，在哪些服务启动后再启动
  
• services.$service-name.networks 使用的自界说网络
  
• networks.$network-name.driver 自界说网络的类型，不设置的话默认是bridge
  
• networks.$network-name.ipam.config IP地址管理，用于管理网络的IP地址分配，不设置则Docker自动分配
  
• networks.$network-name.ipam.config.subnet 自界说网络的网段，例如192.168.1.0/24
  
• networks.$network-name.ipam.config.gateway 自界说网络的网关，例如192.168.1.1
  

例：

1. version: '3'
3. name: my-demo
5. services:
6.     app_1:
7.        # 镜像:TAG
8.        image: demo:1.0
9.        # 容器名
10.        container_name: demo
11.        # 提升容器内权限
12.        privileged: true
13.        # 环境变量
14.        environment:
15.          - NAME1=VALUE1
16.          - NAME2=VALUE2
18.        restart: always
19.       
20.        command: ["-c nginx.conf"]
21.       
22.        # 宿主机端口:容器内端口
23.        ports:
24.          - "80:80"
26.        # 扩展语法设置卷，允许更详细的配置，如设置卷驱动和选项
27.        volumes:
28.          # 绑定挂载，将主机上的一个具体目录或文件直接挂载到容器中
29.          - type: bind
30.            source: /var/lib/data
31.            target: /data
33.          # volume是由Docker管理的存储区域，通常在/var/lib/docker/volumes/下
34.          - type: volume
35.            source: my-data
36.            target: /data
37.            volume:
38.              nocopy: true
39.              subpath: sub
41.        networks:
42.          - my-network
44.     app_2:
45.        image: mysql:8
46.        depends_on:
47.          - app_1
49.        # 绑定挂载，直接将主机路径映射到容器路径
50.        volumes:
51.          #宿主机路径:容器内路径
52.          - /data:/var/data
53.          #只读卷
54.          - /host/path:/container/path:ro
56.     app_3:
57.        # 命名卷，由用户指定名称，Docker 管理其存储位置
58.        volumes:
59.          - my-data2:/var/lib/mysql
61.     app_4:
62.        # 匿名卷，由Docker自动生成，不指定主机路径或命名卷
63.        volumes:
64.          - /var/lib/mysql
65.          
66.     #多容器共享卷
67.     app_5:
68.        image: mysql:8
69.        volumes:
70.          - my-data3:/var/lib/mysql
71.     app_6:
72.        image: mysql:8
73.        volumes:
74.          - my-data3:/var/lib/mysql
77. networks:
78.   my-network:
79.     driver: bridge
80.     ipam:
81.       config:
82.         - subnet: 192.168.1.0/24
83.           gateway: 192.168.1.1
85. volumes:
86.    my-data:
87.    my-data2:
88.    my-data3:

复制代码

Docker Compose常用下令

在docker-compose.yml文件路径下执行以下下令，如果docker-compose.yml文件的路径不是./或文件名不是默认的docker-compose.yml，你可以使用-f参数来指定文件路径和文件名。这样，DockerCompose会使用你指定的文件来运行下令。

• 帮助
  

1. docker-compose -h

复制代码

• 上线全部的服务
  

1. docker-compose up
3. docker-compose  -f ./compose.yml up

复制代码

• 上线全部的服务并后台运行
  

1. docker-compose up -d
3. docker-compose  -f ./compose.yml up -d

复制代码

• 上线某一服务
  

1. docker-compose up <service>
3. docker-compose [-f ./compose.yml] up <service>

复制代码

• 下线并删除容器、网络、数据卷和镜像
  

1. docker-compose down

复制代码

• 停止某一服务
  

1. docker-compose stop <service>

复制代码

• 删除某服务容器
  

1. docker-compose rm -f <service>

复制代码

• 进入容器实例内部
  

1. docker-compose exec <service> /bin/bash

复制代码

• 展示当前docker-compose文件编排过的运行的全部容器
  

1. docker-compose ps

复制代码

• 展示当前docker-compose文件编排过的容器进程
  

1. docker-compose top

复制代码

• 查看容器输出的日记
  

1. docker-compose logs  <service>

复制代码

• 检查配置是否有语法错误
  

1. docker-compose config  

复制代码

• 检查配置，有题目的才输出
  

1. docker-compose -q  

复制代码

• 重启服务
  

1. docker-compose restart    <service>

复制代码

• 启动服务
  

1. docker-compose start   <service>

复制代码

• 扩容，将服务名为app的应用扩容3份
  

1. docker-compose scale <service>×3

复制代码

案例：部署WordPress博客系统

1.编辑compose.yml

1. name: by_blog
3. services:
4.     mysql:
5.       privileged: true
6.       image: mysql:8.0
7.       ports:
8.         - "3306:3306"
9.       environment:
10.         - MYSQL_ROOT_PASSWORD=123456
11.         - MYSQL_DATABASE=wordpress
12.       volumes:
13.         - mysql-data:/var/lib/mysql
14.         - /app/myconf:/etc/mysql/conf.d
15.       networks:
16.         - blog-network
17.       restart: always
18.       
19.     wordpress:
20.       privileged: true
21.       image: wordpress
22.       ports:
23.         - "8080:80"
24.       restart: always
25.       depends_on:
26.          - mysql
27.       environment:
28.         - WORDPRESS_DB_HOST=mysql
29.         - WORDPRESS_DB_USER=root
30.         - WORDPRESS_DB_PASSWORD=123456
31.         - WORDPRESS_DB_NAME=wordpress
32.       volumes:
33.         - wordpress-data:/var/www/html
34.       networks:
35.         - blog-network
37. volumes:
38.   mysql-data:
39.   wordpress-data:
41. networks:
42.   blog-network:

复制代码

2.执行docker-compose下令启动服务

1. docker-compose -f ./compose.yml up -d

复制代码

下令行输出

1. [root@localhost opt]# docker-compose  -f ./compose.yml up -d
2. [+] Running 35/24
3. ✔ wordpress 22 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿]      0B/0B      Pulled                                                                66.2s
4. ✔ mysql 11 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿]      0B/0B      Pulled                                                                               93.2s
5.                                                                                                                                             
6.                                                                                                                                             
7.                                                                                                                                             
8.                                                                                                                                             
9.                                                                                                                                             
10.                                                                                                                                             
11.                                                                                                                                             
12.                                                                                                                                             
13.                                                                                                                                             
14.                                                                                                                                             
15.                                                                                                                                             
16.                                                                                                                                             
17.                                                                                                                                             
18.                                                                                                                                             
19.                                                                                                                                             
20.                                                                                                                                             
21.                                                                                                                                             
22.                                                                                                                                             
23.                                                                                                                                             
24.                                                                                                                                             
25.                                                                                                                                             
26.                                                                                                                                             
27. [+] Building 0.0s (0/0)                                                                                                                     
28. [+] Running 5/5
29. ✔ Network by_blog_blog-network     Created                                                                                            0.4s
30. ✔ Volume "by_blog_mysql-data"      Created                                                                                            0.0s
31. ✔ Volume "by_blog_wordpress-data"  Created                                                                                            0.0s
32. ✔ Container by_blog-mysql-1        Started                                                                                            2.6s
33. ✔ Container by_blog-wordpress-1    Started                                                                                            3.6s
34. [root@localhost opt]#

复制代码

编排完成，服务乐成启动，可以看到docker-compose先是创建了自界说的网络，然后是创建和挂载数据卷，然后在按次序启动容器。
打开欣赏器，简朴举行初始化的操纵后，WordPress博客系统便进入可用状态了