docker-compose启动consul

使用docker-compose搭建consul集群环境

consul是一个集群环境，用来管理微服务架构下面的服务发现和配置管理功能。

这篇文章是一个基础步骤如何搭建consul的docker集群环境。
我们使用docker-compose来搭建如下的consul集群环境：

1. 集群包含三个server：node1, node2, node3
2. 集群包含一个client：node4；并且在client上提供web UI访问服务。

1. 下载consul docker image

$ docker pull consul

1. 编辑docker-compose.yaml文件

version: '2'
networks:
  byfn:

services:
  consul1:
    image: consul
    container_name: node1
    command: agent -server -bootstrap-expect=3 -node=node1 -bind=0.0.0.0 -client=0.0.0.0 -datacenter=dc1
    networks:
      - byfn

  consul2:
    image: consul
    container_name: node2
    command: agent -server -retry-join=node1 -node=node2 -bind=0.0.0.0 -client=0.0.0.0 -datacenter=dc1
    depends_on:
        - consul1
    networks:
      - byfn

  consul3:
    image: consul
    container_name: node3
    command: agent -server -retry-join=node1 -node=node3 -bind=0.0.0.0 -client=0.0.0.0 -datacenter=dc1
    depends_on:
        - consul1
    networks:
      - byfn

  consul4:
    image: consul
    container_name: node4
    command: agent -retry-join=node1 -node=ndoe4 -bind=0.0.0.0 -client=0.0.0.0 -datacenter=dc1 -ui 
    ports:
      - 8500:8500
    depends_on:
        - consul2
        - consul3
    networks:
      - byfn

1. 启动服务

$ docker-compose up
$ docker exec -t node1 consul members
Node   Address          Status  Type    Build  Protocol  DC   Segment
node1  172.21.0.2:8301  alive   server  1.4.0  2         dc1  <all>
node2  172.21.0.4:8301  alive   server  1.4.0  2         dc1  <all>
node3  172.21.0.3:8301  alive   server  1.4.0  2         dc1  <all>
ndoe4  172.21.0.5:8301  alive   client  1.4.0  2         dc1  <default>

并且可以通过浏览器访问地址: http://localhost:8500 来查看集群信息。

1. 集群的使用

我这边只适用了存储服务，所以这里只有KV访问的例子。

$ docker exec -t node4 consul kv put foo "Hello foo"
$ docker exec -t node4 consul kv put foo/foo1 "Hello foo1"
$ docker exec -t node4 consul kv put foo/foo2 "Hello foo2"
$ docker exec -t node4 consul kv put foo/foo21 "Hello foo21"

$ docker exec -t node4 consul kv get foo
Hello foo

$ docker exec -t node4 consul kv get -detailed foo/foo1
CreateIndex      124
Flags            0
Key              foo/foo1
LockIndex        0
ModifyIndex      124
Session          -
Value            Hello foo1

$ docker exec -t node4 consul kv get -keys -separator="" foo
foo
foo/foo1
foo/foo2
foo/foo2/foo21

$ docker exec -t node4 consul kv get not-a-real-key
Error! No key exists at: not-a-real-key

1. consul基本概念

5.1 server模式和client模式
server模式和client模式是consul节点的类型；client不是指的用户客户端。

• server模式提供数据持久化功能。
• client模式不提供持久化功能，并且实际上他也不工作，只是把用户客户端的请求转发到server模式的节点。所以可以把client模式的节点想象成LB(load balance)，只负责请求转发。
• 通常server模式的节点需要配置成多个例如3个，5个。而client模式节点个数没有限制。

5.2 server模式启动的命令行参数

• -server：表示当前使用的server模式；如果没有指定，则表示是client模式。
• -node：指定当前节点在集群中的名称。
• -config-dir：指定配置文件路径，定义服务的；路径下面的所有.json结尾的文件都被访问；缺省值为：/consul/config。
• -data-dir： consul存储数据的目录；缺省值为：/consul/data。
• -datacenter：数据中心名称，缺省值为dc1。
• -ui：使用consul自带的web UI界面 。
• -join：加入到已有的集群中。
• -enable-script-checks： 检查服务是否处于活动状态，类似开启心跳。
• -bind： 绑定服务器的ip地址。
• -client： 客户端可访问ip，缺省值为：“127.0.0.1”，即仅允许环回连接。
• -bootstrap-expect：在一个datacenter中期望的server节点数目，consul启动时会一直等待直到达到这个数目的server才会引导整个集群。这个参数的值在同一个datacenter的所有server节点上必须保持一致。

这里说明一下，另外一个参数-bootstrap，用来控制一个server是否运行在bootstrap模式：当一个server处于bootstrap模式时，它可以选举自己为leader；注意在一个datacenter中只能有一个server处于bootstrap模式。所以这个参数一般只能用在只有一个server的开发环境中，在有多个server的cluster产品环境中，不能使用这个参数，否则如果多个server都标记自己为leader那么会导致数据不一致。另外该标记不能和-bootstrap-expect同时指定。

作者：CodingCode
链接：https://www.jianshu.com/p/b246ae1e1bcd
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。