Docker 安装 Consul

发表于 阅读次数： 评论数： 本文字数： 1.9k 阅读时长 ≈ 2 分钟

前言

拉取 Consul 镜像

1
2
3
4
5
# 拉取最新版本的镜像
# docker pull consul:latest

# 拉取指定版本的镜像
# docker pull consul:1.7.3

Docker 安装 Consul 单机

Docker 安装

  • 创建并启动容器，默认是以开发模式启动，数据保存在内存中
1
# docker run -d --name=consul -p 8500:8500 -e CONSUL_BIND_INTERFACE=eth0 consul:1.7.3
  • 若需要持久化 Consul 的数据，则需要挂载数据卷和指定数据目录，并以服务器模式启动
1
$ docker run -d --name=consul -p 8500:8500 -v /path/on/host:/consul/data -e CONSUL_BIND_INTERFACE=eth0 consul:1.7.3 agent -server -bootstrap-expect=1 -data-dir=/consul/data -client=0.0.0.0 -ui

Docker Compose 安装

  • Docker Compose 可以使用以下配置内容创建并启动容器，默认是以开发模式启动，数据保存在内存中
1
2
3
4
5
6
7
8
9
10
11
version: '3.5'

services:
  consul:
    image: consul:1.7.3
    container_name: consul
    restart: always
    ports:
      - "8500:8500"
    environment:
      CONSUL_BIND_INTERFACE: eth0
  • 若需要持久化 Consul 的数据，则需要挂载数据卷和指定数据目录，并以服务器模式启动
1
2
3
4
5
6
7
8
9
10
11
12
13
14
version: '3.5'

services:
  consul:
    image: consul:1.7.3
    container_name: consul
    restart: always
    ports:
      - "8500:8500"
    environment:
      CONSUL_BIND_INTERFACE: eth0
    command: agent -server -bootstrap-expect=1 -data-dir=/consul/data -client=0.0.0.0 -ui
    volumes:
      - '/path/on/host:/consul/data'

访问 Consul 的管理界面

Consul 默认会以开发模式启动，数据保存在内存中，重启后会丢失数据，而且默认会启用 Web UI。在开发模式下，可以直接通过 8500 端口访问 Consul 的 UI 管理界面。

Docker 安装 Consul 集群

开发模式下的集群

这里将演示在开发模式下，如何创建拥有 3 个节点的 Consul 集群，数据默认保存在内存中。这对于开发阶段很有用，但不应该在生产中使用。值得一提的是，在开发模式下可以直接通过 8500 端口访问 Consul 的 UI 管理界面。

Docker 安装

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
# 创建并启动第一个节点
# docker run -d --name=consul-node1 -p 8500:8500 -e CONSUL_BIND_INTERFACE=eth0 consul:1.7.3

# 查看第一个节点的IP
# docker inspect -f='{{.NetworkSettings.IPAddress}}' consul-node1

# 创建并启动第二个节点，172.17.0.3是第一个节点的IP
# docker run -d --name=consul-node2 -p 8500:8500 -e CONSUL_BIND_INTERFACE=eth0 consul:1.7.3 agent -dev -join=172.17.0.3

# 创建并启动第三个节点，172.17.0.3是第一个节点的IP
# docker run -d --name=consul-node3 -p 8500:8500 -e CONSUL_BIND_INTERFACE=eth0 consul:1.7.3 agent -dev -join=172.17.0.3

#　查看容器的运行状态
# docker ps
CONTAINER ID    IMAGE           COMMAND                  CREATED             STATUS              PORTS                                                        NAMES
1ac5832f79f4    consul:1.7.3    "docker-entrypoint.s…"   31 seconds ago      Up 30 seconds       8300-8302/tcp, 8500-8500/tcp, 8301-8302/udp, 8600/tcp, 8600/udp   consul-node3
533b0f12877a    consul:1.7.3    "docker-entrypoint.s…"   56 seconds ago      Up 55 seconds       8300-8302/tcp, 8500-8500/tcp, 8301-8302/udp, 8600/tcp, 8600/udp   consul-node2
d25f90dffa94    consul:1.7.3    "docker-entrypoint.s…"   2 minutes ago       Up 2 minutes        8300-8302/tcp, 8500-8500/tcp, 8301-8302/udp, 8600/tcp, 8600/udp   consul-node1

# 在第一个容器中运行consul命令来查询集群中的所有成员
# docker exec -t consul-node1 consul members
Node          Address          Status  Type    Build  Protocol  DC   Segment
1ac5832f79f4  172.17.0.5:8301  alive   server  1.7.3  2         dc1  <all>
533b0f12877a  172.17.0.4:8301  alive   server  1.7.3  2         dc1  <all>
d25f90dffa94  172.17.0.3:8301  alive   server  1.7.3  2         dc1  <all>

# 访问Web管理界面
# 浏览器访问：http://172.17.0.3:8500

Consul 容器的数据持久化

在 Consul 容器内，有两个核心目录，分别是：

  • /consul/data：Consul 容器内部存放数据的目录
  • /consul/config：Consul 容器内部存放配置文件的目录

在开发模式下启动 Consul 容器，数据默认保存在内存中，容器重启后数据会丢失。若想使用 Docker 的数据卷来持久化容器内的数据，则需要使用服务器模式启动 Consul，并通过启动参数 -data-dir 来指定 Consul 的数据目录。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
version: '3.5'

services:
  consul:
    image: consul:1.7.3
    container_name: consul
    restart: always
    ports:
      - "8500:8500"
    environment:
      CONSUL_BIND_INTERFACE: eth0
    command: agent -server -bootstrap-expect=1 -data-dir=/consul/data -client=0.0.0.0 -ui
    volumes:
      - '/path/on/host:/consul/data'

配置信息说明：

  • /path/on/host：在宿主机内部存放数据的目录
  • /consul/data：在 Consul 容器内部存放数据的目录

Consul 的常用启动参数

参数使用示例描述
-dev以开发模式启动 Consul。在开发模式下，Consul 会自动配置为一个单节点服务器，不需要进行集群的配置，而且不会持久化数据到磁盘，但默认会启用 Web UI。所有的操作都是在本地进行的，不涉及到其他节点。
-server启动一个 Consul 服务器节点。服务器节点负责处理集群状态、选举领导者、存储服务目录等。
-ui启用 Consul 的内置 Web UI 界面。启用后，可以通过浏览器访问 Consul 的图形用户界面，查看服务、KV 存储等内容。
-bind-bind=127.0.0.1指定 Consul 绑定的 IP 地址，这个地址通常是 Consul 用来与其他节点通信的地址。比如绑定了 127.0.0.1，表示 Consul 只能与本机上的其他应用程序通信。
-client-client=0.0.0.0指定 Consul 客户端的监听地址，0.0.0.0 是一个通配符地址，表示接受所有网络接口的客户端连接。
-data-dir-data-dir=/opt/consul/data/指定 Consul 的数据存储目录，所有的持久化数据（如服务注册信息、KV 数据等）将存储在该目录下。
-config-dir-config-dir=/opt/consul/config/指定一个目录，该目录中包含配置文件，Consul 在启动时会加载这些配置文件。
-node-node=node1指定节点的名称，默认为主机名。如果在同一网络中有多个节点运行，最好为每个节点指定唯一的名称。
-datacenter-datacenter=dc1指定数据中心的名称，默认为 dc1。适用于在多个数据中心部署 Consul 的场景。
-bootstrap-expect-bootstrap-expect 1指定预期启动的服务器数量，这个值通常用于集群的初始化。设置为 1 表示这是一个单节点集群，只需一个服务器节点启动即可。
-join-join=192.168.0.3指定要加入的现有集群节点的地址。启动时 Consul 会自动加入这个地址的节点所在的集群。
-advertise-advertise=192.168.0.4指定 Consul 对其他节点通告的 IP 地址。通常用于 NAT 环境中，内网和外网 IP 不一致的情况。
-encrypt-encrypt=xxxxx设置用于加密集群中节点之间通信的密钥（Gossip 协议）。
log-level-log-level=DEBUG设置日志的级别。常用级别包括 INFO、DEBUG、WARN、ERR 等。
  • Consul 以开发模式启动的命令如下
1
consul agent -dev -client=0.0.0.0
  • Consul 服务器节点的启动命令如下：
1
consul agent -server -bootstrap-expect=3 -data-dir=/opt/consul/data -node=server1 -bind=192.168.1.100 -client=0.0.0.0 -ui

参考资料