Skip to main content

Consul 部署与使用指南

Consul 部署与使用指南

Consul 是 HashiCorp 公司推出的服务网格解决方案，提供服务发现、健康检查、键值存储和多数据中心支持等功能。以下是 Consul 的完整部署与使用手册。

一、Consul 部署方案

1. 单机模式（开发环境）

# 下载 Consul (Linux 示例)
wget https://releases.hashicorp.com/consul/1.15.3/consul_1.15.3_linux_amd64.zip
unzip consul_1.15.3_linux_amd64.zip
sudo mv consul /usr/local/bin/

# 启动开发模式
consul agent -dev -client 0.0.0.0

访问 http://<IP>:8500 进入 Web UI

2. 集群模式（生产环境）

服务端节点（至少3台）

# 启动第一个服务端
consul agent -server -bootstrap-expect=3 \
  -data-dir=/tmp/consul \
  -node=server1 \
  -bind=192.168.1.101 \
  -ui \
  -client=0.0.0.0

# 其他服务端加入集群
consul agent -server -data-dir=/tmp/consul \
  -node=server2 \
  -bind=192.168.1.102 \
  -join=192.168.1.101

客户端节点

consul agent -data-dir=/tmp/consul \
  -node=client1 \
  -bind=192.168.1.201 \
  -join=192.168.1.101

3. Docker 部署

docker run -d --name=consul \
  -p 8500:8500 \
  -p 8600:8600/udp \
  consul agent -server -ui -bootstrap-expect=1 -client=0.0.0.0

二、核心功能使用

1. 服务注册

通过配置文件注册（推荐）

创建 /etc/consul.d/web.json：

{
  "service": {
    "name": "web",
    "port": 8080,
    "checks": [
      {
        "http": "http://localhost:8080/health",
        "interval": "10s"
      }
    ]
  }
}

重新加载配置：

consul reload

通过 API 注册

curl --request PUT \
  --data @web.json \
  http://localhost:8500/v1/agent/service/register

2. 服务发现

DNS 方式

dig @127.0.0.1 -p 8600 web.service.consul

HTTP API 方式

curl http://localhost:8500/v1/catalog/service/web

3. 键值存储

# 写入
consul kv put config/web/max_conns 25

# 读取
consul kv get config/web/max_conns

# 导出所有KV
consul kv export > backup.json

4. 健康检查

查看节点健康状态：

consul monitor

三、生产环境最佳实践

  1. 多数据中心部署：

    consul agent -server -datacenter=dc1 ...
consul agent -server -datacenter=dc2 ...

  2. ACL 安全控制：

    # 启用ACL
consul acl bootstrap

  3. 自动加密通信：

    consul tls ca create
consul tls cert create -server

  4. 监控集成：

    • 对接 Prometheus
    • 配置 Grafana 仪表盘

四、常见问题排查

  1. 节点无法加入集群：

    consul members
consul operator raft list-peers

  2. 服务注册失败：

    consul catalog services
consul monitor -log-level=debug

  3. 性能问题：

    consul operator raft stats

五、版本升级

# 滚动升级步骤
consul leave
# 替换新版本二进制
consul agent -config-dir=/etc/consul.d

通过以上指南，您可以快速部署和管理 Consul 集群。Consul 的强大功能可以帮助您构建可靠的微服务架构，实现服务自动发现和健康管理。

No Comments
Back to top