8.29笔记

⼀、Docker-compose 定义

1. docker compose 是 docker 官⽅的开源项⽬，负责实现对docker 容器集群的快速编排(容器，依赖，⽹络，挂载。。)

2. compose 是 docker 公司推出的⼀个⼯具软件，可以管理多个docker 容器组成的应⽤

3. 需要定义⼀个 YAML 格式的配置⽂件 docker-compose.yml，好多个容器之间的调⽤关系

4. 使⽤ compose 的步骤、

5. 1. 使⽤ Dockerfile 定义各个微服务应⽤并构建出对应的镜像⽂件Dockerfile 的使⽤，以便可以在任何地⽅复制。

2. 使⽤ docker-compose.yml 定义⼀个完整的业务单元，安排好整体应⽤中的各个容器服务。

3. 最后，执⾏ docker-compose up 命令来启动并运⾏整个应⽤程序，完成⼀键部署。

⼆、Docker-compose 产⽣背景

1. 使⽤ Dockerfile 定义镜像⽂件，再⼿动构建、运⾏容器等操作，⽽微服务架构⼀般包含若⼲个微服务，且每个微服务⼀般都

会部署多个实例，所以，若每个微服务都需要⼿动启停，那么维

护量会⾮常庞⼤，并且⼯作效率也会很低。2. ⽽ compose 是⽤于定义和运⾏多容器 docker 应⽤程序的⼯具。通过 compose，可以使⽤ YML ⽂件来配置应⽤程序需要的所有服务。

3. 仅需使⽤⼀个命令，就可以从 YML ⽂件配置中创建并启动所有服务。

4. Compose 可以基于 Compose ⽂件帮我们快速的部署分布式应⽤，⽆需⼿动⼀个个创建和运⾏容器。

5. Compose ⽂件是⼀个⽂本⽂件，通过指令定义集群中的每个容器如何运⾏。

三、Docker-compose 核⼼概念

Docker-compose 将管理的容器分为三层：⼯程（project）、 服务（service）、容（container）

1. ⼯程：运⾏ compose 的⽬录下所有的⽂件，包括 dockecompose.yml、extends ⽂件、环境变量⽂件等组成⼀个⼯程， 若⽆特殊指定⼯程，⼯程名即为当前⽬录名。⼯程的默认配置⽂ 件为 docker-compose.yml，可通过环境变量 COMPOSE_FILE 或 -f 参数⾃定义配置⽂件，其定义了多个有依赖关系的服务及每个服务运⾏的容器。

2. 服务：⼀个⼯程中包含多个服务，每个服务中定义了容器运⾏的镜像、参数、依赖等。⼀个服务中可包括多个容器实例。3. 容器：被 docker-compose 管理或部署的容器集群，调⽤docker 服务提供的 API 来对容器进⾏管理，只要操作的平台⽀持 docker API，即可在其上进⾏ compose 的容器编排。

四、YAML ⽂件的格式和语法

1、YAML ⽂件格式

1. yaml 是⼀种标记语⾔很直观的数据序列化格式，可读性很⾼。类似于 xml 描述性语⾔，语法⽐xml简单的很多。

2. yaml 数据结构通过缩进进⾏表示，连续的项⽬通过减号来表示，键值对⽤冒号分隔，数组⽤中括号括起来，hash⽤花括号括起来。

3. yaml ⽂件的基本格式由⼀系列键值对构成。每个键值对都⽤冒

号“: ”分隔key： value

1. 在 yaml 中，键和值之间只需要⼀个空格，这是为了保证 yaml⽂件的可读性和⼀致性

2. 对于字符串值，可以使⽤单引号或者双信号将其括起来，这样可以避免出现特殊字符或空格等问题name： 'Meng Mr'

age: "34"1. 如果值包含特殊字符（如冒号或短横线），则应该使⽤引号将其括起来description: "This is a YAML file: good for configuation

files."

2、YAML 注意事项

1. 不⽀持制表符 tab 键缩进，需要使⽤空格缩进。

2. 通常开头缩进 2 个空格。

3. 字符后缩进 1 个空格，如：冒号，逗号，横杠。

4. ⽤ # 表示注释。

5. 如果包含特殊字符⽤单引号引起来。

6. 布尔值（true、false、yes、no、on、off）必须使⽤“”引号括起

来，这样分析器会将它们解释为字符串。

3、列表和数组

在yaml中，可以使⽤“-”符号表示⼀个列表和数组

1. fruits: # fruits是⼀个键，它对应⼀个列表，包含三个元

2. 素：apple、banana、orange

3. - apple # fruits为⼀个⼤项，下⾯的⼩项只需要缩进⼏个

4. 空格，与其他项⽬对⻬即可

5. - banana

6. - orange

4、嵌套数据结构

yaml⽀持嵌套数据结构，可以⽤缩进来表示不同层级之间的关系，可使⽤ # 号表示注释信息。

1. person:

2. name: 'Meng Mr' # 两个空格，name和age是person的⼀

3. 级⼦节点

4. age: "34"

5. address: # address是person的⼆级⼦节点

6. street: '123 Main St' # address节点包含了

7. street、city、state和zip四个⼀级⼦节点

8. city: 'Anytown'

9. state: 'CA'

10. zip: '12345'

五、Docker-compose 安装

1. 官⽹：https://docs.docker.com/compose/

2. Github：https://github.com/docker/compose#docker-compose-v2

3. 需要提前添加好 apt 仓库，因为之前安装过 docker，所以不需

要在准备。

1. [root@docker ~]# yum -y update

2. [root@docker ~]# yum -y install docker-composeplugin

3. # 通过检查版本来验证 Docker Compose 是否已正确安装

4. [root@docker ~]# docker compose version

5. Docker Compose version v2.20.2

6. [root@docker ~]#

六、docker-compose 命令解析

1、⽂件内常⽤指令字段

（1）version

指定了Docker compose编排⽂件的版本

Docker Compose ⽬前有三个版本，分别为 Version1、

Version2和Version3。

Version1 是较早的版本，它将来会被弃⽤。

Version2 是⽬前的稳定版本，⽀持更多的指令。

在功能上与 Version2 类似，但进⾏了⼀些改进和扩展，例如增加了对 Docker BuildKit 的⽀持，可以加速构建过程。

（2）service

指定了在 docker compose 编排中要运⾏的服务，每个服务都有⼀

个名称，并指定要使⽤的镜像和容器的配置选项。

1. services：

2. mysql： #服务名

3. # 再往下可以对该服务进⾏定义，⽐如指定映射端⼝，指定使⽤的

4. 镜像等，但要注意缩进格式。

（3）image

指定要使⽤的 docker 镜像。

1. services:

2. mysql: # 服务名

3. image: mysql:5.5 # 指定mysql镜像，如果主机内不存在

4. 该镜像，会从登录的docker镜像仓库内拉取，⼀般都是从

5. dockerhub上拉取

（4）build

允许在 docker compose 编排中指定 dockerfile 的位置。

1. services:

2. mysql: # 服务名

3. build: /docker/mysql # 这⾥为⽤户微服务⽂件夹，

4. ⾥⾯存放的是该服务代码jar包和Dockerfile⽂件

（5）environment

指定了要设置的环境变量。

1. services:

2. mysql: # 服务名

3. environment: # 下⾯是MySQL环境变量的例⼦

4. MYSQL_ROOT_PASSWORD: 000000 # 设置MySQL的

5. root⽤户的密码

6. MYSQL_DATABASE: database # 指定要创建的数

7. 据库名称

8. MYSQL_USER: user # 指定要创建的

9. MySQL⽤户名

10. MYSQL_PASSWORD: 123 # 指定要创建的

11. MySQL⽤户的密码

（6）volumes

挂载宿主机路径或命名卷

1. 指定路径挂载

1. services:

2. mysql: # 服务名

3. volumes:

4. - ./mysql/data:/var/lib/mysq # 直接指定路径挂载

1. ⽣成 volume 卷挂载

1. [root@doc ~]# docker volume create mysql # ⽣成名为

2. mysql的volume卷

3. [root@doc ~]# vim docker-compose.yml

4. services:

5. mysql: # 服务名

6. volumes:

7. - mysql:/var/lib/mysq # 指定volume卷挂载

1. 共享⽬录挂载

1. [root@doc ~]# vim docker-compose.yml

2. version: '2' # 使⽤共享⽬录挂载只有‘2’版本⽀持

3. service:

4. mysql: # 服务名

5. volumes:

6. - /var/lib/mysql # 将这个⽬录作为共享⽬录

7. nginx:

8. volumes:

9. - /usr/local/nginx/html

10. php:

11. volumes_from: # 共享⽬录来⾃

12. - mysql # 挂载的共享⽬录，挂载后会在容器内⽣成与

13. 被挂载的⽬录同名的路径

14. - nginx # 共享挂载可以是⼀个列表

（7）port

指定了要宿主机映射到容器的端⼝，端⼝不能低于 60（宿主机端⼝：容器端⼝），如果选择的端⼝号低于 60，可能会与系统保留的知名端⼝冲突。

1. services:

2. mysql: # 服务名

3. ports:

4. - 3306:3306 # 宿主机端⼝：容器端⼝

（8）expose

⽤于在 docker 容器内部暴露端⼝的选项。

1. services:

2. mysql: # 服务名

3. expose:

4. - 3306

（9）networks

加⼊⽹络，引⽤顶级 networks 条⽬.

1. networks: # 与services同级

2. dev: # ⾃定义或已存在的⽹络设备名

3. driver: bridge # 设备类型：⽹桥

4. external: true # 外部存在：是

（10）hostname

设定容器主机名

1. services:

2. mysql: # 服务名

3. hostname: mysql

（11）command

指定容器启动时要运⾏的命令，覆盖构建时的默认命令

1. services:

2. mysql: #服务名

3. command: --character-set·server=utf8

2、docker compose 命令选项

1. build：重新构建服务

2. ps：列出容器

3. up：启动所有docker-compose服务

4. up -d：启动所有docker-compose服务启动并后台运⾏

5. exec：进⼊容器实例内部

6. scale：指定⼀个服务器启动数量

7. top：显示容器进程

8. logs：查看容器输出⽇志

9. down：停⽌并删除容器、⽹络、卷、镜像

10. stop：停⽌服务

11. start：启动服务

12. restart：重启服务

13. config：检查配置

14. config -q：检查配置，有问题才有输出

15. --version：查看版本