resurfaceio/resurface

Graylog API Security 协调器节点 Docker 镜像文档

1. 镜像概述与主要用途

本镜像为 Graylog API Security（原 Resurface）数据库的协调器节点，用于管理 API 调用捕获与分析的核心集群。作为集群的控制中心，它可独立部署为单节点集群，或与一个及以上工作节点集成，构建大规模分布式集群，支持企业级安全数据湖的 API 数据捕获与分析需求。

2. 核心功能与特性

2.1 集群协调能力

• 作为单节点集群的核心节点，独立处理 API 数据的捕获与管理
• 支持与多工作节点协同，构建分布式集群，提升数据处理与存储扩展性

2.2 架构兼容性

• 支持主流架构：amd64、arm64

3. 使用场景与适用范围

3.1 部署规模

• 单节点部署：适用于测试环境、小型应用或低流量 API 监控场景
• 多节点集群：适用于生产环境、高流量 API 系统或企业级安全数据湖，通过协调器节点管理工作节点集群

3.2 应用场景

• API 调用全链路捕获与存储
• 安全数据湖构建中的 API 数据管理
• 分布式环境下的 API 流量监控与分析

4. 使用方法与配置说明

4.1 Kubernetes 部署（推荐）

本镜像推荐通过 Kubernetes 部署，使用 Helm 进行安装与升级：

bash
# 安装集群（含协调器节点）
helm install graylog-api-security graylog/api-security --namespace graylog-api-security --create-namespace

# 升级集群配置
helm upgrade graylog-api-security graylog/api-security --namespace graylog-api-security

详细部署步骤请参考 官方安装文档。

4.2 Docker 部署（基础示例）

单节点模式下可通过 Docker 直接部署（生产环境建议使用 Kubernetes）：

bash
docker run -d \
  --name graylog-api-security-coordinator \
  --restart always \
  -p 8080:8080 \  # 示例端口，具体端口需根据配置调整
  graylog/api-security-coordinator:latest

注意：生产环境部署需配置存储卷、网络策略及集群参数，详细配置请参考 官方安装文档。

4.3 配置参数说明

集群配置（如节点角色、存储路径、资源限制等）需通过环境变量或配置文件定义，具体参数及默认值请参考 官方配置文档。

5. 技术支持与文档资源

5.1 官方文档

• 产品介绍
• 安装指南
• API 调用捕获

5.2 技术支持

获取技术支持请访问 Graylog 技术支持页面。

6. 支持架构

• amd64
• arm64