如何在GitHub Actions中进行BSD系统兼容性测试？

可用的BSD测试环境 #

GitHub Actions官方没有提供托管的BSD运行器，你有两种靠谱的选择：

• 自托管BSD运行器：在自己的FreeBSD/OpenBSD机器上部署GitHub Actions runner，直接在原生环境跑测试，兼容性最好。
• Linux runner上模拟BSD：通过QEMU虚拟机或BSD容器镜像（比如FreeBSD的官方Docker镜像）在Ubuntu runner上搭建测试环境，适合没有自有BSD机器的场景。

具体配置示例 #

1. 自托管FreeBSD运行器配置

先在你的FreeBSD机器上部署自托管runner，并给它打上freebsd标签。然后在仓库的.github/workflows/bsd-test.yml中写入以下配置：

name: BSD Compatibility Test
on: [push, pull_request]

jobs:
  freebsd-native-test:
    runs-on: [self-hosted, freebsd]
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Install build dependencies
        run: pkg install -y cmake gcc # 替换成你的项目实际依赖
      - name: Build project
        run: ./configure && make
      - name: Execute test suite
        run: make test

2. Ubuntu runner上用QEMU模拟FreeBSD

如果没有自托管机器，用QEMU在Linux上跑FreeBSD虚拟机是可行方案，以下是简化的工作流示例：

name: BSD Test via QEMU
on: [push, pull_request]

jobs:
  qemu-freebsd-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Install QEMU and tools
        run: |
          sudo apt update && sudo apt install -y qemu-system-x86 qemu-utils netcat-openbsd
      - name: Fetch FreeBSD image
        run: |
          wget -q https://download.freebsd.org/releases/amd64/13.2-RELEASE/FreeBSD-13.2-RELEASE-amd64.qcow2.xz
          unxz FreeBSD-13.2-RELEASE-amd64.qcow2.xz
      - name: Start FreeBSD VM with code mount
        run: |
          # 创建临时磁盘存储测试数据
          qemu-img create -f qcow2 data.qcow2 8G
          # 启动VM，将代码目录挂载到/mnt
          qemu-system-x86_64 -hda FreeBSD-13.2-RELEASE-amd64.qcow2 -hdb data.qcow2 \
            -m 2G -nographic -smp 2 \
            -virtfs local,path=${GITHUB_WORKSPACE},mount_tag=host0,security_model=mapped \
            -append "root=/dev/ada0 ro init=/bin/sh" &
          # 等待VM启动完成
          sleep 30
      - name: Run tests inside VM
        run: |
          # 通过串口执行命令，先挂载代码目录
          echo 'mount -t virtfs host0 /mnt' | nc localhost 5900
          # 安装项目依赖
          echo 'pkg install -y gcc cmake' | nc localhost 5900
          # 构建并运行测试
          echo 'cd /mnt && ./configure && make && make test' | nc localhost 5900

关键注意事项 #

• 包管理器差异：FreeBSD用pkg，OpenBSD用pkg_add，不要混用Linux的apt/dnf命令。
• 路径适配：BSD的默认二进制路径是/usr/local/bin，可能需要在脚本中添加export PATH=/usr/local/bin:$PATH来确保命令可被找到。
• 自托管runner维护：定期更新BSD系统和GitHub Actions runner版本，避免安全漏洞。
• 多版本覆盖：如果需要兼容多个BSD版本（比如FreeBSD 12/13/14），可以给不同版本的自托管runner打不同标签，在工作流中分别触发测试。

内容的提问来源于stack exchange，提问作者jpr42