openiamdocker/openiam-metadata

Openiam Metadata 镜像文档

概述

Openiam Metadata镜像是OpenIAM身份管理解决方案的核心组件，专门用于存储、管理和维护OpenIAM系统运行所需的元数据信息。该镜像提供元数据集中存储、配置同步及持久化管理能力，确保OpenIAM系统各功能模块间元数据一致性，是构建稳定、高效OpenIAM部署环境的基础组件。

核心功能与特性

• 元数据集中管理：统一存储OpenIAM系统的身份数据模型、权限配置、组织架构定义等核心元数据
• 数据持久化支持：通过卷挂载实现元数据持久化存储，防止容器重启或升级导致数据丢失
• 跨组件同步：与OpenIAM身份服务、权限管理、审计日志等模块实时同步元数据变更
• 配置灵活性：支持通过环境变量自定义元数据存储路径、同步频率、日志级别等参数
• 兼容性：兼容OpenIAM最新稳定版本，支持Docker Compose、Kubernetes等主流容器编排平台

使用场景与适用范围

• OpenIAM身份管理系统生产环境部署，集中管理用户、角色、权限等元数据信息
• 多节点OpenIAM集群部署时，确保各节点间元数据一致性与同步
• OpenIAM与第三方应用集成（如HR系统、CRM系统）时，提供标准化元数据配置接口
• 开发测试环境中快速搭建包含元数据管理功能的OpenIAM最小化验证环境

使用方法与配置说明

快速启动

通过以下命令启动Openiam Metadata容器：

bash
docker run -d \
  --name openiam-metadata \
  -p 8080:8080 \
  -v metadata-data:/opt/openiam/metadata/data \
  -e METADATA_STORAGE_PATH=/opt/openiam/metadata/data \
  -e SYNC_INTERVAL=300 \
  openiam/metadata:latest

环境变量配置

持久化配置

为确保元数据持久化，建议创建专用数据卷：

bash
# 创建数据卷
docker volume create metadata-data

# 使用数据卷启动容器
docker run -d \
  --name openiam-metadata \
  -v metadata-data:/opt/openiam/metadata/data \
  openiam/metadata:latest

Docker Compose 部署示例

yaml
version: '3.8'
services:
  openiam-metadata:
    image: openiam/metadata:latest
    container_name: openiam-metadata
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - metadata-data:/opt/openiam/metadata/data
    environment:
      - METADATA_STORAGE_PATH=/opt/openiam/metadata/data
      - SYNC_INTERVAL=600
      - LOG_LEVEL=INFO
      - DB_CONNECTION_STRING=jdbc:mysql://mysql-host:3306/openiam_metadata
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3
volumes:
  metadata-data:

状态验证

容器启动后，可通过以下命令验证服务状态：

bash
# 查看容器日志
docker logs -f openiam-metadata

# 验证健康状态
docker inspect --format='{{.State.Health.Status}}' openiam-metadata