jupiterone/graph-kubernetes

Kubernetes资源转JupiterOne图模型镜像

概述

该Docker镜像用于将Kubernetes集群资源转换为结构化图模型，使其能够被JupiterOne平台导入，支持资源关系分析、安全状态监控和合规审计等场景。通过标准化K8s资源数据格式，实现与JupiterOne的无缝集成，帮助用户在统一平台中管理和可视化Kubernetes资源。

核心功能与特性

• 资源类型支持：兼容Kubernetes核心资源（Pod、Service、Deployment、StatefulSet、ConfigMap等）及自定义资源
• 图模型生成：自动解析资源间依赖关系（如Pod与Service的关联、Deployment与ReplicaSet的层级关系），生成符合JupiterOne规范的图结构
• 数据标准化：将K8s资源元数据（标签、注解、状态等）转换为JupiterOne实体属性格式
• 轻量级设计：基于Alpine基础镜像构建，体积小，资源占用低
• 灵活配置：支持通过环境变量自定义资源过滤规则、输出格式及JupiterOne连接参数

使用场景

• Kubernetes集群资源在JupiterOne中的可视化与关系分析
• 基于K8s资源的安全合规检查（如权限配置、镜像安全扫描结果关联）
• 云原生环境资源依赖图谱构建
• 跨平台资源统一管理（结合JupiterOne的多环境集成能力）

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name k8s-to-jupiterone \
  -v /path/to/kubeconfig:/app/kubeconfig \  # 挂载Kubernetes配置文件
  -e KUBECONFIG_PATH=/app/kubeconfig \      # 指定kubeconfig路径
  -e JUPITER_ONE_API_KEY=your_api_key \     # JupiterOne API密钥
  -e JUPITER_ONE_ACCOUNT_ID=your_account_id \  # JupiterOne账户ID
  -e RESOURCE_FILTER="namespace=default;kind=Deployment,Pod"  # 可选：资源过滤规则
  your-registry/k8s-to-jupiterone:latest

Docker Compose配置

yaml
version: '3'
services:
  k8s-to-jupiterone:
    image: docker.xuanyuan.run/your-registry/k8s-to-jupiterone:latest
    volumes:
      - ./kubeconfig:/app/kubeconfig
    environment:
      - KUBECONFIG_PATH=/app/kubeconfig
      - JUPITER_ONE_API_KEY=your_api_key
      - JUPITER_ONE_ACCOUNT_ID=your_account_id
      - SYNC_INTERVAL=3600  # 同步间隔（秒），默认3600
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error，默认info

配置参数说明

输出说明

转换后的图模型数据将通过JupiterOne API直接导入平台，同时可通过容器日志查看同步状态（docker logs k8s-to-jupiterone）。调试模式下，可通过OUTPUT_FORMAT参数将图模型数据输出到容器内/app/output目录。