diff --git a/README.md b/README.md index b3446cd2de2806ef9f972f57f1539a61f9a08e9a..8e83e006cbf1b6b6e773371e3e0b8b06b75ada5b 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,72 @@ # obs-server #### 介绍 -The Open Build Service -- Server Component +通用编译工具,用于将源码包构建为 RPM 软件包或 Linux 镜像。 #### 软件架构 -软件架构说明 +支持在多种架构平台(x86、ARM64 等)上使用 #### 安装教程 -1. xxxx -2. xxxx -3. xxxx +此处以 openEuler 22.03 LTS 版本的 AArch64 架构为例,介绍 obs-server 多版本分支软件包的安装操作。 + +1. 确认机器已安装操作系统 openEuler 22.03 LTS(镜像裁剪定制工具的运行环境)。 + + ``` shell script + $ cat /etc/openEuler-release + openEuler release 22.03 LTS + ``` + +2. 配置 yum 源,obs-server 多版本的 repo 源要优先于 everything 的 repo 源。配置内容参考如下: + + ``` shell script + [obs] + name=obs + baseurl=https://repo.openeuler.org/openEuler-22.03-LTS/EPOL/update/multi_version/obs-server/2.10.11/aarch64/ + enabled=1 + gpgcheck=0 + + [everything] + name=everything + baseurl=https://repo.openeuler.org/openEuler-22.03-LTS/everything/aarch64/ + enabled=1 + gpgcheck=0 + ``` + +3. 使 yum 源生效: + + ``` shell script + yum clean all + yum makecache + ``` + +4. 使用 root 权限,卸载包防止安装冲突;安装 obs-server 相关软件包 + + ``` shell script + $ sudo yum remove -y obs-server obs-common obs-api mod_passenger obs-api-deps obs-bundled-gems passenger ruby ruby-help ruby-irb rubygem-bundler rubygem-io-console rubygem-json rubygem-openssl rubygem-psych rubygem-rake rubygem-rdoc rubygems rubygem-bigdecimal rubygem-did_you_mean + $ sudo yum install -y obs-api obs-server + ``` + + > **obs-server 安装注意事项:** + > + >- 该分支作为 openEuler 22.03 LTS 版本发布的 obs-server 多版本分支 + >- 安装依赖包可能由于存在多个版本,导致依赖冲突安装失败。所以安装前先卸载上述软件包 + +5. 检查 obs-server 软件包安装成功 + + ``` shell script + $ rpm -qa | grep obs-server + obs-server-2.10.11-6.oe2203.noarch + $ rpm -qa | grep obs-api + obs-api-2.10.11-6.oe2203.noarch + ``` + #### 使用说明 -1. xxxx -2. xxxx -3. xxxx +可以通过obs网页和osc命令的方式构建RPM软件包。详细内容可参考《构建RPM包》文档: +https://gitee.com/openeuler/docs/blob/stable2-22.03_LTS/docs/zh/docs/ApplicationDev/%E6%9E%84%E5%BB%BARPM%E5%8C%85.md #### 参与贡献