li-wen部署指南：从零开始搭建OBS动态资源管理系统

li-wen部署指南：从零开始搭建OBS动态资源管理系统

【免费下载链接】li-wenTool for dynamic management of worker resources in OBS-Build system项目地址: https://gitcode.com/openeuler/li-wen

前往项目官网免费下载：https://ar.openeuler.org/ar/

li-wen是一款为OBS构建系统设计的worker资源动态管理工具，能够实现worker资源的自动扩展和释放，有效提升OBS构建系统的资源利用率和构建效率。本文将为您提供从零开始搭建OBS动态资源管理系统的完整部署指南。

一、OBS动态资源管理系统简介 📚

OBS（Open Build Service）是一个用于构建和分发软件包的系统，而li-wen作为OBS构建系统的worker资源动态管理工具，通过实时监控worker的负载情况，根据预设策略自动调整worker资源的数量，从而实现资源的优化配置。

图1：OBS架构图，展示了OBS构建系统的整体架构以及li-wen在其中的位置和作用

二、系统环境要求 🔧

li-wen工具支持aarch64和x86_64两种架构，在部署前请确保您的系统满足以下基本要求：

• 操作系统：推荐使用openEuler系统
• 硬件架构：aarch64或x86_64
• 网络环境：能够访问Git仓库以及相关的云资源服务

三、快速安装步骤 🚀

3.1 克隆项目仓库

首先，将li-wen项目仓库克隆到本地的/usr/目录下，执行以下命令：

git clone https://gitcode.com/openeuler/li-wen /usr/li-wen

3.2 配置系统服务

1. 将项目中的wsdm.service文件拷贝到/usr/lib/systemd/system目录，命令如下：

cp /usr/li-wen/wsdm.service /usr/lib/systemd/system/

2. 编辑wsdm.service文件，在Environment中配置IAM_PASSWORD、IAM_USER和IAM_DOMAIN参数，这些参数需要与对接云资源厂商的基础设施团队确认（当前是华为云）。

3.3 配置排除worker列表

配置excluded_workers.yaml文件，该文件用于指定不需要进行动态管理的worker，格式参考文件中的示例。文件路径为：/usr/li-wen/libs/conf/excluded_workers.yaml。

四、系统配置详解 ⚙️

4.1 核心配置文件说明

li-wen的核心配置文件主要包括：

• wsdm.ini：工具的主配置文件，包含各种运行参数的设置。
• global_config.py：全局配置模块，路径为/usr/li-wen/libs/conf/global_config.py，用于定义系统级别的常量和配置。
• queryconfig.py：查询配置模块，路径为/usr/li-wen/libs/conf/queryconfig.py，用于配置查询相关的参数。

4.2 逻辑视图解析

li-wen系统的逻辑视图展示了各个功能模块之间的关系和数据流向，有助于理解系统的工作原理。

图2：li-wen逻辑视图，展示了系统的功能模块和外部依赖关系

从逻辑视图中可以看出，系统主要包括资源监控模块、资源弹性调度模块、云资源管理模块和配置管理等模块，各模块协同工作实现worker资源的动态管理。

五、启动与停止服务 🎬

5.1 启动服务

完成上述配置后，使用以下命令启动li-wen服务：

systemctl start wsdm

5.2 停止服务

如需停止li-wen服务，执行以下命令：

systemctl stop wsdm

六、动态资源管理流程解析 🔄

li-wen通过一系列流程实现worker资源的动态管理，包括监控worker负载、分析任务情况、申请或释放资源等。

图3：li-wen流程图，展示了worker资源动态管理的详细流程

从流程图中可以看到，系统会定期监控worker的状态和任务情况，根据构建时间级别和动态扩展策略来决定是否需要申请新的worker资源或释放空闲的worker资源，从而实现资源的动态调整。

七、常见问题解决 ❓

在部署和使用li-wen的过程中，可能会遇到一些常见问题，以下是一些解决方法：

7.1 服务启动失败

如果服务启动失败，可以通过查看日志文件来定位问题，日志文件路径可在配置中设置。常见的原因可能是配置参数错误或云资源访问权限问题，请检查wsdm.service中的环境变量配置是否正确，并确保IAM用户具有足够的权限。

7.2 worker资源未按预期扩展或释放

出现这种情况可能是由于动态扩展策略配置不当，可检查相关的配置文件，如global_config.py中的构建时间级别、动态扩展数量等参数是否设置合理。

八、总结 📝

通过本文的指南，您可以从零开始成功部署li-wen工具，搭建起OBS动态资源管理系统。li-wen能够根据OBS构建系统的实际需求自动调整worker资源，提高资源利用率，降低运维成本。希望本文对您有所帮助，祝您使用愉快！

【免费下载链接】li-wenTool for dynamic management of worker resources in OBS-Build system项目地址: https://gitcode.com/openeuler/li-wen