STM32_gitea workflow

目录

• 简介
• 使用Dockerfile构建docker镜像
• [配置gitea和act runner](#配置gitea和act runner)
• workflow
• 数据传递
• • • 编译产物
    • USB设备
• [ACT Runner 的默认配置](#ACT Runner 的默认配置)
• [docker 源问题解决](#docker 源问题解决)

简介

实现STM32 开发的自动烧录动作，每一次git push向私有仓库推送之后，仓库会触发act runner 活动，act runner 会拉取最新代码，启动工具链的docker做编译和烧录。

使用Dockerfile构建docker镜像

dockerfile用于创建虚拟机镜像，这里主要是安装一些软件。做好之后后面自动化的时候就不用每次都临时安装，费时费力。

这个镜像做好之后，每次编译都会再这个镜像中做。

# 拉取基础镜像
FROM ubuntu:24.04

# 软件源先设置为HTTP，下载ca-certificates，解决HTTPS证书问题
RUN sed -i 's|https://|http://|g' /etc/apt/sources.list.d/ubuntu.sources && \
    sed -i 's|http://archive.ubuntu.com|http://mirrors.tuna.tsinghua.edu.cn|g' /etc/apt/sources.list.d/ubuntu.sources && \
    sed -i 's|http://security.ubuntu.com|http://mirrors.tuna.tsinghua.edu.cn|g' /etc/apt/sources.list.d/ubuntu.sources
RUN apt-get update && \
    apt-get install -y ca-certificates

# 将软件源恢复为 HTTPS，并安装编译工具
RUN sed -i 's|http://mirrors.tuna.tsinghua.edu.cn|https://mirrors.tuna.tsinghua.edu.cn|g' /etc/apt/sources.list.d/ubuntu.sources

RUN apt-get update && \
    apt-get install -y cmake make git build-essential gcc-arm-none-eabi usbutils\
    openocd binutils-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib

# 清空软件包缓存
RUN rm -rf /var/lib/apt/lists/*

如果出现了如下两种报错，都是正常的

# 构建过程没有终端，会报如下错误
debconf: delaying package configuration, since apt-utils is not installed

man-db 没装， 没有影响
update-alternatives: warning: skip creation of /usr/share/man/man1/fakeroot.1.gz...

配置gitea和act runner

act runner 是gitea的包工头。每次触发工作流之后，gitea都会找到act runner，让它把活干了。

这两者的绑定是通过TOKEN来做的

gitea里创建runner

act runner 的docker 创建的时候将docker传递过去

这样runner就做好了

workflow

.gitea/workflows/build.yml

name: STM32 Build and Flash

on:
  push:
    branches: [main, master]
  workflow_dispatch:

jobs:
  build-and-flash:
    runs-on: ubuntu-latest
    container:
      image: ubuntu-dev
      volumes:
        - /dev:/dev:rw
        - /dev_result:/dev_result:rw
      options: --privileged
    
    steps:
      - name: Clone
        run: |
          rm -rf /dev_result/STM32F4
          git clone http://token:${{ secrets.GITEA_TOKEN }}@192.168.4.41:3000/wwl/STM32F4.git /dev_result/STM32F4

      - name: Debug USB
        run: |
          ls -la /dev/stlink
          ls -la /dev/bus/usb/*
          lsusb 2>/dev/null || echo "no lsusb"

      - name: Build and flash
        run: |
          cd /dev_result/STM32F4
          make clean && make -j4
          openocd -f interface/stlink.cfg -f target/stm32f0x.cfg \
            -c "transport select hla_swd" \
            -c "program build/STM32F070.hex verify reset exit"

数据传递

编译产物

编译产物位于宿主机路径/dev_result, 这个路径首先要传递给act runner, 编排（compose）里要做这样一个文件夹映射

之后，runner 再启动 job container， 再传递给 ubuntu-dev

这样，克隆，编译才能用到这个文件夹。

USB设备

宿主机接STlink做烧录，追踪USB的号码是动态变化的，为了下一次插拔STlink设备流程还能正常运行，需要使用udev绑定

udev的工作原理是，将符合条件的USB设备做软链接，从而得到一个统一的入口。

宿主机上做：

mkdir -p /etc/udev/rules.d
cat > /etc/udev/rules.d/50-stlink.rules << 'EOF'
SUBSYSTEM=="usb", ATTR{idVendor}=="0483", ATTR{idProduct}=="374b", SYMLINK+="stlink", MODE="0666"
EOF

udevadm control --reload-rules
udevadm trigger

idVendor 0483 和 idProduct 374b 是过滤标识，可以通过lsusb获得。 SYMLINK 指定链接后的名字

root@i5-8600T:/etc/udev/rules.d# lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 014: ID 0483:374b STMicroelectronics ST-LINK/V2.1
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
root@i5-8600T:/etc/udev/rules.d# ls -la /dev/stlink
lrwxrwxrwx 1 root root 15 Jul 11 23:11 /dev/stlink -> bus/usb/001/014

USB设备也是要再docker中传递的，ACT runner中 编排和workfllow 中都要指定，与/dev_result同理。

ACT Runner 的默认配置

ACT Runner 默认所有volume 传递失效，默认重头拉镜像，很难用，最好自己做一次配置。

在 actrunner 上执行

act_runner generate-config > /dev_result/config.yaml

config.yaml 打开，修改如下

这个文件我们是在/dev_result文件夹上做的，是映射的宿主机路径，所以这个文件不会随着docker删除或者关闭而消失。

修改act runner环境变量，指定CONFIG 文件路径，然后重启即可解决上述问题

docker 源问题解决

https://wkdaily.cpolar.top/archives/gc