Consul v1.18.0集群搭建

发布于

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

代码语言：bash
复制
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备份

验证

代码语言：bash
复制
$ 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)

单机启动

代码语言：bash
复制
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代理命令，使其更适合你的环境和需求。例如：

代码语言：bash
复制
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 后所产生的文件，可以使用以下命令

代码语言：bash
复制
# 查看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配置文件

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

代码语言：bash
复制
vim /etc/consul.d/consul.hcl

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

代码语言：bash
复制
# 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

}

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

代码语言：bash
复制
# 启动

consul agent -config-file=/etc/consul.d

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

常用命令

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

  1. 启动 Consul Agent：consul agent -config-file=<config_file>这个命令用于启动 Consul Agent，并指定配置文件。
  2. 加入集群：consul join <address>这个命令用于将当前节点加入到 Consul 集群中，<address> 是一个已存在的集群节点的地址。
  3. 离开集群：consul leave这个命令用于将当前节点从 Consul 集群中移除。
  4. 查看集群节点：consul members这个命令用于查看当前 Consul 集群中的成员节点列表。
  5. 查看 Leader：consul operator raft list-peers这个命令用于列出当前的 Consul 集群中的领导者节点。
  6. 手动推选 Leader：consul operator raft promote <node_id>这个命令用于手动推选指定节点为 Consul 集群的领导者。
  7. 重启集群节点：consul reload这个命令用于重新加载 Consul 配置文件并重启 Consul Agent。
  8. 查看服务列表：consul catalog services这个命令用于列出所有在 Consul 中注册的服务。
  9. 注册服务：consul services register <service.json>这个命令用于注册一个新的服务到 Consul 中，<service.json> 是包含服务定义的 JSON 文件。
  10. 移除服务：consul services deregister <service_id>这个命令用于从 Consul 中移除一个已注册的服务，<service_id> 是服务的唯一标识符。

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

注册user服务

使用kong 和Consul 集群 dns 服务

#微服务与微计算#consul