apicurio/apicurio-registry-ui

镜像概述

Apicurio Registry UI 镜像提供了 Apicurio Registry 的官方 Web 用户界面，旨在通过直观的图形化操作简化对 API 规范和数据模式注册中心的管理。该界面作为 Apicurio Registry 后端服务的前端交互层，支持用户无需通过命令行或直接调用 API 即可完成资源管理、版本控制和配置等核心操作。

核心功能与特性

• 可视化资源管理：支持通过 Web 界面浏览、创建、编辑和删除已注册的 API 规范（如 OpenAPI、AsyncAPI）和数据模式（如 Avro、Protobuf、JSON Schema）。
• 版本控制与历史追踪：展示资源的完整版本历史，支持版本比较、回滚和查看变更记录。
• 搜索与筛选：提供按名称、类型、版本、标签等多维度筛选功能，快速定位目标资源。
• 规则与配置管理：配置注册中心的验证规则、兼容性策略和全局设置。
• 状态监控：实时显示注册中心健康状态、资源统计数据及性能指标。

使用场景

• 开发团队：协作管理 API 设计规范，实时编辑和共享 OpenAPI 文档，确保接口定义一致性。
• 数据工程团队：维护数据交换格式（如 Avro 模式），管理版本演进以保障上下游系统兼容性。
• 运维与平台团队：监控注册中心资源使用情况，配置访问控制策略，审计资源变更记录。
• CI/CD 集成场景：作为可视化入口，辅助在持续集成流程中管理 API/模式的版本发布与验证。

使用方法与配置说明

基本运行命令

通过 docker run 快速启动容器，需指定与 Apicurio Registry 后端服务的连接参数：

bash
docker run -d \
  --name apicurio-registry-ui \
  -p 8080:8080 \
  -e APICURIO_REGISTRY_URL=http://<backend-host>:<backend-port> \
  docker.xuanyuan.run/apicurio/apicurio-registry-ui:latest

• -p 8080:8080：将容器内 UI 服务端口（默认 8080）映射到主机端口。
• -e APICURIO_REGISTRY_URL：必选参数，指定 Apicurio Registry 后端服务的基础 URL（需替换为实际后端地址，如 http://registry-backend:8080）。

关键环境变量配置

访问与登录

容器启动后，通过浏览器访问 http://<host-ip>:8080 打开 UI 界面。若后端启用认证（如 Keycloak 集成），需使用对应凭据登录。

示例：连接后端服务并启用认证

bash
docker run -d \
  --name apicurio-registry-ui \
  -p 80:8080 \
  -e APICURIO_REGISTRY_URL=http://registry-backend:8080 \
  -e AUTH_ENABLED=true \
  -e LOG_LEVEL=DEBUG \
  docker.xuanyuan.run/apicurio/apicurio-registry-ui:latest

此配置将 UI 服务暴露在主机 80 端口，启用认证，并输出 DEBUG 级日志。