infinitecoding/platformio-for-ci

PlatformIO 持续集成 Docker 镜像

镜像概述和主要用途

该Docker镜像集成PlatformIO工具链，用于在支持Docker容器的构建服务中执行CI构建任务。已在Azure Pipelines和GitHub Actions中测试通过，理论上也适用于GitLab CI、Circle CI、Travis CI等其他CI平台。镜像无入口点设计，由构建运行器在容器内直接执行任务。

在Docker Hub查看

核心功能和特性

• 预集成完整PlatformIO工具链，无需额外安装
• 支持多种CI/CD平台，兼容性广泛
• 无固定入口点，灵活适应不同构建流程
• 轻量级设计，优化CI环境部署效率
• 支持各类PlatformIO项目构建，包括嵌入式固件开发

使用场景和适用范围

• 嵌入式固件项目的自动化CI构建
• 跨平台嵌入式应用的持续集成流程
• 需要标准化构建环境的团队协作场景
• 基于Docker的CI/CD流水线集成

使用方法和配置示例

Azure Pipelines 示例

以下构建脚本使用infinitecoding/platformio-for-ci容器在Azure Pipelines中构建示例文件夹中的ESP32固件。

![Build Status]([***]

example/azure-pipelines-example.yml

yaml
trigger:
- azure-pipelines

pool:
  vmImage: 'ubuntu-latest'

resources:
  containers:
  - container: platformio
    image: infinitecoding/platformio-for-ci:latest
    endpoint: personal-docker-hub-connection

container: platformio
steps:

- script: platformio run -d ./example/
  displayName: '构建固件'

- task: CopyFiles@2
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)/example/.pio/build/esp32dev/'
    Contents: 'firmware.bin'
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

- task: PublishBuildArtifacts@1
  inputs:
    ArtifactName: '固件 $(Build.BuildNumber)'
    PathtoPublish: $(Build.ArtifactStagingDirectory)
    publishLocation: Container
    TargetPath: .

GitHub Actions 示例

以下构建脚本使用infinitecoding/platformio-for-ci容器在GitHub Actions中构建示例文件夹中的ESP32固件。

!https://github.com/Andreas-Huber/platformio-docker-for-ci/workflows/Example-CI/badge.svg?branch=github-actions

.github\workflows\platformio-example.yml

yaml
name: Example-CI

on:
  push:
    branches: [ github-actions ]

jobs:
  platformio-build:
    runs-on: ubuntu-latest
    container: infinitecoding/platformio-for-ci:latest

    steps:
      - uses: actions/checkout@v2

      - name: 构建固件
        run: platformio run -d ./example/

      - name: 上传固件制品
        uses: actions/upload-artifact@v2
        with:
          name: firmware.elf
          path: example/.pio/build/esp32dev/firmware.elf

本地运行容器

可通过本地运行容器测试PlatformIO构建功能。

Linux & macOS

在UNIX系统上构建示例文件夹中的项目，可运行以下命令或执行runBuildInDocker.sh脚本：

bash
# 将示例项目文件夹设为工作目录
cd example

# 运行构建
docker run -v `pwd`:/opt/build --name pio-build infinitecoding/platformio-for-ci:latest platformio run -d /opt/build/.

# 删除容器
docker rm pio-build

Windows

在Windows系统上构建示例文件夹中的项目，可运行以下命令或执行runBuildInDocker.ps1脚本：

powershell
# 将示例项目文件夹设为工作目录
cd example

# 运行构建
docker run -v ${pwd}:/opt/build --name pio-build infinitecoding/platformio-for-ci:latest platformio run -d /opt/build/.

# 删除容器
docker rm pio-build