idf-ci 0.x Documentation

This documentation describes idf-ci, a tool designed to streamline CI/CD for ESP-IDF projects, with support for both GitLab CI/CD and GitHub Actions.

Key Features:

  • Sensible Defaults

    Easy setup with default settings for idf-build-apps and pytest-embedded.

  • Build Management

    Build ESP-IDF apps for multiple targets (ESP32, ESP32-S2, ESP32-C3, etc.) with parallel builds and filtering based on changed files or test needs.

  • Test Management

    Run pytest with ESP-IDF configs, including target-specific test discovery and marker filtering.

  • GitLab CI/CD Integration

    Full pipeline support with artifacts, S3 uploads, and auto-generated jobs for builds and tests.

  • GitHub Actions Integration

    Generate a test matrix from project settings.

  • Configuration Visibility

    Inspect resolved configuration values, defaults, and override sources.

Explanations

Guides

References