ibmcom/consul-ppc64le

Consul Docker镜像文档

概述

Consul是一种数据中心运行时，提供服务发现、配置管理和编排功能，可通过Docker容器快速部署，简化服务治理和数据中心管理流程。

支持的标签

• 0.8
• 0.9.0

核心功能

• 服务发现：自动注册和发现服务实例，支持健康检查机制
• 配置管理：集中化管理服务配置，实现动态配置更新
• 编排能力：提供数据中心级别的服务编排与协调
• Web UI：可视化管理界面，支持服务状态监控与操作

使用场景

• 微服务架构中的服务注册与发现
• 分布式系统的配置集中管理
• 数据中心内服务健康状态监控
• 跨服务依赖关系可视化管理

使用方法

1. 验证Consul二进制文件

运行容器后，可通过以下命令验证Consul二进制是否正常工作：

bash
consul

2. 开发模式运行Consul代理

以开发模式启动Consul代理（默认启用UI）：

bash
docker run -dP --name=agent1 consul

• -dP：后台运行并随机映射容器端口到主机
• --name=agent1：指定容器名称为agent1

3. 列出运行中的代理节点

通过容器内命令查看所有注册的代理节点：

bash
docker exec -i agent1 consul members

4. 从容器外获取节点详细信息

通过HTTP API从主机访问Consul节点数据：

bash
curl localhost:MAPPED_PORT/v1/catalog/nodes

其中，MAPPED_PORT为容器8500端口在主机上的映射端口（可通过docker ps命令查看）。

5. 正常模式运行Consul代理

以标准模式（非开发模式）启动Consul代理：

bash
docker run -dP --name=agent1 consul agent

6. 启用Web UI（非开发模式）

开发模式默认启用UI，非开发模式需通过-ui选项手动启用：

bash
docker run -dP --name=agent1 consul agent -ui

启用后，通过浏览器访问Web UI：

http://VM_IP:MAPPED_PORT

其中，VM_IP为运行容器的虚拟机IP，MAPPED_PORT为容器8500端口在主机上的映射端口。

配置说明

• 端口映射：容器8500端口为API/UI端口，需映射到主机端口以提供外部访问
• UI启用规则：开发模式默认启用UI，非开发模式必须通过-ui参数显式启用
• 网络配置：生产环境中建议指定固定端口映射（如-p 8500:8500）以确保访问稳定性