同步操作将从 openEuler/patch-tracking 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
在 openEuler 发行版开发过程,需要及时更新上游社区各个软件包的最新代码,修改功能 bug 及安全问题,确保发布的 openEuler 发行版尽可能避免缺陷和漏洞。
本工具对软件包进行补丁管理,主动监控上游社区提交,自动生成补丁,并自动提交 issue 给对应的 maintainer,同时自动验证补丁基础功能,减少验证工作量支持 maintainer 快速决策。
patch-tracking采用 C/S 架构。
服务端(patch-tracking) :负责执行补丁跟踪任务,包括:维护跟踪项,识别上游仓库分支代码变更并形成补丁文件,向 Gitee 提交 issue 及 PR,同时 patch-tracking 提供 RESTful 接口,用于对跟踪项进行增删改查操作。
客户端:即命令行工具(patch-tracking-cli),通过调用 patch-tracking 的 RESTful 接口,实现对跟踪项的增删改查操作。
主要步骤:
主要步骤:
序号 | 名称 | 说明 | 类型 | 键 | 允许空 |
---|---|---|---|---|---|
1 | id | 自增补丁跟踪项序号 | int | - | NO |
2 | version_control | 上游SCM的版本控制系统类型 | String | - | NO |
3 | scm_repo | 上游SCM仓库地址 | String | - | NO |
4 | scm_branch | 上游SCM跟踪分支 | String | - | NO |
5 | scm_commit | 上游代码最新处理过的Commit ID | String | - | YES |
6 | repo | 包源码在Gitee的仓库地址 | String | Primary | NO |
7 | branch | 包源码在Gitee的仓库分支 | String | Primary | NO |
8 | enabled | 是否启动跟踪 | Boolean | - | NO |
序号 | 名称 | 说明 | 类型 | 键 | 允许空 |
---|---|---|---|---|---|
1 | issue | issue编号 | String | Primary | NO |
2 | repo | 包源码在Gitee的仓库地址 | String | - | NO |
3 | branch | 包源码在Gitee的仓库分支 | String | - | NO |
Repo 源挂载正式发布地址:https://repo.openeuler.org/
rpm 包获取地址:https://build.openeuler.org/package/show/openEuler:20.09/patch-tracking
使用 dnf 挂载 repo源(需要 20.09 或更新的 repo 源,具体方法参考应用开发指南),然后执行如下指令下载以及安装pkgship及其依赖。
执行以下命令安装patch-tracking
。
dnf install patch-tracking
首先安装相关依赖。
dnf install python3-uWSGI python3-flask python3-Flask-SQLAlchemy python3-Flask-APScheduler python3-Flask-HTTPAuth python3-requests python3-pandas
以patch-tracking-1.0.0-1.oe1.noarch.rpm
为例,执行如下命令安装。
rpm -ivh patch-tracking-1.0.0-1.oe1.noarch.rpm
执行如下命令生成证书。
openssl req -x509 -days 3650 -subj "/CN=self-signed" \
-nodes -newkey rsa:4096 -keyout self-signed.key -out self-signed.crt
将生成的 self-signed.key
和 self-signed.crt
文件拷贝到 /etc/patch-tracking 目录
在配置文件中对相应参数进行配置,配置文件路径为 /etc/patch-tracking/settings.conf
。
配置服务监听地址。
LISTEN = "127.0.0.1:5001"
GitHub Token, 用于访问托管在 GitHub 上游开源软件仓的仓库信息 , 生成 GitHub Token 的方法参考 Creating a personal access token 。
GITHUB_ACCESS_TOKEN = ""
对于托管在gitee上的需要跟踪的仓库,配置一个有该仓库权限的gitee的token,用于提交patch文件,提交issue,提交PR等操作。
GITEE_ACCESS_TOKEN = ""
定时扫描数据库中是否有新增或修改的跟踪项,对扫描到的跟踪项执行获取上游补丁任务,在这里配置扫描的时间间隔,数字单位是秒。
SCAN_DB_INTERVAL = 3600
命令行工具运行过程中,POST接口需要填写进行认证的用户名和口令哈希值。
USER = "admin"
PASSWORD = ""
USER
默认值为admin
。
执行如下指令,获取口令的哈希值,其中Test@123为设置的口令。
[root]# generate_password Test@123
pbkdf2:sha256:150000$w38eLeRm$ebb5069ba3b4dda39a698bd1d9d7f5f848af3bd93b11e0cde2b28e9e34bfbbae
口令值
需要满足如下复杂度要求:
- 长度大于等于6个字符
- 必须包含大写字母、小写字母、数字、特殊字符(~!@#%^*-_=+)
将口令的哈希值pbkdf2:sha256:150000$w38eLeRm$ebb5069ba3b4dda39a698bd1d9d7f5f848af3bd93b11e0cde2b28e9e34bfbbae
配置到PASSWORD = ""
引号中。
可以使用以下两种方式启动服务。
使用systemd方式。
systemctl start patch-tracking
直接执行可执行程序。
/usr/bin/patch-tracking
将需要跟踪的软件仓库和分支与其上游开源软件仓库与分支关联起来,可以通过以下三种方式实现。
参数含义:
--user :POST接口需要进行认证的用户名,同settings.conf中的USER参数
--password :POST接口需要进行认证的口令,为settings.conf中的PASSWORD哈希值对应的实际的口令字符串
--server :启动Patch Tracking服务的URL,例如:127.0.0.1:5001
--version_control :上游仓库版本的控制工具,只支持github
--repo: 需要进行跟踪的仓库名称,格式:组织/仓库
--branch :需要进行跟踪的仓库的分支名称
--scm_repo :被跟踪的上游仓库的仓库名称,github格式:组织/仓库
--scm_branch: 被跟踪的上游仓库的仓库的分支
--enabled :是否自动跟踪该仓库
例如:
patch-tracking-cli add --server 127.0.0.1:5001 --user admin --password Test@123 --version_control github --repo testPatchTrack/testPatch1 --branch master --scm_repo BJMX/testPatch01 --scm_branch test --enabled true
参数含义:
--server :启动Patch Tracking服务的URL,例如:127.0.0.1:5001
--user :POST接口需要进行认证的用户名,同settings.conf中的USER参数
--password :POST接口需要进行认证的口令,为settings.conf中的PASSWORD哈希值对应的实际的口令字符串
--file :yaml文件路径
将仓库、分支、版本管理工具、是否启动监控等信息写入yaml文件(例如tracking.yaml),文件路径作为--file
的入参调用命令。
例如:
patch-tracking-cli add --server 127.0.0.1:5001 --user admin --password Test@123 --file tracking.yaml
yaml文件内容格式如下,冒号左边的内容不可修改,右边内容根据实际情况填写。
version_control: github
scm_repo: xxx/xxx
scm_branch: master
repo: xxx/xxx
branch: master
enabled: true
version_control :上游仓库版本的控制工具,只支持github
scm_repo :被跟踪的上游仓库的仓库名称,github格式:组织/仓库
scm_branch :被跟踪的上游仓库的仓库的分支
repo :需要进行跟踪的仓库名称,格式:组织/仓库
branch :需要进行跟踪的仓库的分支名称
enabled :是否自动跟踪该仓库
在指定的目录,例如test_yaml
下放入多个xxx.yaml
文件,执行如下命令,记录指定目录下所有yaml文件的跟踪项。
参数含义:
--user :POST接口需要进行认证的用户名,同settings.conf中的USER参数
--password :POST接口需要进行认证的口令,为settings.conf中的PASSWORD哈希值对应的实际的口令字符串
--server :启动Patch Tracking服务的URL,例如:127.0.0.1:5001
--dir :存放yaml文件目录的路径
patch-tracking-cli add --server 127.0.0.1:5001 --user admin --password Test@123 --dir /home/Work/test_yaml/
参数含义:
--server :必选参数,启动Patch Tracking服务的URL,例如:127.0.0.1:5001
--table :必选参数,需要查询的表
--repo :可选参数,需要查询的repo;如果没有该参数查询表中所有内容
--branch :可选参数,需要查询的branch
patch-tracking-cli query --server <LISTEN> --table tracking
例如:
patch-tracking-cli query --server 127.0.0.1:5001 --table tracking
patch-tracking-cli query --server <LISTEN> --table issue
例如:
patch-tracking-cli query --server 127.0.0.1:5001 --table issue
patch-tracking-cli delete --server SERVER --user USER --password PWD --repo REPO [--branch BRANCH]
例如:
patch-tracking-cli delete --server 127.0.0.1:5001 --user admin --password Test@123 --repo testPatchTrack/testPatch1 --branch master
可以删除指定repo和branch的单条数据;也可直接删除指定repo下所有branch的数据。
登录Gitee上进行跟踪的软件项目,在该项目的Issues和Pull Requests页签下,可以查看到名为[patch tracking] TIME
,例如 [patch tracking] 20200713101548
的条目,该条目即是刚生成的补丁文件的issue和对应PR。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。