管理员操作指南

用户配置仓库简介

本配置仓库结构如下:

├── docs (相关文档)
│   ├── figures (文档中包含的图片)
│   ├── templates (系统配置 json 文件模板)
│   │   ├── package_template.json (软件包编译任务配置信息)
│   │   └── user_template.json (工程师 Gitee 账户相关信息)
│   ├── gitee_webhook_config.md
│   |   (工程师需要仔细阅读的文档, Gitee Webhook 配置文档)
│   └── jenkins_jobs_config.md
│       (管理员需要仔细阅读的文档, Jenkins Jobs 配置文档)
├── README.md (本文档)
├── tools (配置信息相关小工具)
│   └── oepkgs_djtools (配置生成辅助工具,oepkgs Database&Json tools )
└── users (工程师 Gitee 账户信息)
    ├── e (工程师用户名首字母)
    │   └── eulerblade.json (某个工程师 Gitee 账户信息文件)
    └── o
        └── ocean-killer.json

配置仓库使用简述

步骤说明:

  1. 工程师需要先在 user 列表中注册,从管理员处取得用户名和验证口令后才可以使用编包系统。

    • 先在 user 仓库提交 commit, 并向 upstream 仓库提交 PR。 这个 commit 必须是在仓库中创建一个新的 user 描述 JSON 文件,应包含以下内容:
      • 拟使用的用户名,暨仓库中用户描述 JSON 文件的 user 字段;

      • 自己的工程管理配置仓库地址和使用分支,prj_repo 和 prj_branch 字段;

  2. 管理员审核工程师的注册提交。如果接受,则合并 PR 并再提交一个相关的 commit 到 upstream 仓库。

  3. 管理员使用 tools/oepkgs_djtools 工具将新用户信息加入数据库,并生成身份验证phrase发还新注册用户。

之后工程师需要自己完成后续工作,具体步骤参见:用户工程仓库配置说明

使用 oepkgs_djtools 脚本

此工具为“管理员”专用。

在 tools 目录下有一个 oepkgs_djtools 脚本帮你方便的完成数据库用户信息维护管理工作, 使用方法如下:

oepkgs_djtools imort -t user -d database -j jsonfile

工具脚本将读取指定的用户描述 JSON 文件,并将其中的信息加入指定数据库中,创建 JSON 所描述的用户。

第一次注册的用户或者根据用户要求,管理员可以使用此工具初始化用户的口令密码。

oepkgs_djtools initpass -d database -j jsonfile [-p/--password] new-passphrase

如果 -p/–password 参数被使用,系统将用户的密码初始化为指定字符串,若未指定,将生成随机字符串初始化用户设置。初始化完成后将明文回显密码。

此密码需要管理员提供给用户,并且仅限客户端修改密码认证身份使用,工程师必须使用它成功修改密码后方可使用其它功能。

JSON 文件的路径和命名规则

user

每个 user 信息都存放在一个 JSON 文件中,文件名一般和用户名相同,用户名目前只支持字母开头。用户文件应放在当前管理仓库的 users 目录下用户名首字母为名称的子目录中。

users/o/oepkgs_bot.json

管理员手册

Copyright © oepkgs.net All rights reserved.

版权所有 © oepkgs.net 保留所有权利

中国科学院软件研究所openEuler 社区共同发起并提供支持

京ICP备05046678号-13

Email: support(at)oepkgs.net