Consul服务注册发现集群搭建

Consul 是一种用于服务发现、配置和分布式一致性的开源工具和平台。它由 HashiCorp 公司开发和维护,旨在简化构建和维护分布式系统的任务。

Consul 提供了许多功能,包括:

  1. 服务发现:Consul允许服务注册和发现。当服务启动时,它可以向Consul注册自己的位置和元数据。其他服务可以通过Consul查询来发现特定服务的位置,从而轻松实现服务之间的通信。

  2. 健康检查:Consul可以周期性地对服务进行健康检查,以确保它们正常工作。如果服务不再健康,则Consul可以自动将其标记为不可用,并将流量路由到其他健康的实例。

  3. KV存储:Consul包含一个分布式键/值存储系统,可以用于配置、功能标志和其他临时数据的存储。

  4. 多数据中心支持:Consul支持多数据中心集群,允许在不同地理位置部署多个Consul集群,并在它们之间进行通信和同步。

  5. 一致性保证:Consul使用Raft协议来确保数据的一致性和高可用性。它能够在节点故障或网络分区时继续正常运行。

  6. DNS接口:Consul提供了一个DNS接口,允许使用域名进行服务发现,而无需依赖专门的服务发现库。

总的来说,Consul是一个强大的工具,可以帮助开发人员和运维人员构建和管理可靠的分布式系统,简化了服务发现、配置管理和系统监控等任务。

下载安装Consul

Consulf官方下载链接

在这里插入图片描述
选择对应linux 安装consul

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
sudo yum -y install consul

国内加速阿里云Consul v1.18.0备份
验证


$ consul version
Consul v1.18.0
Revision 349cec17
Build Date 2024-02-26T22:05:50Z
Protocol 2 spoken by default, understands 2 to 3 (agent will automatically use protocol >2 when speaking to compatible agents)

单机启动

consul agent -dev -client=0.0.0.0

在运行Consul代理时,你可以通过一些参数来优化命令。这些参数可以帮助你更好地配置Consul:

  1. 指定数据中心:使用 -datacenter 参数可以指定Consul代理所属的数据中心。例如,-datacenter=mydc

  2. 指定节点名称:使用 -node 参数可以指定Consul代理的节点名称。例如,-node=myagent

  3. 开启UI界面:使用 -ui 参数可以启动Consul的Web UI界面,方便可视化管理。例如,-ui

  4. 指定日志级别:使用 -log-level 参数可以指定Consul代理的日志级别。例如,-log-level=info

  5. 开启gRPC API:使用 -grpc 参数可以开启Consul的gRPC API,允许使用gRPC接口与Consul进行交互。例如,-grpc

  6. 指定绑定地址:使用 -bind 参数可以指定Consul代理绑定的地址。例如,-bind=192.168.1.100

  7. 禁用DNS缓存:使用 -disable-host-node-id 参数可以禁用Consul的DNS缓存。例如,-disable-host-node-id

综合使用这些参数,你可以优化你的Consul代理命令,使其更适合你的环境和需求。例如:

consul agent -dev -client=0.0.0.0 -datacenter=mydc -node=myagent -ui -log-level=info -grpc -bind=192.168.1.100 -disable-host-node-id

这个命令将启动一个绑定到所有接口的Consul代理,使用名为mydc的数据中心,节点名称为myagent,开启了Web UI界面、gRPC API,并设置了日志级别为info

集群部署

要列出 rpm 安装 Consul 后所产生的文件,可以使用以下命令

# 查看yum下载安装consul
rpm -ql consul
/etc/consul.d/consul.env
/etc/consul.d/consul.hcl
/usr/bin/consul
/usr/lib/systemd/system/consul.service

这些文件的功能介绍如下:

  1. /etc/consul.d/consul.env: 这个文件通常用于设置 Consul 运行时的环境变量。环境变量可以影响 Consul 的行为,例如设置日志级别、数据目录路径等。在这个文件中,你可以配置一些 Consul 运行时所需的环境变量。

  2. /etc/consul.d/consul.hcl: 这是 Consul 的主要配置文件。在这个文件中,你可以配置 Consul 的各种选项,包括集群配置、数据中心、节点名称、绑定地址、广告地址、加入集群的地址、监听端口、日志设置等。通过编辑这个文件,你可以定制 Consul 的行为和功能。

  3. /usr/bin/consul: 这是 Consul 的可执行文件。通过执行这个文件,你可以启动 Consul Agent,并根据配置文件中的设置来运行 Consul。

  4. /usr/lib/systemd/system/consul.service: 这是 Consul 的 Systemd 服务单元文件。它定义了 Consul 作为 Systemd 服务的配置,包括服务的启动方式、依赖关系等。通过 Systemd,你可以使用 systemctl 命令来管理 Consul 服务的启动、停止、重启等操作。

这些文件是安装 Consul 包后在系统上生成的关键文件,用于配置和管理 Consul 的运行。通过修改配置文件,你可以调整 Consul 的行为,使其适应特定的需求和环境。

编辑Consul配置文件

以下是根据配置内容的重要性和功能进行分组,并添加了注释和适当的配置选项的配置文件示例:

vim /etc/consul.d/consul.hcl

配置文件名为consul.hcl,而 JSON 是另一种格式,通常使用 .json 扩展名。如果你要使用 HCL(HashiCorp Configuration Language)格式,你可以像下面这样编辑:

# Consul 配置文件

# 数据中心设置
datacenter = "dc1"

# 节点名称设置(注意:不可重名)
node_name = "consul-36"

# 数据目录设置
data_dir = "/opt/consul"

# 日志级别设置(可选值:TRACE, DEBUG, INFO, WARN, ERR)
log_level = "ERR"

# 绑定地址设置(监听所有 IPv6 地址和所有 IPv4 地址)
bind_addr = "[::]"
bind_addr = "0.0.0.0"

# 广播自己地址给集群访问(用于集群内部通信)
advertise_addr = "192.168.3.36"

# 加入集群的地址列表(需要提供至少一个已知的集群节点地址,:8301默认端口可省略)
retry_join = ["192.168.3.39:8301", "192.168.3.53", "192.168.3.54"]
# 用于指定 Consul Agent 在启动时尝试通过加入集群节点。
start_join = ["192.168.3.39", "192.168.3.53", "192.168.3.54"]

# 服务节点设置(是否为服务器节点)
server = true
# 这会告诉Consul在引导期间等待2个服务器节点就绪,然后再引导整个集群。
bootstrap_expect = 2

# 加密设置(consul keygen 生成的用于集群网络通信的加密)
encrypt = "KUZZ6X4oQhUvXeu+aN1EHL4DVgep8jk4ltflcLQ2DvQ="

# 客户端地址设置(用于监听客户端请求的地址)
client_addr = "0.0.0.0"

# UI 配置(用于启用内置的 Web UI)
ui_config {
enabled = true
content_path = "/ui/" #可自定义路径
}

# 默认端口设置
ports {
# HTTP API 端口(默认值:8500)与 Consul 进行交互,包括服务注册、UI、健康检查等
http = 8500
# DNS 端口(默认值:8600)用于提供 DNS 查询服务,允许客户端通过 DNS 协议来查询服务实例的地址
dns = 8600
# Serf LAN 端口(默认值:8301)局域网内进行集群节点间的通信
serf_lan = 8301
# Serf WAN 端口(默认值:8302) 广域网(WAN)内进行集群节点间的通信,用于跨数据中心的通信
serf_wan = 8302
# 服务器 RPC 端口(默认值:8300)服务器节点之间进行 RPC 通信
server = 8300
}

这个配置文件根据不同的功能进行了分组,并添加了注释以说明各个配置项的作用和用法。

# 启动
consul agent -config-file=/etc/consul.d

Consul 会在这个目录中寻找配置文件并加载。

常用命令

以下是一些常用的 Consul 集群管理命令:

  1. 启动 Consul Agent:
consul agent -config-file=<config_file>

这个命令用于启动 Consul Agent,并指定配置文件。

  1. 加入集群:
consul join <address>

这个命令用于将当前节点加入到 Consul 集群中,<address> 是一个已存在的集群节点的地址。

  1. 离开集群:
consul leave

这个命令用于将当前节点从 Consul 集群中移除。

  1. 查看集群节点:
consul members

这个命令用于查看当前 Consul 集群中的成员节点列表。

  1. 查看 Leader:
consul operator raft list-peers

这个命令用于列出当前的 Consul 集群中的领导者节点。

  1. 手动推选 Leader:
consul operator raft promote <node_id>

这个命令用于手动推选指定节点为 Consul 集群的领导者。

  1. 重启集群节点:
consul reload

这个命令用于重新加载 Consul 配置文件并重启 Consul Agent。

  1. 查看服务列表:
consul catalog services

这个命令用于列出所有在 Consul 中注册的服务。

  1. 注册服务:
consul services register <service.json>

这个命令用于注册一个新的服务到 Consul 中,<service.json> 是包含服务定义的 JSON 文件。

  1. 移除服务:
consul services deregister <service_id>

这个命令用于从 Consul 中移除一个已注册的服务,<service_id> 是服务的唯一标识符。

这些命令可以帮助你管理和维护 Consul 集群,确保其正常运行并满足你的需求。

posted @ 2024-03-29 22:37  程序员熊明才  阅读(135)  评论(0编辑  收藏  举报