鲲鹏社区首页
中文
注册
开发者
支持
积分兑换 NEW
技术干货
openEuler Intelligence 智能助手部署指南

openEuler Intelligence 智能助手部署指南

openEuler

发表于 2025/12/09

0

产品概述

openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligence 可以解决操作系统知识获取的便捷性，并且为OS领域模型赋能开发者及运维人员。作为获取操作系统知识，使能操作系统生产力工具 (如 A-Ops / A-Tune / x2openEuler / EulerMaker / EulerDevOps / StratoVirt / iSulad 等)，颠覆传统命令交付方式，由传统命令交付方式向自然语义进化，并结合智能体任务规划能力，降低开发、使用操作系统特性的门槛。

本指南提供基于自动化脚本的openEuler Intelligence智能助手系统部署说明，支持一键自动部署和手动分步部署两种方式。

组件介绍 ​

组件 端口 说明
euler-copilot-framework 8002 (内部端口) 智能体框架服务
euler-copilot-web 8080 智能体前端界面
euler-copilot-rag 9988 (内部端口) 检索增强服务
authhub-backend-service 11120 (内部端口) 鉴权服务后端
authhub-web-service 8000 鉴权服务前端
mysql 3306 (内部端口) MySQL数据库
redis 6379 (内部端口) Redis数据库
minio 9000 (内部端口) 9001(外部部端口) minio数据库
mongo 27017 (内部端口) mongo数据库
postgres 5432 (内部端口) 向量数据库
secret_inject 无 配置文件安全复制工具

软件要求 ​

类型 版本要求 说明
操作系统 openEuler 22.03 LTS 及以上版本 无
K3s >= v1.30.2，带有 Traefik Ingress 工具 K3s 提供轻量级的 Kubernetes 集群，易于部署和管理
Helm >= v3.15.3 Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务
python >=3.9.9 python3.9.9 以上版本为模型的下载和安装提供运行环境

硬件规格 ​

硬件资源 最小配置 推荐配置
CPU 4 核心 16 核心及以上
RAM 4 GB 64 GB
存储 32 GB 64G
大模型名称 deepseek-llm-7b-chat DeepSeek-R1-Llama-8B
显存 (GPU) NVIDIA RTX A4000 8GB NVIDIA A100 80GB * 2

关键说明：

  • 纯CPU环境，建议通过调用 OpenAI 接口或使用自带的模型部署方式来实现功能。
  • 如果k8s集群环境，则不需要单独安装k3s，要求version >= 1.28

部署视图 ​

域名配置 ​

需准备以下两个服务域名：

  • authhub认证服务：authhub.eulercopilot.local
  • openEuler Intelligence web服务：www.eulercopilot.local
# 本地Windows主机中进行配置
# 打开 C:\Windows\System32\drivers\etc\hosts 添加记录
# 替换127.0.0.1为目标服务器的IP
127.0.0.1 authhub.eulercopilot.local
127.0.0.1 www.eulercopilot.local

快速开始

1. 资源获取 ​

  • 获取部署脚本openEuler Intelligence 的官方Git仓库 切换至dev分支点击下载ZIP, 并上传至目标服务器
unzip euler-copilot-framework.tar -d /home
  • 资源清单下载地址EulerCopilot 资源仓库镜像文件# 使用脚本自动下载所有镜像（需在联网环境执行）
# 使用脚本自动下载所有镜像（需在联网环境执行）
cd /home/euler-copilot-framework/deploy/scripts/9-other-script/
# 执行镜像下载（版本号可替换）
./save_images.sh 0.9.5  # 自动保存到目录/home/eulercopilot/images
# 上传至目标服务器
scp /home/eulercopilot/images/* root@target-server:/home/eulercopilot/images/
  • 模型部署文件：bge-m3-Q4_K_M.gguf, deepseek-llm-7b-chat-Q4_K_M.gguf, ollama-linux-arm64.tgz/ollama-linux-amd64.tgz
  • 工具包：helm-v3.15.0-linux-arm64.tar.gz/helm-v3.15.0-linux-amd64.tar.gz, k3s-airgap-images-arm64.tar.zst/k3s-airgap-images-amd64.tar.zst,k3s-arm64/k3s-amd64, k3s-install.sh
  • 网络要求： 手动下载需确保存在可访问外网文件的Windows环境，全部下载完成后传输至离线环境；脚本下载需在联网服务器执行，仅完成镜像下载，完成传输至离线环境
  • 确保目标服务器存在以下目录
/home/eulercopilot/
├── images/      # 存放镜像文件
├── models/      # 存放模型文件
└── tools/       # 存放工具包

2. 部署openEuler Intelligence ​

一键部署

cd /home/euler-copilot-framework/deploy/scripts
bash deploy.sh
# 输入0进行一键自动部署
==============================
        主部署菜单
==============================
0) 一键自动部署
1) 手动分步部署
2) 重启服务
3) 卸载所有组件并清除数据
4) 退出程序
==============================
请输入选项编号（0-3）: 0

手动分步部署 ​

# 选择1 -> 1 进入手动分步部署
==============================
        主部署菜单
==============================
0) 一键自动部署
1) 手动分步部署
2) 重启服务
3) 卸载所有组件并清除数据
4) 退出程序
==============================
请输入选项编号（0-3）: 1
# 输入选项编号（0-9），逐步部署
==============================
       手动分步部署菜单
==============================
1) 执行环境检查脚本
2) 安装k3s和helm
3) 安装Ollama
4) 部署Deepseek模型
5) 部署Embedding模型
6) 安装数据库
7) 安装AuthHub
8) 安装EulerCopilot
9) 返回主菜单
==============================
请输入选项编号（0-9）:

关键说明：

  1. 安装部署前需要预先准备好部署所需的资源
  2. 在部署过程中，您需要输入 Authhub 域名和 openEuler Intelligence 域名, 不输入则使用默认域名authhub.eulercopilot.local, www.eulercopilot.local。

重启服务 ​

# 输入选项重启服务
==============================
        服务重启菜单
==============================
可重启的服务列表：
1) authhub-backend
2) authhub
3) framework
4) minio
5) mongo
6) mysql
7) pgsql
8) rag
9) rag-web
10) redis
11) web
12) 返回主菜单
==============================
请输入要重启的服务编号（1-12）:

卸载所有组件 ​

sudo ./deploy.sh
# 选择2进行完全卸载
==============================
        主部署菜单
==============================
0) 一键自动部署
1) 手动分步部署
2) 卸载所有组件并清除数据
3) 退出程序
==============================
请输入选项编号（0-3）: 2

关键说明：

  • 在部署过程中，您需要输入 Authhub 域名和 openEuler Intelligence 域名, 不输入则使用默认域名authhub.eulercopilot.local, www.eulercopilot.local。
  • 资源不足时可参考 FAQ 中的评估资源可用性解决
  • 查看组件日志
kubectl logs <pod名称> -n euler-copilot
  • 查看服务状态
kubectl get pod -n euler-copilot
  • 大模型配置修改并更新openEuler Intelligence
cd /home/euler-copilot-framework/deploy/chart/euler-copilot
vim values.yaml
helm upgrade euler-copilot -n euler-copilot .

验证安装

恭喜您，openEuler Intelligence 已成功部署！为了开始您的体验，请在浏览器中输入 https://您的openEuler Intelligence域名 链接访问 openEuler Intelligence 的网页界面：

首次访问时，您需要点击页面上的 立即注册 按钮来创建一个新的账号，并完成登录过程。


本页内容