opennode/waldur-homeport

Waldur HomePort 自助服务门户镜像文档

镜像概述

Waldur HomePort 自助服务门户镜像是Waldur平台的核心组件之一，提供用户友好的Web界面，支持用户自主完成云资源（如虚拟机、存储、网络）及服务的申请、配置、生命周期管理与使用监控。该镜像旨在简化资源获取流程，减少人工干预，同时通过权限控制和流程自动化确保资源分配合规性，适用于企业IT自助服务、云服务提供商用户门户等场景。

核心功能与特性

自助资源管理

• 支持虚拟机、容器、存储卷、网络等云资源的可视化申请与配置
• 提供资源生命周期管理功能（启动/停止、扩容/缩容、删除等操作）
• 实时展示资源使用状态、性能指标及费用统计

流程自动化与合规

• 集成可配置的审批流程，支持多级审批或自动审批策略
• 基于角色的访问控制（RBAC），限制用户资源操作权限
• 资源申请模板化，确保配置标准化与合规性

用户体验优化

• 直观的Web界面设计，降低用户操作门槛
• 支持资源使用记录查询与历史数据导出
• 提供操作指引与帮助文档集成

系统集成能力

• 与Waldur Core API深度集成，同步资源数据与操作状态
• 支持LDAP/OAuth2等主流认证方式，对接企业身份管理系统
• 可扩展的插件机制，支持自定义资源类型与服务模块

使用场景

• 企业IT自助服务：员工自主申请开发/测试环境资源，减少IT团队响应成本
• 云服务提供商门户：为客户提供自助管理云资源的界面，提升客户自主服务能力
• 教育/科研机构资源分配：学生或研究人员申请实验资源，简化管理员分配流程
• 多租户资源隔离：支持多组织/部门独立管理资源，数据与权限隔离

使用方法与配置说明

前提条件

• Docker Engine 20.10+ 或 Docker Desktop
• 已部署 Waldur Core API 服务（推荐使用官方镜像 waldur/core）
• 数据库服务（PostgreSQL 12+，用于存储门户配置与用户操作记录）

获取镜像

从 Docker Hub 拉取最新版本镜像：

bash
docker pull waldur/homeport:latest

如需指定版本，可替换 latest 为具体版本号（如 v6.0.0）。

快速启动（docker run）

bash
docker run -d \
  --name waldur-homeport \
  -p 80:80 \
  -e WALDUR_API_URL=http://waldur-core:8000/api \  # 指向Waldur Core API地址
  -e AUTH_METHOD=oauth2 \                           # 认证方式（支持oauth2/ldap/local）
  -e DB_HOST=postgres \                             # 数据库主机地址
  -e DB_PORT=5432 \                                 # 数据库端口
  -e DB_NAME=waldur_homeport \                      # 数据库名称
  -e DB_USER=homeport_user \                        # 数据库用户名
  -e DB_PASSWORD=secure_password \                  # 数据库密码
  -e SITE_TITLE="企业云自助服务门户" \              # 自定义门户标题
  waldur/homeport:latest

环境变量配置

Docker Compose 部署示例

推荐使用 docker-compose 管理多组件部署（含数据库与Waldur Core）：

yaml
version: '3.8'

services:
  # Waldur HomePort 门户
  homeport:
    image: waldur/homeport:latest
    ports:
      - "80:80"
    environment:
      - WALDUR_API_URL=http://waldur-core:8000/api
      - AUTH_METHOD=oauth2
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=waldur_homeport
      - DB_USER=homeport_user
      - DB_PASSWORD=ChangeMeToSecurePassword
      - SITE_TITLE=公司云资源自助门户
      - TIMEZONE=Asia/Shanghai
    depends_on:
      - postgres
      - waldur-core
    restart: unless-stopped

  # 数据库服务
  postgres:
    image: postgres:14-alpine
    environment:
      - POSTGRES_USER=homeport_user
      - POSTGRES_PASSWORD=ChangeMeToSecurePassword
      - POSTGRES_DB=waldur_homeport
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

  # Waldur Core API服务（需单独配置）
  waldur-core:
    image: waldur/core:latest
    # 参考Waldur Core镜像文档配置API服务...

volumes:
  postgres-data:  # 持久化存储数据库数据

访问与使用

1. 启动所有服务后，通过浏览器访问 http://<服务器IP或域名>（默认端口80）
2. 使用Waldur平台账号登录（首次使用需由管理员创建用户并分配权限）
3. 在门户首页选择所需资源类型（如“虚拟机申请”），填写配置参数并提交
4. 跟踪申请进度（如审批状态），资源创建完成后可在“我的资源”页面进行管理

注意事项

• 网络配置：确保HomePort容器与Waldur Core API、数据库之间网络互通，防火墙规则允许对应端口访问
• 数据持久化：生产环境需通过卷（Volume）持久化数据库数据，避免容器重建导致配置丢失
• 安全加固：修改默认数据库密码，使用HTTPS加密Web访问（可配合Nginx反向代理实现）
• 版本兼容性：HomePort镜像版本需与Waldur Core API版本匹配（参考官方版本兼容性矩阵）