Gurobi Cluster Manager (gurobi/manager) 镜像文档

!Logo

镜像概述和主要用途

gurobi/manager 是 Gurobi 提供的集群管理服务器组件，用于集中管理 Gurobi Compute Server（计算服务器）。它通过用户认证和 API 密钥增强安全性，并统一管理交互式和非交互式优化任务，扩展了计算服务器集群节点的能力。Gurobi Optimizer 是目前最快、最强大的数学规划求解器，支持 LP、QP、MIP（MILP、MIQP、MIQCP）等问题类型，而 Cluster Manager 则为其分布式部署提供了核心管理能力。

核心功能和特性

• 增强安全性：通过用户认证和 API 密钥管理访问权限，提升集群安全性
• 统一任务管理：集中管理交互式和非交互式优化任务，简化集群调度
• 多架构支持：兼容 linux/amd64 和 linux/arm64 架构
• 灵活扩展：支持动态扩展 Compute Server 节点数量，适应计算需求变化
• 容器化优化：针对 Docker、Kubernetes 等容器环境设计，支持 Web License Service (WLS) 许可机制

支持的标签和架构

支持的标签及 Dockerfile 链接

注意：生产环境建议使用明确的版本号而非 latest 标签，以便控制应用升级流程。

支持的架构

• linux/amd64
• linux/arm64

使用场景和适用范围

• 企业级优化任务管理：需要集中管理多个计算节点的大规模优化任务
• 安全敏感环境：需要用户认证和 API 密钥控制访问权限的场景
• 容器化部署：基于 Docker 或 Kubernetes 的云原生环境
• 弹性计算需求：需要动态扩展计算资源以应对波动优化任务负载的场景
• 混合任务处理：同时运行交互式和非交互式优化任务的集群环境

许可说明

获取 Gurobi 许可

Gurobi Web License Service (WLS) 是专为容器化环境（Docker、Kubernetes 等）设计的许可服务。Gurobi 组件可自动向全球多个区域的 WLS 服务器请求和续期许可令牌，仅需容器具备互联网访问能力。商业用户可申请评估许可，学术用户可申请免费许可。

1. 注册并访问 Web License Manager
2. 参考 WLS 文档 完成配置

注意：标准许可类型（NODE、Academic 等）不支持容器环境。请联系销售代表 (***) 讨论许可选项。

客户端许可使用

Cluster Manager 本身无需许可，但计算服务器节点需要。有两种配置方式：

1. 挂载客户端许可文件

将连接参数存储在客户端许可文件（通常命名为 gurobi.lic）中，并挂载到容器：

bash
-v /path/to/local/gurobi.lic:/opt/gurobi/gurobi.lic:ro

2. 设置 WLS 环境变量

通过环境变量传递 WLS 许可参数：

• GRB_WLSACCESSID: WLS 访问 ID
• GRB_WLSSECRET: WLS 密钥
• GRB_LICENSEID: 许可 ID

安全提示：不建议将许可文件直接添加到 Docker 镜像中，以免泄露敏感信息。

使用方法和配置说明

Docker 快速启动

启动 Cluster Manager 并连接到 MongoDB 数据库：

bash
docker run gurobi/manager --database=MONGO_DB_URL

启动后，通过 http://localhost:61080/manager 访问管理界面，默认凭据：

• 标准用户：gurobi / pass
• 管理员：admin / admin
• 系统管理员：sysadmin / cluster

注意：独立启动仅用于测试，生产环境需配合 Compute Server 节点（见下文 Docker Compose 或 Kubernetes 部署）。

Docker Compose 部署

创建 docker-compose.yml 文件，包含 MongoDB、Cluster Manager 和 Compute Server：

yaml
version: '3.1'
services:
  mongodb:
    image: mongo:latest
    restart: always
    volumes:
      - mongodb:/data/db
    networks:
      - back-tier

  manager:
    image: gurobi/manager:latest
    restart: always
    depends_on:
      - "mongodb"
    ports:
      - "61080:61080"
    command: --database=mongodb://mongodb:27017
    networks:
      - back-tier
  
  compute:
    image: gurobi/compute:latest
    restart: always
    depends_on:
      - manager
    command: --manager=[***]
    networks:
      - back-tier
    volumes:
      - ./gurobi.lic:/opt/gurobi/gurobi.lic:ro  # 挂载许可文件

volumes:
  mongodb:

networks:
  back-tier:

启动服务：

bash
docker-compose up

扩展 Compute Server 节点数量：

bash
docker-compose up --scale compute=2  # 扩展至 2 个计算节点

Kubernetes 部署

1. 创建许可密钥

bash
kubectl create secret generic gurobi-lic --from-file="gurobi.lic=$PWD/gurobi.lic"

2. 部署集群

使用示例部署文件 k8s.yaml：

bash
kubectl apply -f k8s.yaml

查看部署状态：

bash
kubectl get pods

示例输出：

NAME                                       READY   STATUS    RESTARTS   AGE
gurobi-compute-674f8dcbf4-v27nn            1/1     Running   0          8m18s
gurobi-compute-674f8dcbf4-x9kff            1/1     Running   0          8m23s
gurobi-manager-79dcbf5b74-c9dfv            1/1     Running   0          8m23s
gurobi-manager-79dcbf5b74-wcqhj            1/1     Running   0          8m17s

3. 优化部署建议

为提升计算性能，建议将 Compute Server 部署在专用节点：

• 使用 DaemonSet 确保每个节点运行一个 Compute Server
• 通过节点选择器（nodeSelector: {app: compute}）指定专用节点
• 设置污点（taint: {app: compute}）和容忍度，避免其他 Pod 占用资源

示例 DaemonSet 配置见 daemonset.yaml。

其他 Gurobi 镜像

Gurobi 提供多种 Docker 镜像满足不同需求：

• gurobi/optimizer: 完整 Gurobi Optimizer 发行版
• gurobi/python: 仅包含 Python API 的 Gurobi Optimizer
• gurobi/python-example: 带 WLS 许可的 Python 示例
• gurobi/modeling-examples: Jupyter Notebook 格式的优化建模示例
• gurobi/compute: Gurobi Compute Server
• gurobi/manager: Gurobi Cluster Manager（本文档镜像）

许可协议

使用本镜像即表示您同意 Gurobi 最终用户许可协议。

本镜像可能包含其他软件，其许可条款由各自作者规定（如基础发行版中的 Bash 等）。镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可。

支持和资源

• Gurobi 支持
• Gurobi 文档
• Compute Server 文档
• 镜像 artifact 详情: [***]