# Docker compose单机编排

## Docker Compose 简介

当在宿主机上启动多个容器时，手动操作会比较繁琐，且容易出错。在这种情况下，推荐使用 Docker 单机编排工具 **Docker Compose**。Docker Compose 是 Docker 官方提供的一个开源工具，用于管理和编排多个容器。它可以解决容器之间的依赖关系，简化容器的创建、启动和停止操作。

例如，启动一个 Nginx 前端服务时，可能需要调用后端的 Tomcat 服务，而 Tomcat 容器又依赖于数据库。在这种嵌套依赖关系中，Docker Compose 可以按照正确的顺序启动这些容器，确保每个容器在启动时都能正确依赖所需的其他容器。因此，Docker Compose 完全可以替代 `docker run` 来创建和管理容器。

## Docker Compose 项目结构

Docker Compose 项目将所管理的容器分为三层，分别是：

- **工程（Project）**：工程是 Docker Compose 管理的最高层级，通常对应一个包含多个服务的应用场景。一个工程可以包含多个服务，这些服务通过 `docker-compose.yml` 文件进行定义。
- **服务（Service）**：服务是工程中的一个逻辑单元，通常对应一个容器模板。服务定义了容器的镜像、环境变量、端口映射等配置。一个服务可以启动多个容器实例。
- **容器（Container）**：容器是服务的具体运行实例。Docker Compose 会根据服务的定义创建并管理容器。

通过这种分层结构，Docker Compose 能够高效地管理和编排多个容器，简化复杂的容器依赖关系，提高开发和部署效率。

# 基础环境准备

## Docker compose部署

yum安装docker-compese

从 Docker 20.10 版本开始，Docker Compose 被集成到了 Docker 中，作为插件使用，而不是独立的命令行工具，所以说在20以后的版本中，我们直接使用docker compose(中间用空格隔开)即可

```bash
# 旧版本中安装docker-compose的方式
[root@localhost ~]# yum install -y epel-release
[root@localhost ~]# yum install docker-compose.noarch -y
[root@localhost ~]# docker-compose version
docker-compose version 1.18.0, build 8dd22a9
docker-py version: 2.6.1
CPython version: 3.6.8
OpenSSL version: OpenSSL 1.0.2k-fips  26 Jan 2017
```

## 相关参数

```bash
# docker-compose --help

Define and run multi-container applications with Docker.

## Usage
```bash
docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]
docker-compose -h|--help
```

### 选项说明

- `-f`, `--file FILE`：指定 Compose 模板文件，默认为 `docker-compose.yml`。
- `-p`, `--project-name NAME`：指定项目名称，默认将使用当前所在目录名称作为项目名。
- `--verbose`：显示更多输出信息。
- `--log-level LEVEL`：定义日志级别 (DEBUG, INFO, WARNING, ERROR, CRITICAL)。
- `--no-ansi`：不显示 ANSI 控制字符。
- `-v`, `--version`：显示版本。

### 命令选项

以下命令需要在 `docker-compose.yml` 或 `yaml` 文件所在目录里执行。

- `build`：构建或重新构建服务中定义的镜像。
- `bundle`：从当前 `docker-compose` 文件生成一个以 `<当前目录>` 为名称的 JSON 格式的 Docker Bundle 文件，用于离线部署。
- `config -q`：验证 Compose 文件格式是否正确，若无错误则不输出任何内容。
- `create`：创建服务所需的所有容器，但不启动它们。
- `down`：停止和删除所有容器、网络、卷，以及由 `docker-compose up` 创建的镜像（可选）。
- `events`：实时显示容器的日志事件，支持指定日志格式（如 JSON）。
- `exec`：在指定的容器中运行一个命令。
- `help`：显示指定命令的帮助信息。
- `images`：列出所有由 `docker-compose` 创建的镜像。
- `kill`：强制终止正在运行的容器。
- `logs`：查看容器的日志输出。
- `pause`：暂停服务中的所有容器。
- `port`：查看服务的端口映射情况。
- `ps`：列出所有由 `docker-compose` 管理的容器。
- `pull`：从镜像仓库拉取服务中定义的镜像。
- `push`：将服务中定义的镜像推送到镜像仓库。
- `restart`：重启服务中的所有容器。
- `rm`：删除所有已停止的容器。
- `run`：在指定服务中运行一个命令，创建一个临时容器。
- `scale`：设置指定服务运行的容器数量。
- `start`：启动已创建但未运行的服务。
- `stop`：停止正在运行的服务。
- `top`：显示正在运行的容器的进程信息。
- `unpause`：恢复之前暂停的服务。
- `up`：构建、创建并启动所有服务，如果服务已存在则重新启动。

### 示例 `docker-compose.yml` 文件

以下是一个详细的 `docker-compose.yml` 文件示例，包含注释和可能用到的所有指令。这个示例展示了如何定义一个包含多个服务（如 Nginx、Tomcat 和 MySQL）的 Docker Compose 项目。

```yaml
# docker-compose.yml

# 定义版本，指定 Compose 文件的格式版本
version: '3.8'

# 定义服务
services:
  # 定义 MySQL 服务
  mysql:
    # 使用的镜像名称
    image: mysql:5.7
    # 容器的名称
    container_name: mysql_container
    # 环境变量，用于设置 MySQL 的 root 密码
    environment:
      MYSQL_ROOT_PASSWORD: mypassword
      MYSQL_DATABASE: mydb
    # 持久化数据卷
    volumes:
      - mysql_data:/var/lib/mysql
    # 端口映射，将宿主机的 3306 端口映射到容器的 3306 端口
    ports:
      - "3306:3306"
    # 重启策略，始终重启
    restart: always
    # 网络配置，连接到默认网络
    networks:
      - my_network

  # 定义 Tomcat 服务
  tomcat:
    # 使用的镜像名称
    image: tomcat:9.0
    # 容器的名称
    container_name: tomcat_container
    # 环境变量，设置 Tomcat 的一些配置
    environment:
      - CATALINA_OPTS=-Xms512M -Xmx1024M
    # 持久化 Tomcat 的 webapps 目录
    volumes:
      - tomcat_webapps:/usr/local/tomcat/webapps
    # 端口映射，将宿主机的 8080 端口映射到容器的 8080 端口
    ports:
      - "8080:8080"
    # 依赖关系，确保 MySQL 服务先启动
    depends_on:
      - mysql
    # 重启策略，始终重启
    restart: always
    # 网络配置，连接到默认网络
    networks:
      - my_network

  # 定义 Nginx 服务
  nginx:
    # 使用的镜像名称
    image: nginx:1.19
    # 容器的名称
    container_name: nginx_container
    # 持久化 Nginx 的配置文件和静态资源
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./html:/usr/share/nginx/html
    # 端口映射，将宿主机的 80 端口映射到容器的 80 端口
    ports:
      - "80:80"
    # 依赖关系，确保 Tomcat 服务先启动
    depends_on:
      - tomcat
    # 重启策略，始终重启
    restart: always
    # 网络配置，连接到默认网络
    networks:
      - my_network

# 定义卷
volumes:
  # 定义 MySQL 数据卷
  mysql_data:
    driver: local
  # 定义 Tomcat webapps 卷
  tomcat_webapps:
    driver: local

# 定义网络
networks:
  # 定义默认网络
  my_network:
    driver: bridge
```

### 文件说明

1. **版本**：
   - `version: '3.8'`：指定 Compose 文件的格式版本。不同的版本支持不同的功能和语法。
2. **服务**：
   - `services`：定义项目中包含的所有服务。
   - 每个服务（如 `mysql`、`tomcat`、`nginx`）都有自己的配置，包括：
     - `image`：指定使用的 Docker 镜像。
     - `container_name`：指定容器的名称。
     - `environment`：设置环境变量。
     - `volumes`：定义数据卷，用于持久化数据或挂载本地文件。
     - `ports`：定义端口映射。
     - `depends_on`：定义服务之间的依赖关系。
     - `restart`：设置重启策略。
     - `networks`：定义服务所属的网络。
3. **卷**：
   - `volumes`：定义数据卷，用于持久化数据。这里定义了两个卷：`mysql_data` 和 `tomcat_webapps`。
4. **网络**：
   - `networks`：定义网络，用于服务之间的通信。这里定义了一个默认的桥接网络 `my_network`。

### 可能用到的 Docker Compose 命令

以下是在 `docker-compose.yml` 文件所在目录中可以执行的常用命令：

- **`docker-compose up`**：构建、创建并启动所有服务。如果服务已存在，则重新启动。
- **`docker-compose down`**：停止并删除所有容器、网络、卷以及由 `docker-compose up` 创建的镜像（可选）。
- **`docker-compose build`**：构建或重新构建服务中定义的镜像。
- **`docker-compose create`**：创建服务所需的所有容器，但不启动它们。
- **`docker-compose start`**：启动已创建但未运行的服务。
- **`docker-compose stop`**：停止正在运行的服务。
- **`docker-compose restart`**：重启服务中的所有容器。
- **`docker-compose kill`**：强制终止正在运行的容器。
- **`docker-compose rm`**：删除所有已停止的容器。
- **`docker-compose logs`**：查看容器的日志输出。
- **`docker-compose exec`**：在指定的容器中运行一个命令。
- **`docker-compose ps`**：列出所有由 `docker-compose` 管理的容器。
- **`docker-compose config`**：验证 Compose 文件格式是否正确，若无错误则不输出任何内容。
- **`docker-compose bundle`**：从当前 `docker-compose` 文件生成一个 JSON 格式的 Docker Bundle 文件，用于离线部署。
- **`docker-compose pull`**：从镜像仓库拉取服务中定义的镜像。
- **`docker-compose push`**：将服务中定义的镜像推送到镜像仓库。
- **`docker-compose scale`**：设置指定服务运行的容器数量。

# 实战案例

## 启动单个容器

一、编写docker-compose文件

```yaml
[root@localhost ~]# mkdir -pv docker-compose/nginx
[root@localhost ~]# cd docker-compose/nginx
[root@localhost nginx]# pwd
/root/docker-compose/nginx
[root@localhost nginx]# vim docker-compose.yml
# docker-compose.yml

services:
  nginx:
    image: nginx
    container_name: nginx_web1
    restart: always
    ports:
      - "80:80"
    volumes:
      - /data/web:/usr/share/nginx/html
```

二、启动容器

```bash
[root@localhost nginx]# docker compose up -d
[+] Running 2/2
 ✔ Network nginx_default  Created                                             0.0s
 ✔ Container nginx_web1   Started                                             0.2s
[root@localhost nginx]# docker ps
CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS          PORTS                                 NAMES
09d091a0c1a1   nginx     "/docker-entrypoint.…"   29 seconds ago   Up 28 seconds   0.0.0.0:80->80/tcp, [::]:80->80/tcp   nginx_web1

# 不指定网络的话，会默认创建一个类型为bridge的网络
[root@localhost nginx]# docker network ls
NETWORK ID     NAME            DRIVER    SCOPE
36f9c2f8e090   bridge          bridge    local
93ffe4510dd0   host            host      local
d0456365c64d   nginx_default   bridge    local
61f0d0d9b051   none            null      local
```

三、访问测试


## 启动多个容器

一、编辑docker-compose文件

```bash
[root@localhost docker]# cat docker-compose.yml 
service-nginx:
  image: nginx
  container_name: nginx_web1
  ports:
    - "80:80"

service-tomcat:
  image: tomcat
  container_name: tomcat_web1
  ports:
    - "8080:8080"
[root@localhost docker]# docker-compose up -d
nginx_web1    /docker-entrypoint.sh ngin ...   Up      0.0.0.0:80->80/tcp,:::80->80/tcp                              
tomcat_web1   catalina.sh run                  Up      0.0.0.0:8080->8080/tcp,:::8080-
                                                       >8080/tcp
```

## 定义数据卷挂载

- 创建数据卷目录和文件

```bash
[root@localhost docker]# mkdir -p /data/nginx
[root@localhost docker]# echo 'docker nginx' > /data/nginx/index.html
```

- 编辑配置文件

```bash
[root@localhost docker]# cat docker-compose.yml 
service-nginx:
  image: nginx
  container_name: nginx_web1
  volumes:
    - /data/nginx/:/usr/share/nginx/html
  ports:
    - "80:80"

service-tomcat:
  image: tomcat
  container_name: tomcat_web1
  ports:
    - "8080:8080"
```

- 访问测试

```bash
[root@localhost docker]# curl localhost
docker nginx
```

# Docker Compose部署LNMP实战

## 部署LNMP环境

- 使用docker-compose实现编排nginx+phpfpm+mysql容器
- 部署一个博客系统
- 首先编写一个如下的配置文件

```yaml
services:
  web:
    image: nginx:latest
    restart: always
    ports:
      - 80:80
    volumes:
      - /data/lnmp/nginx/conf.d:/etc/nginx/conf.d
      - /data/lnmp/nginx/html:/usr/share/nginx/html
      - /data/lnmp/nginx/log:/var/log/nginx
    depends_on:
      - php
      - mysql
    networks:
      - lnmp-network
  php:
    image: php:7.4-fpm
    restart: always
    volumes:
      - /data/lnmp/nginx/html:/usr/share/nginx/html
    networks:
      - lnmp-network
    depends_on:
      - mysql
  mysql:
    image: mysql:5.7
    restart: always
    volumes:
      - /data/lnmp/dbdata:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: "123456"
      MYSQL_DATABASE: login
    networks:
      - lnmp-network
networks:
  lnmp-network:
    driver: bridge
volumes:
  dbdata: null
```

运行docker-compose.yml

```bash
[root@localhost lnmp]# docker compose up -d
[root@localhost lnmp]# docker ps
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                                 NAMES
825b8630de47   nginx:latest   "/docker-entrypoint.…"   4 minutes ago   Up 4 minutes   0.0.0.0:80->80/tcp, [::]:80->80/tcp   lnmp-web-1
d1d6339ba0d7   lnmp-php       "docker-php-entrypoi…"   4 minutes ago   Up 4 minutes   9000/tcp                              lnmp-php-1
109672c0b1f0   mysql:5.7      "docker-entrypoint.s…"   4 minutes ago   Up 4 minutes   3306/tcp, 33060/tcp                   lnmp-mysql-1
```

在 `/data/lnmp/nginx/conf.d/default.conf` 中写入nginx 的配置文件

```shell
server {
  listen 80;
  root /usr/share/nginx/html;
  location / {
    index index.php index.html;
  }

  location ~ \.php$ {
    fastcgi_pass php:9000;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
  }
}
```

准备探针测试

在 `/data/lnmp/nginx/html/info.php` 中准备php探针

```shell
<?php
	phpinfo();
?>
```

测试数据库连接

在`/data/lnmp/nginx/html/mysql.php`中准备php探针

```shell
<?php
  $dbhost = "mysql";
  $dbuser = "root";
  $dbpass = "123456";
  $db = "login";
  $conn = mysqli_connect($dbhost, $dbuser, $dbpass, $db) or exit("数据库连接失败！");
  echo "数据库连接成功";
?>
```

访问测试后发现，连接mysql报错，提示找不到mysqli_connect()，看来是官方构建的php没有mysqli模块

所以我们需要定制带有mysqli模块的php，编写如下dockerfile

```shell
FROM php:7.4-fpm
ENV TZ=Asia/Shanghai
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini" \
  && sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list \
  && sed -i -e 's|security.debian.org/\? |security.debian.org/debian-security |g' \
  -e 's|security.debian.org|mirrors.ustc.edu.cn|g' \
  -e 's|deb.debian.org/debian-security|mirrors.ustc.edu.cn/debian-security|g' \
  /etc/apt/sources.list \
  && apt-get update && apt-get install -y \
  libfreetype6-dev \
  libjpeg62-turbo-dev \
  libpng-dev \
  && docker-php-ext-configure gd -with-freetype -with-jpeg \
  && docker-php-ext-install -j$(nproc) gd mysqli && docker-php-ext-enable mysqli
```

然后修改 docker-compose.yml 文件如下

```yaml
# docker-compose build lnmp

services:
  web:
    image: nginx:latest
    restart: always
    ports:
      - 80:80
    volumes:
      - /data/lnmp/nginx/conf.d:/etc/nginx/conf.d
      - /data/lnmp/nginx/html:/usr/share/nginx/html
      - /data/lnmp/nginx/log:/var/log/nginx
    depends_on:
      - php
      - mysql
    networks:
      - lnmp-network
  php:
    # image: dockerfile:php:7.4-fpm
    # 这里来让compose自动构建，指定dockerfile的文件位置即可
    build:
      context: .
      dockerfile: dockerfile
    restart: always
    volumes:
      - /data/lnmp/nginx/html:/usr/share/nginx/html
    networks:
      - lnmp-network
    depends_on:
      - mysql
  mysql:
    image: mysql:5.7
    restart: always
    volumes:
      - /data/lnmp/dbdata:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: "123456"
      MYSQL_DATABASE: login
    networks:
      - lnmp-network
networks:
  lnmp-network:
    driver: bridge
volumes:
  dbdata: null
```

测试验证

```shell
[root@localhost lnmp]# docker compose up -d
[root@localhost lnmp]# docker ps
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                                 NAMES
825b8630de47   nginx:latest   "/docker-entrypoint.…"   4 minutes ago   Up 4 minutes   0.0.0.0:80->80/tcp, [::]:80->80/tcp   lnmp-web-1
d1d6339ba0d7   lnmp-php       "docker-php-entrypoi…"   4 minutes ago   Up 4 minutes   9000/tcp                              lnmp-php-1
109672c0b1f0   mysql:5.7      "docker-entrypoint.s…"   4 minutes ago   Up 4 minutes   3306/tcp, 33060/tcp                   lnmp-mysql-1
```