app-mesh-ui Docker镜像文档

1. 镜像概述

app-mesh-ui是一个基于Web的用户界面，用于管理和监控App Mesh服务网格。该Docker镜像封装了完整的前端应用，提供了便捷的部署方式，使用户能够快速搭建App Mesh的可视化管理平台。

2. 核心功能和特性

• 直观展示App Mesh服务网格拓扑结构
• 实时监控服务健康状态和流量指标
• 支持服务、虚拟节点、虚拟服务等资源的管理
• 提供流量路由规则的配置界面
• 集成日志查看功能
• 响应式设计，支持多种设备访问

3. 使用场景和适用范围

• App Mesh服务网格的日常管理和运维
• 服务流量监控和问题排查
• 开发环境中快速搭建服务网格管理界面
• 演示和教学环境中的App Mesh可视化展示

4. 使用方法和配置说明

4.1 基本使用

bash
docker run -d -p 8080:80 --name app-mesh-ui laoshanxi/app-mesh-ui

访问 http://localhost:8080 即可打开管理界面。

4.2 环境变量配置

示例：

bash
docker run -d -p 8080:80 \
  -e API_ENDPOINT="[***]" \
  -e AUTH_ENABLED=true \
  -e THEME=dark \
  --name app-mesh-ui laoshanxi/app-mesh-ui

4.3 Docker Compose配置

yaml
version: '3'
services:
  app-mesh-ui:
    image: laoshanxi/app-mesh-ui
    container_name: app-mesh-ui
    restart: always
    ports:
      - "8080:80"
    environment:
      - API_ENDPOINT=[***]
      - AUTH_ENABLED=true
      - THEME=light
    networks:
      - app-mesh-network

networks:
  app-mesh-network:
    driver: bridge

4.4 持久化配置

bash
docker run -d -p 8080:80 \
  -v ./config:/usr/share/nginx/html/config \
  --name app-mesh-ui laoshanxi/app-mesh-ui

将配置文件挂载到容器内/usr/share/nginx/html/config目录，实现配置持久化。

5. 高级配置

5.1 自定义API端点

通过环境变量API_ENDPOINT指定后端API服务地址：

bash
docker run -d -p 8080:80 \
  -e API_ENDPOINT="[***]" \
  --name app-mesh-ui laoshanxi/app-mesh-ui

5.2 启用认证

bash
docker run -d -p 8080:80 \
  -e AUTH_ENABLED=true \
  -e AUTH_PROVIDER=oidc \
  -e OIDC_CLIENT_ID=your-client-id \
  -e OIDC_ISSUER_URL=[***] \
  --name app-mesh-ui laoshanxi/app-mesh-ui

6. 故障排除

6.1 无法连接到API服务

• 检查API服务是否正常运行
• 确认API_ENDPOINT环境变量配置正确
• 检查容器网络连接是否正常

bash
# 进入容器检查网络连接
docker exec -it app-mesh-ui curl API_ENDPOINT

6.2 界面显示异常

bash
# 查看容器日志
docker logs app-mesh-ui

# 清除浏览器缓存或使用无痕模式访问

7. 版本信息和更新日志

• 最新版本: v1.0.0
• 更新日志请参考: [***]

8. 相关资源

• GitHub仓库: [***]
• App Mesh文档: []
• 问题反馈: [***]