集群管理-docker-compose容器编排

# 1 为什么使用docker-compose

我们学会了使用 dockerfile 构建 docker 镜像，看起来已经能够满足我们的日常需求了，无论需要什么环境，在 dockerfile 里逐步构建，然后 build、run，就 ok 了，也满足了我们docker 隔离性、快速部署的要求，为什么还需要docker-compose呢？

我们来看一个网站开发最常见的场景：我们要有数据库，网站应用，nginx，互相配合才是完整的环境，是的，我们完全可以以 ubuntu 为基础镜像，把这些一股脑全装进去，然后运行，但是这样有很多缺点，比如我们每次都要重新装 mysql 而不是直接利用 mysql 官方的基础镜像，升级维护不方便；如果我们的应用要扩展也很难，因为每个应用都连接的自己内部的数据库，无法共享数据；事实上，这种方式是典型的虚拟机的使用方式，不是 docker 的正确打开方式

docker 是轻量化的应用程序，docker 官方推荐每个 docker 容器中只运行一个进程，那么就是说，我们需要分别为我们的应用、数据库、nginx 创建单独的 docker 容器，然后分别启动它，想象一下，构建好 docker 之后，每次启动我们的网站，都要至少 docker run 三次，是不是很繁琐？而且此时这几个 docker 是分散独立的，很不方便管理，既然这几个 docker 都是为了同一个网站服务，是不是应该把它们放到一起？这就引出了 docker-compose 项目。

# 2 什么是docker-compose

docker-compose是 docker 官方的开源项目，使用 python 编写，实现上调用了 Docker 服务的 API 进行容器管理，其官方定义为为「定义和运行多个 Docker 容器的应用（Defining and running multi-container Docker applications）），其实就是上面所讲的功能。

# 3 安装Docker-Compose

Docker Compose是一个用来定义和运行复杂应用的Docker工具，一个使用Docker容器的应用，通常由多个容器组成。使用Docker Compose不再需要使用shell脚本来启动容器。

Compose 通过一个配置文件来管理多个Docker容器，在配置文件中，所有的容器通过services来定义，然后使用docker-compose脚本来启动，停止和重启应用，和应用中的服务以及所有依赖服务的容器，非常适合组合使用多个容器进行开发的场景。

# 3.1 查找最新版的docker-compose

到 https://github.com/docker/compose/releases/ 地址查找最新的docker-compose版本

# 3.2 安装docker-compose

# 3.2.1 下载最新版的docker-compose文件

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 3.2.2 添加可执行权限

sudo chmod +x /usr/local/bin/docker-compose

# 3.2.3 测试安装结果

docker-compose --version

# 4 docker-compose概述

类似 docker 的Dockerfile文件，docker-compose使用 YAML 文件对容器进行管理。

# 4.1 相关概念

对于 docker-compose 有两个基本的概念：

服务(service)：一个应用容器，即 docker 容器，比如之前所说的mysql 容器、nginx 容器
项目(project)：由一组关联的应用容器组成的一个完整业务单元，比如上面所讲的由 mysql、web app、nginx 容器组成的网站，docker-compose 面向项目进行管理。

# 4.2 YAML 文件格式

大小写敏感，缩进表示表示层级关系
缩进空格数不重要，相同层级左侧对齐即可。（不允许使用 tab 缩进！）
由冒号分隔的键值对表示对象；一组连词线开头的行，构成一个数组；字符串默认不使用引号

# 4.3 Compose和Docker兼容性

Docker Engine 与docker-compose version 之间的有以下关系

compose文件格式版本	docker版本
3.4	17.09.0+
3.3	17.06.0+
3.2	17.04.0+
3.1	1.13.1+
3	1.13.0+
2.3	17.06.0+
2.2	1.13.0+
2.1	1.12.0+
2	1.10.0+
1	1.9.1.+

# 5 基本使用

接下来我们使用 docker-compose 构建我们的微服务以及mysql，并逐步讲解其使用。

# 5.1 准备工作

在项目文件夹下创建 docker-compose.yml文件

cd /usr/local/docker-learn/ && touch docker-compose.yml && ll

# 5.2 编写配置文件

先在 docker-compose.yml 文件里添加如下代码，构建我们的项目

version: '2'   
services:
    mysql:
        image: mysql:5.7.38
        hostname: mysql
        container_name: mysql
        restart: always
        networks:
            - learn-docker-network
        volumes:
            - "/tmp/etc/mysql:/etc/mysql/mysql.conf.d/"
            - "/tmp/data/mysql:/var/lib/mysql"
        environment:
            MYSQL_ROOT_PASSWORD: 'root'
    nacos:
        image: nacos/nacos-server
        hostname: nacos
        container_name: nacos
        restart: always
        ports:
            - "8848:8848"
        networks:
            - learn-docker-network
        environment:
            MODE: 'standalone'
            JVM_XMS: '128m'
            JVM_XMX: '128m'
    
    learn-docker-web:
        image: manager-hongbaoyu-java.itheima.net:8443/library/learn-docker-web:1.0-SNAPSHOT
        restart: always
        networks:
            - learn-docker-network
        depends_on:
            - nacos
            - mysql
        volumes:
            - "/tmp/data/logs:/logs"
    learn-docker-storage:
        image: manager-hongbaoyu-java.itheima.net:8443/library/learn-docker-storage:1.0-SNAPSHOT
        restart: always
        networks:
            - learn-docker-network
        depends_on:
            - nacos
            - mysql
        volumes:
            - "/tmp/data/logs:/logs"
    learn-docker-gateway:
        image: manager-hongbaoyu-java.itheima.net:8443/library/learn-docker-gateway:1.0-SNAPSHOT
        restart: always
        ports:
            - "8888:8888"
        networks:
            - learn-docker-network
        depends_on:
            - nacos
            - mysql
        volumes:
            - "/tmp/data/logs:/logs"
networks:
    learn-docker-network:
        driver: bridge

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# 5.3 运行测试

在项目的文件中执行docker-compose up -d命令就可以启动了

docker-compose up -d

# 5.4 微服务访问测试

通过网关地址访问测试微服务

curl http://192.168.64.153:8888/employeapi/find/10001| python -m json.tool

# 6 参数解释（手册）

# 6.1 version

指定 docker-compose.yml 文件的写法格式

`docker-compose.yml`的version版本号应该和docker的版本进行匹配，如果不匹配可能出现问题。

# 6.2 services

表示多个容器的集合

# 6.3 服务对象

docker-compose.yml管理是以服务为单位管理的，一个services下面可以有多个服务，mysql,app都代表一个服务

# 6.4 image

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

# 6.5 hostname

配置容器的host名称,在容器的hosts文件中加入了映射

# 6.6 container_name

配置启动后的容器名称和docker的--name xxx效果是一样的

# 6.7 restart

restart参数能够使我们在重启docker时，自动启动相关容器,和docker的--restart效果一致

Docker容器的重启策略如下

no，默认策略，在容器退出时不重启容器
on-failure，在容器非正常退出时（退出状态非0），才会重启容器
on-failure:3，在容器非正常退出时重启容器，最多重启3次
always，在容器退出时总是重启容器
unless-stopped，在容器退出时总是重启容器，但是不考虑在Docker守护进程启动时就已经停止了的容器

# 6.8 ports

映射端口的标签，对外暴露的端口定义，和 expose 对应，和docker的-p效果一致

# 6.9 depends_on

这个是依赖配置的选项，意思是如果服务启动是如果有依赖于其他服务的，先启动被依赖的服务，启动完成后在启动该服务

# 6.10 networks

配置容器所使用的网络

# 6.11 volumes

挂载一个目录或者一个已存在的数据卷容器，和docker -v效果一致

# 6.12 environment

配置环境变量，和docker的 -e效果一致

# 7 常用命令

# 7.1 docker-compose up

用于部署一个 Compose 应用

默认情况下该命令会读取名为 docker-compose.yml 或 docker-compose.yaml 的文件

，用户也可以使用 -f 指定其他文件名。通常情况下，会使用 -d 参数令应用在后台启动。

# 7.2 docker-compose stop

停止 Compose 应用相关的所有容器，但不会删除它们。

被停止的应用可以很容易地通过 docker-compose restart 命令重新启动。

如果带有服务命则停止该服务，否则停止所有服务

# 7.3 docker-compose rm

用于删除已停止的 Compose 应用

它会删除容器和网络，但是不会删除卷和镜像

如果带有服务命则删除该服务，否则删除所有服务

# 7.4 docker-compose restart

重启已停止的 Compose 应用。

如果用户在停止该应用后对其进行了变更，那么变更的内容不会反映在重启后的应用中，这时需要重新部署应用使变更生效。

# 7.5 docker-compose ps

用于列出 Compose 应用中的各个容器。

输出内容包括当前状态、容器运行的命令以及网络端口。

# 7.6 docker-compose down

停止并删除运行中的 Compose 应用。

它会删除容器和网络，但是不会删除卷和镜像。

# 8 扩缩容

# 8.1 nacos查看集群情况

我们可以查看nacos，查看当服务器集群的一个部署情况

# 8.2 扩容节点

我们现在对learn-docker-storage节点进行扩容

语法格式：docker-compose up -d --scale 服务名=节点数

docker-compose up -d --scale learn-docker-storage=2

启动后查看nacos节点信息

# 8.3 缩容节点

和扩容一样指定节点数量就可以的

docker-compose up -d --scale learn-docker-storage=1

停止后后查看nacos节点信息

上次更新: 2025/04/03, 11:07:08

← 集群管理-任务编排工具集群管理-Swarm集群编排→