Catchpoint 企业节点 Docker 镜像文档

1. 镜像概述

1.1 概述

Catchpoint 企业节点 Docker 镜像是用于部署最新版 Catchpoint 企业节点的容器化解决方案，旨在提供便捷、可扩展的合成监控代理部署方式，支持与 Catchpoint 门户集成，执行性能测试、网络监控等任务。

1.2 主要用途

• 快速部署 Catchpoint 企业级合成监控节点
• 实现与 Catchpoint 后端服务的安全通信与数据同步
• 支持自定义网络配置、权限管理及自动化激活流程

2. 核心功能和特性

• 多版本管理：提供 preview（预览版）、stable（稳定版）及特定版本（如 2.16.x.xxx）标签，满足不同环境需求
• 灵活网络配置：支持共享主机网络（--net=host）、自定义 DNS 服务器及 TCP 参数调优，优化测试准确性
• 时间同步机制：通过 SYS_TIME 权限支持 chronyd 时间同步，确保测试结果时间戳精确性
• 权限精细化控制：支持添加 SYS_ADMIN、NET_RAW 等 Linux capabilities，满足不同测试类型的系统权限需求
• 自动化激活：通过 API 密钥和节点名称实现容器与 Catchpoint 门户的自动关联激活
• 持久化实例标识：通过 CP_INSTANCEID 环境变量固定实例 ID，避免重复配置

3. 使用场景和适用范围

• 企业级分布式监控：适用于跨地域、多节点的性能监控与测试场景
• 容器化部署环境：支持在 Docker 及 Kubernetes 等容器编排平台中快速部署
• 自定义网络环境：需特殊网络配置（如独立 DNS、端口映射、原始套接字访问）的监控场景
• 大规模节点管理：通过自动化激活功能简化成百上千节点的部署与维护流程

4. 使用方法和配置说明

4.1 前提条件

• Docker 环境：已安装 Docker 引擎，参考 Docker 官方安装文档
• 存储驱动：推荐使用 overlay2 存储格式；非 overlay2 格式需在容器创建后进行额外配置
• 安全配置：Ubuntu 系统若启用 AppArmor，运行容器时需添加 --security-opt seccomp=unconfined

4.2 镜像标签说明

镜像托管于 Docker Hub：catchpoint/enterprise，标签说明如下：

4.3 拉取镜像

拉取最新稳定版镜像：

docker pull catchpoint/enterprise:stable

4.4 创建并运行容器

4.4.1 基本命令格式

docker run -h {instanceName} \
    --cap-add SYS_ADMIN \
    --env CP_INSTANCEID={instanceID} \
    [其他选项] \
    catchpoint/enterprise:stable

4.4.2 必选参数说明

4.4.3 推荐附加参数

4.4.4 自动激活参数

通过以下参数实现容器与 Catchpoint 门户的自动关联激活：

注意：使用自动激活时必须指定 CP_INSTANCEID，避免容器重启后实例 ID 变更导致激活失效。

4.4.5 罕见需求参数

4.5 部署示例

4.5.1 基础部署（最小配置）

docker run -h cp-node-01 \
    --name catchpoint-enterprise \
    --cap-add SYS_ADMIN \
    --env CP_INSTANCEID=ABC123XYZ789 \
    catchpoint/enterprise:stable

4.5.2 带自动激活的生产环境部署

docker run -h cp-prod-node-01 \
    --name cp-enterprise-prod \
    --cap-add SYS_ADMIN \
    --cap-add SYS_TIME \
    --net=host \
    --dns 192.168.1.1 \
    --sysctl net.ipv4.tcp_syn_retries=3 \
    --env CP_INSTANCEID=DEF456GHI012 \
    --env CP_APIKEY=your_rest_api_key_here \
    --env CP_NODENAME=prod-europe-node \
    catchpoint/enterprise:stable

4.6 容器交互与管理

4.6.1 登录容器终端

docker exec -it {container_name} /bin/bash

4.6.2 手动激活容器

若未使用自动激活参数，需执行以下步骤：

1. 在容器内运行 catchpoint info 获取主机名和机器 ID：

   catchpoint info
   

2. 参考 Catchpoint 门户实例激活文档 完成激活
3. 大规模部署可使用 Catchpoint 批量激活工具

4.7 故障排除与支持

• 日志位置：容器内 /var/log/entrypoint.log 记录启动过程及权限需求提示
• 技术支持：部署问题可联系 ***

5. 环境变量说明