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
來源：簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權，非商業轉載請注明出處。