# Docker-compose

# 1. 什么是docker-compose

Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose,您可以使用 YML 文件来配置应用程序需要的所有服务。然后,使用一个命令,就可以从 YML 文件配置中创建并启动所有服务。

Compose 使用的三个步骤:

    1) 使用 Dockerfile 定义应用程序的环境。
    2) 使用 docker-compose.yml 定义构成应用程序的服务,这样它们可以在隔离环境中一起运行。
    3) 最后,执行 docker-compose up 命令来启动并运行整个应用程序。
1
2
3
4
5
6
7

# 2. Docker-compose 的安装

linux

# Linux 上我们可以从 Github 上下载它的二进制包来使用,最新发行的版本地址:https://github.com/docker/compose/releases

# 1. 下载二进制包
# 不同的版本更换v2.2.2即可
sudo curl -L "https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 2. 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 3. 创建软连接,如果第一步直接下载到/usr/bin/docker-compose 目录下的,则可以省略该步骤
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# 4. 检查安装是否成功
docker-compose version
docker-compose version 1.25.1, build a82fef07
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

macos & windowns

# Mac和Windows 的 Docker 桌面版和 Docker Toolbox 已经包括 Compose 和其他 Docker 应用程序,,所以 Mac 用户不需要单独安装 docker-compose
1

# 3. docker-compose 的基本使用

# 3.1 docker-compose.yaml

创建一个docker-compose.yml文件

version: '3'
services:
  mysql:
    image: "mysql:8.0"  # 指定镜像
    ports:
     - "6379:6379"  # 端口映射
1
2
3
4
5
6

启动&停止docker-compose

# 下述操作,如果文件名为docker-compose.yml,那可以不用指定-f $file_name 参数

# 1. 直接执行
docker-compose up

# 2. 后台执行
docker-compose up -d

# 3. 如果文件名称不叫docker-compose,这可以指定文件名
docker-compose -f $file_name up

# 4. 停止容器
docker-compose -f $file_name down # 终止compose,彻底终止,包括compose的资源也会被清楚

docker-compose  -f $file_name stop # 停止当前compose,可以通过start再次启动,回到stop之前的状态

# 5. 重启compose
docker-compose -f $file_name restart # 知识重启compose

# 也可以使用down之后在up
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

docker-compose 常见参数选项

# 1. 指定本 yml 依从的 compose 哪个版本制定的。
version 
1
2
# 2. 添加或删除容器拥有的宿主机的内核功能。
cap_add:
  - ALL # 开启全部权限
cap_drop:
  - SYS_PTRACE # 关闭 ptrace权限
1
2
3
4
5
# 3. cgroup_parent 为容器指定父 cgroup 组,意味着将继承该组的资源限制
cgroup_parent: m-executor-abcd
1
2
# 4. command 覆盖容器启动的默认命令
command: ["bash", "echo hello"]
1
2
# 5. container_name 指定自定义容器名称,而不是生成的默认名称
container_name: my_redis
1
2
# 6. depends_on 设置依赖关系:
    docker-compose up   # 以依赖性顺序启动服务。在以下示例中,先启动 db 和 redis ,才会启动 web。
    docker-compose up SERVICE  #自动包含 SERVICE 的依赖项。在以下示例中,docker-compose up web 还将创建并启动 db 和 redis
    docker-compose stop   #按依赖关系顺序停止服务。在以下示例中,web 在 db 和 redis 之前停止。
1
2
3
4
# 7. endpoint_mode:访问集群服务的方式。
    # Docker 集群服务一个对外的虚拟 ip。所有的请求都会通过这个虚拟 ip 到达集群服务内部的机器。
    endpoint_mode: vip  
    # DNS 轮询(DNSRR)。所有的请求会自动轮询获取到集群 ip 列表中的一个 ip 地址。
    endpoint_mode: dnsrr   
1
2
3
4
5
# 8. 在服务上设置标签。可以用容器上的 labels(跟 deploy 同级的配置) 覆盖 deploy 下的 labels。
labels

1
2
3
# 9. mode:指定服务提供的模式。
    # 复制服务,复制指定服务到集群的机器上。
    replicated 
    #全局服务,服务将部署至集群的每个节点
    global  
1
2
3
4
5
# 10. 暴露端口,但不映射到宿主机,只被连接的服务访问
expose  
1
2
# 11. 指定容器运行的镜像
image   
1
2
# 12. restart  # 重启策略
    no:是默认的重启策略,在任何情况下都不会重启容器。
    always:容器总是重新启动。
    on-failure:在容器非正常退出时(退出状态非0),才会重启容器。
    unless-stopped:在容器退出时总是重启容器,但是不考虑在Docker守护进程启动时就已经停止了的容器
1
2
3
4
5
# 13将主机的数据卷或着文件挂载到容器里。
volumes 
1
2

更多的参数选项直接使用docker-compose --help即可查看

[root@iZ2ze58f53sxjm9z7mgn5xZ ~]# docker-compose --help
Define and run multi-container applications with Docker.

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

Options:
  -f, --file FILE             Specify an alternate compose file
                              (default: docker-compose.yml)
  -p, --project-name NAME     Specify an alternate project name
                              (default: directory name)
  --verbose                   Show more output
  --log-level LEVEL           Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
  --no-ansi                   Do not print ANSI control characters
  -v, --version               Print version and exit
  -H, --host HOST             Daemon socket to connect to

  --tls                       Use TLS; implied by --tlsverify
  --tlscacert CA_PATH         Trust certs signed only by this CA
  --tlscert CLIENT_CERT_PATH  Path to TLS certificate file
.............
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 4. docker-compose 搭建kafka集群案例

version: "3.7"
services:
  zookeeper:
    container_name: zk
    image: wurstmeister/zookeeper
    restart: always
    volumes:
      - ./data:/data
    ports:
      - 2181:2181

  kafka1:
    container_name: kafka1
    image: wurstmeister/kafka
    restart: always
    ports:
      - 9092:9092
    environment:
      KAFKA_BROKER_ID: 1
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://8.141.175.100:9092
      KAFKA_ADVERTISED_HOST_NAME: 8.141.175.100          # 如果设置,则就作为broker 的hostname发往producer、consumers以及其他brokers
#      KAFKA_CREATE_TOPICS: "myTopic:3" #kafka启动后初始化一个有3个partition(分区)0个副本名叫myTopic的topic
      KAFKA_ZOOKEEPER_CONNECT: zk:2181          # zookeeper集群连接地址
      KAFKA_ADVERTISED_PORT: 9092            # 此端口将给与producers、consumers、以及其他brokers,它会在建立连接时用到
      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9092
      KAFKA_HEAP_OPTS: "-Xmx256M -Xms128M"
      ALLOW_PLAINTEXT_LISTENER: 'true'
    volumes:
      - ./kafka1-logs:/kafka
    depends_on:
      - zookeeper
  kafka2:
    container_name: kafka2
    image: wurstmeister/kafka
    restart: always
    ports:
      - 9093:9093
    environment:
      KAFKA_BROKER_ID: 2
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://8.141.175.100:9093
      KAFKA_ADVERTISED_HOST_NAME: 8.141.175.100
      # KAFKA_CREATE_TOPICS: "myTopic:3" #kafka启动后初始化一个有3个partition(分区)0个副本名叫myTopic的topic
      KAFKA_ZOOKEEPER_CONNECT: zk:2181
      KAFKA_ADVERTISED_PORT: 9093
      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9093
      KAFKA_HEAP_OPTS: "-Xmx256M -Xms128M"
      ALLOW_PLAINTEXT_LISTENER: 'true'
    volumes:
      - ./kafka2-logs:/kafka
    depends_on:
      - zookeeper
  kafka3:
    container_name: kafka3
    image: wurstmeister/kafka
    restart: always
    ports:
      - 9094:9094
    environment:
      KAFKA_BROKER_ID: 3
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://8.141.175.100:9094
      KAFKA_ADVERTISED_HOST_NAME: 8.141.175.100
      # KAFKA_CREATE_TOPICS: "myTopic:3" #kafka启动后初始化一个有3个partition(分区)0个副本名叫myTopic的topic
      KAFKA_ZOOKEEPER_CONNECT: zk:2181
      KAFKA_ADVERTISED_PORT: 9094
      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9094
      KAFKA_HEAP_OPTS: "-Xmx256M -Xms128M"
      ALLOW_PLAINTEXT_LISTENER: 'true'
    volumes:
      - ./kafka3-logs:/kafka
    depends_on:
      - zookeeper

# 启动:
docker-compose -f $docker-compose-file-name up -d
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
64
65
66
67
68
69
70
71
72
73
74
Last Updated: 5/5/2023, 2:33:10 AM