# upstream-repos

**Repository Path**: liu-yinsi/upstream-repos

## Basic Information

- **Project Name**: upstream-repos
- **Description**: The list of upstream repositories to track and test.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 53
- **Created**: 2022-09-27
- **Last Updated**: 2022-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 说明：此文档专用于本地部署

# UPSTREAM REPOS
本仓库用于存放上游仓库地址，本地部署的服务会实时监控这个目录中的上游仓库，当上游仓库有新的commit时，会自动触发测试任务。

## 注册上游仓库
1. 由于是本地部署，不存在需要提交文件的过程。在本地部署后的本仓库存放目录下添加对应文件即可

2. 创建目录及添加文件

目录创建规则：第一层目录的名称以上游仓库名称首个字符命名，第二层目录的名称以上游仓库名称命名，第二层目录下的文件以上游仓库名称命名

以mongodb/mongo项目为例：
```
mkdir -p m/mongo
echo 'url: https://github.com/mongodb/mongo.git' >  m/mongo/mongo
```


## 自动触发测试任务

1. 将适配好的测试用例添加到本地部署后的lkp-tests/jobs目录下，或者可以用jobs目录下已有的测试用例。

如何适配测试用例到compass-ci请参考：[add-testcase.md](https://gitee.com/wu_fengguang/lkp-tests/blob/master/doc/add-testcase.md)

2. 在本仓库中对应目录修改或新增DEFAULTS文件，以添加测试命令参数。

DEFAULTS文件在upstream-repos仓库中存在多个，同一条路径上的DEFAULTS文件会依次加载。若有相同的key，内层的DEFAULTS文件内容会覆盖外层的。里面主要存着下级目录中的repos的通用的信息。

修改和新增DEFAULTS文件都应该在尽量下级的目录，以免对其他repo的影响。文件的典型样例如下
```
submit:
- command: testbox=vm-2p16g os=openeuler os_version=20.03 os_mount=cifs os_arch=aarch64 api-avx2neon.yaml
  branches:
  - master
  - next
- command: testbox=vm-2p16g os=openeuler os_version=20.03 os_mount=cifs os_arch=aarch64 other-avx2neon.yaml
  branches:
  - branch_name_a
  - branch_name_b

```
这里的branches为命令会应用的分支。branches项可以没有，若没有，则该条命令会应用到所有分支。

master/next这些是分支的名称，可以通过git show-ref --heads命令查询仓库的分支，并去掉前缀 `refs/heads/` 。这样的分支名称才能正确匹配上，并不能随意写。