docker-lwops-deployer（Docker lwops deployer 部署）

Docker LwOps 部署技能

自动化部署乐维监控 8.1 Docker 容器的本地技能，支持一键安装和智能配置。

功能特性

• 🔧 Docker 自动安装：自动检测系统类型并安装 Docker
• 🏗️ 架构智能检测：支持 x86_64 和 aarch64 架构
• 🔌 智能端口分配：自动检测端口冲突并分配可用端口
• ⚙️ cgroup 兼容：自动处理 cgroup v1/v2 兼容性问题
• 🚀 一键部署：快速启动乐维监控 8.1 容器环境
• 📊 详细反馈：输出容器访问地址和端口映射信息

使用方式

当用户请求部署乐维监控容器、检查 Docker 环境、或管理相关容器时，此技能会被自动调用。

使用场景

何时使用此技能

当你的查询包含以下特征时，应该使用此技能：

1. 乐维监控相关部署：明确提到"乐维监控"、"乐维8.1"、"lwops"等关键词
2. 容器部署操作：请求部署、启动、创建 Docker 容器
3. 环境管理：检查 Docker 安装状态、容器运行状态
4. 容器操作：重新部署、查看状态、查询访问地址

常见使用场景

场景 1：首次部署

• 示例：部署一个乐维监控 8.1 容器
• 说明：自动安装 Docker（如果需要），拉取镜像并启动容器

场景 2：重新部署

• 示例：重新部署 lwops_rocky8_image_8.1 容器
• 说明：删除现有容器并重新创建

场景 3：智能端口分配

• 示例：部署乐维监控容器，自动分配可用端口
• 说明：检测端口冲突并自动使用可用端口

场景 4：查询容器信息

• 示例：查询容器的访问地址和端口映射
• 说明：获取容器状态和访问 URL

与其他工具的区别

最佳实践

1. 权限要求：确保用户有 sudo 权限（安装 Docker 需要）
2. 网络环境：确保能访问华为云镜像仓库（swr.cn-south-1.myhuaweicloud.com）
3. 端口规划：默认使用 8000 和 8081 端口，如有冲突会自动调整
4. 容器管理：容器名称固定为 lwops_rocky8_image_8.1，重复部署会自动替换

配置

无需配置

此技能不需要任何环境变量或配置参数，开箱即用。

系统要求

• 操作系统：Ubuntu、Debian、CentOS、RHEL、Fedora、Arch Linux
• 架构支持：x86_64（amd64）、aarch64（arm64）
• 权限：sudo 权限（用于安装 Docker 和管理容器）
• 网络：能访问华为云 SWR 镜像仓库

技术实现

输入格式

此技能接收自然语言输入，无需特定的 JSON 格式。例如：

• "部署乐维监控 8.1 容器"
• "重新部署容器"
• "查看容器状态"

输出格式

成功时：

{
  "success": true,
  "data": {
    "container_name": "lwops_rocky8_image_8.1",
    "container_id": "a1b2c3d4e5f6",
    "status": "running",
    "architecture": "x86_64",
    "image": "swr.cn-south-1.myhuaweicloud.com/cloud-lwops/lwops_rocky8_x86_image:latest",
    "host_ip": "192.168.1.100",
    "ports": {
      "http": {
        "container_port": 80,
        "host_port": 8000,
        "url": "http://192.168.1.100:8000"
      },
      "https": {
        "container_port": 8081,
        "host_port": 8081,
        "url": "http://192.168.1.100:8081"
      }
    },
    "cgroup_version": "v1",
    "cgroup_mount_mode": "ro",
    "timestamp": "2026-03-24T10:30:00Z"
  },
  "message": "容器部署成功"
}

失败时：

{
  "success": false,
  "error": "DockerNotInstalled",
  "message": "Docker 未安装，正在尝试自动安装...",
  "suggestions": [
    "Ubuntu/Debian: sudo apt-get install docker.io",
    "CentOS/RHEL: sudo yum install docker",
    "访问 https://docs.docker.com/get-docker/ 获取详细安装指南"
  ],
  "timestamp": "2026-03-24T10:30:00Z"
}

容器信息

镜像地址

• x86_64 架构：swr.cn-south-1.myhuaweicloud.com/cloud-lwops/lwops_rocky8_x86_image:latest
• aarch64 架构：swr.cn-south-1.myhuaweicloud.com/cloud-lwops/lwops_rocky8_arm_image:latest

端口映射

• 容器端口 80 → 宿主机端口 8000（默认，可自动调整）
• 容器端口 8081 → 宿主机端口 8081（默认，可自动调整）

容器配置

• 容器名称：lwops_rocky8_image_8.1
• 启动参数：--privileged（特权模式）
• cgroup 挂载：/sys/fs/cgroup:/sys/fs/cgroup:ro（v1）或 :rw（v2）
• 启动命令：/usr/sbin/init

故障排除

问题 1：Docker 安装失败

症状：提示无法安装 Docker

解决方案：

1. 检查是否有 sudo 权限
2. 检查系统是否支持（参考系统要求）
3. 手动安装 Docker：访问 https://docs.docker.com/get-docker/

问题 2：端口被占用

症状：无法启动容器，端口冲突

解决方案：

1. 技能会自动分配可用端口
2. 查看输出中的 ports 字段获取实际端口
3. 停止占用端口的程序：sudo lsof -i :8000

问题 3：容器启动失败

症状：容器创建后立即退出

解决方案：

1. 检查 Docker 日志：docker logs lwops_rocky8_image_8.1
2. 检查 cgroup 版本兼容性
3. 确保使用 --privileged 参数

问题 4：无法访问容器服务

症状：容器运行但无法访问 Web 界面

解决方案：

1. 检查防火墙设置
2. 确认端口映射：docker port lwops_rocky8_image_8.1
3. 检查容器状态：docker ps

相关链接

• 乐维监控官网：https://www.lwops.cn
• Docker 官方文档：https://docs.docker.com/
• 问题反馈：https://github.com/lwops/docker-lwops-deployer/issues