# OpenEuler Rootfs Tool

**Repository Path**: Fangchao_Zheng/openEuler-Rootfs-Tool

## Basic Information

- **Project Name**: OpenEuler Rootfs Tool
- **Description**: A tool for making rootfs on Rockchip platform
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 9
- **Created**: 2022-05-24
- **Last Updated**: 2025-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# openEuler-rk-rootfs

## 介绍
openEuler rootfs tool  
用来构建openEuler在Rockchip平台上的rootfs以及docker镜像

## 使用说明

### 编译环境说明

#### Debian或Ubuntu


```
  sudo apt install git dnf python3 qemu-user-static
```
 **注意：** Debian系OS在编译时会出现rpmlist被破坏的问题，详见后文【目前已知的问题】

#### CentOS或Openeuler

  脚本在运行过程中会生成 yum repo文件，并 **破坏系统中原有的 yum repo配置**   
  如果Host系统为CentOS等使用yum包管理器的系统，则建议使用Dokcer环境进行编译，以防止原本的repo遭到破坏

### Rootfs构建

1.  编辑配置文件config.json   


-  **TargetVersion** : 目标openEuler rootfs版本
-  **SourceFile** : rootfs基础软件包列表，需要一个rpmlist文件  
-  **ImageName** : 生成的镜像名称  
-  **RootPassword** : root账户的登录密码
-  **CustomRepoEnable** ：启用用户自定义repo源，如果开启了此配置，TargetVersion配置和MirrorRepo配置均会失效
-  **CustomRepoFile** ：用户自定义repo源文件
-  **MirrorRepoEnable** ：启用yum镜像源
-  **MirrorRepoSource** ：yum镜像源repo地址
-  **RemovePackage** ：从rpmlist移除的软件包列表，默认会移除kernel与grub2相关的软件包  
-  **ExtraPackage** : 添加至rootfs中的额外软件包  


    
2.  以root权限运行脚本 main.py  


```
    sudo ./main.py
```

### Docker镜像构建

    cd docker/ 
    ./build.sh 

    执行 run.sh 运行docker image


## 其他说明

1. 默认启动了北京yum repo镜像源，可以根据网络情况替换为合适的repo源
2. 生成的rootfs镜像默认登录的用户名为 root / 123   
3. 镜像默认使能了网口及DHCP， 可以使用ssh或者串口进行登录调试  
4. 镜像适配了RK平台的adb功能(需要硬件支持usb调试)

## 依赖软件包说明
1. gdisk ： GPT分区工具，系统服务 resize-disk.service依赖
2. dpkg : Debian 包管理工具，系统服务 adbd.service依赖

## 目前已知的问题
1. 如果Host主机与目标Rootfs中的dnf不一致，编译后的roofs中无法正确读取已安装的rpmlist列表；  
  **为避免此问题，请使用与目标rootfs一致的HostOS进行编译；例如目标版本为openEuler-22.03-lts，则主机也应该使用openEuler-22.03-lts进行编译**