OBS 笔记

This is an old revision of the document!


OBS 笔记

重要概念

  • 工程(Project): 以工程为划分单位,以工程组织软件包。工程分为公共工程和个人工程。
    • 工程配置(Project Config): 每个工程都有的,通常用于定义编译过程所需要用到的宏、打开或关闭某些功能、循环依赖处理策略、包冲突处理策略等。
    • 工程 Metadata(Project Meta): 以 xml 格式进行记录,通常用来定义工程描述信息、工程的仓库配置信息、要编译的目标架构、编译依赖的路径信息、是否打开编译开关对外提供编译依赖等。
    • 包 Metadata(Package Meta): 通常包含包的描述信息,是否要禁用或打开某些架构的编译等。
  • 包(Package): 以包为管理单元,包为要编译的对象,所有的包都隶属于某一个工程。
  • 仓库(Repository): 仓库是用来发布包编译生成的二进制的集合,例如从仓库下载 nano 这个包可以用 dnf install nano
  • 架构(Arch): OBS 采用本地架构进行编译,没有提供交叉编译。

比如这个链接里的 home:misaka00251:VersionUpgrade 是工程名,Packages 则是工程里所有的包,旁边 Build Results 里的 AmogOS 是仓库名,riscv64 是我要编译出来的架构。

上方有个 Meta,此处就是我的工程 Metadata 文件。里面有 description 以及我要编译哪些架构的说明。

<project name="home:misaka00251:VersionUpgrade">
  <title/>
  <description>Packages need to upgrade version</description>
  <person userid="misaka00251" role="maintainer"/>
  <useforbuild>
    <disable/>
  </useforbuild>
  <repository name="AmogOS">
    <path project="openEuler:Mainline:RISC-V" repository="standard_riscv64"/>
    <arch>riscv64</arch>
  </repository>
</project>

其中 path project 那一行的意思为:我编译 riscv64 包对哪些工程有依赖。

Repositories 就是仓库,Build Flag 可以查看我打开了哪些架构的编译,Publish Flag 可以查看哪些会发布到我的 Repo 源上。

OBS 命令

OCS 的安装配置

首先安装 osc 软件包: dnf install osc

osc 的凭据位置为 ~/.oscrc,进行以下配置:

.oscrc
[general]
apiurl = https://build.openeuler.org/
no_verify = 1
 
[https://build.openeuler.org]
user=<你的用户名>
pass=<你的密码>

注意的是,密码在这里为明文密码。

基于 OBS 构建 RPM 包

社区已有软件包

  1. 进入 Project 页面
  2. 找到要构建的包所在的工程,并在详情页面搜索需要构建的软件包
  3. 点击 “branch package” 创建子工程
  4. 点击 “_service” 文件进入编辑页面并修改

如果不选择 Stay on this revision 的话,则会在创建子工程之后开始自动构建。

根据流程,要想修复一个包首先要对其进行 Fork,去 RISC-V 的 Repo 提交 PR Request(更改 configuration 目录下的 riscv_fork_list.yaml 即可),等待数分钟后便会在 openEuler-RISC-V 下出现被 Fork 的 Repo。

如果此处遇到了问题,请在微信群内汇报,会有专人处理。去这里查看失败的原因会帮忙更快的解决问题。

在自己的 Repo 做出更改之后,我们随后编辑 _service 文件来在 OBS 上自动编译:

<services>
    <service name="tar_scm">
      <param name="scm">git</param>
      <param name="url">git@gitee.com:misaka00251/nano.git</param>
      <param name="exclude">.git</param>
      <param name="revision">3fe8a8d4985a4600816f699e491bba1666b32067</param>
    </service>
    <service name="extract_file">
        <param name="archive">*.tar</param>
        <param name="files">*/*</param>
    </service>
</services>

在我这个例子内,我把 url 改成了我自己的 Repo,并指明了最新的 Revision(可以指定为 branch 或者 commit),剩下的都没有动。保存之后就会开始自动编译。

新增软件包

前提条件:你已经根据依赖关系确认了你要把新增的包加入到社区的哪个工程里面

  • 进入 Project 页面
  • 找到要新增的包所属的工程,并在详情页面点击任意软件包
  • 点击 “branch package” 创建子工程
  • 然后点击 “delete package” 删除该软件包,随后会自动进入 Branch 工程页面详情

如果之前已经 branch 过该工程下面的软件包,就不要这么做了,直接点击右上角的 Home project,进入之后点击 Subprojects,然后进入对应的 branch 工程页面详情即可。

至于删除操作是为了获得工程 metadata 文件的依赖关系。

  • 点击 “create package” 并填写相关信息
  • 点击 “Add file” 上传要新增软件包的 spec 文件及对应的源码包文件

文件上传成功之后,OBS 会自动开始构建。

openeuler_risc-v_obs.1645712692.txt.gz · Last modified: 2022/02/24 14:24 by misaka00251
CC Attribution-Share Alike 4.0 International Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International