cloudv10x/riscv-qemu-ubuntu

RISC-V测试环境

基于QEMU虚拟化的RISC-V仿真环境镜像，运行最新Ubuntu（当前为24.04），专为CI/CD流水线设计。

镜像概述

本镜像提供Docker化的RISC-V仿真环境，核心目标包括：

• RISC-V应用与系统的测试验证
• 通过GitHub Actions集成CI/CD流水线

核心功能

• 自动QEMU环境搭建与启动
• 内置GitHub Actions工作流模板及辅助脚本
• 支持本地测试与自定义配置
• 日志收集与工件上传功能
• 可配置的虚拟机资源（内存、CPU等）

使用场景

1. CI/CD流水线集成：在代码推送时自动执行RISC-V应用测试
2. 本地开发调试：快速搭建RISC-V仿真环境验证程序兼容性
3. 系统兼容性验证：测试RISC-V系统组件的运行稳定性

配置说明

环境变量

Cloud-Init配置

可通过修改以下文件自定义虚拟机初始化：

• /cloud-init/user-data
• /cloud-init/meta-data
• /cloud-init/network-config

部署示例

1. GitHub Actions集成

yaml
name: RISC-V测试
on:
  push:
    branches: [ main, dev ]

jobs:
  riscv-test:
    runs-on: ubuntu-latest
    env:
      CONTAINER_NAME: riscv-test
      LOG_DIR: ${{ github.workspace }}/var/log/qemu
      WORK_DIR: ${{ github.workspace }}
    
    steps:
      - uses: actions/checkout@v4
      
      - name: 搭建RISC-V环境
        run: |
          # 加载辅助函数
          source .github/scripts/common.sh          
          mkdir -p "${LOG_DIR}"
          
          start_qemu_container "${CONTAINER_NAME}" "${WORK_DIR}" "${LOG_DIR}"
          
          # 等待系统启动
          wait_for_qemu_boot "${CONTAINER_NAME}" "${LOG_DIR}/console.log"
      
      - name: 执行测试
        run: |
          # 系统验证
          source .github/scripts/common.sh
          run_guest "uname -a"
          run_guest "cat /etc/os-release"
          
          # 在此添加你的测试命令
          # 使用类似函数构建/测试应用
      
      - name: 上传日志
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: riscv-logs
          path: ${{ env.LOG_DIR }}

2. 本地构建与运行

bash
make build
make run

# 自定义配置运行
docker run -d -t --name riscv-test --privileged \
-e AUTO_ATTACH=0 -e RUN_TESTS=0 \
-v "$PWD/workspace":/workspace \
-v "$PWD/var/log/qemu":/var/log/qemu \
docker.xuanyuan.run/cloudv10x/riscv-qemu-ubuntu:latest

许可证

本项目采用MIT许可证，详情请查看LICENSE文件。

参考资料

• https://www.qemu.org/docs/master/system/target-riscv.html
• https://ubuntu.com/download/risc-v
• https://docs.github.com/en/actions