From ae18fcee0d481eb32320fa460684d9eae231e516 Mon Sep 17 00:00:00 2001
From: x30004928 <xiangyuning@huawei.com>
Date: Tue, 13 Sep 2022 19:36:05 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0obs-server=E5=A4=9A=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E5=88=86=E6=94=AF=E4=BD=BF=E7=94=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 65 ++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 57 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index b3446cd..8e83e00 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
 
 #### 参与贡献
 
-- 
Gitee