Build Commands

This section documents internal build-related commands.

build upload-app-sizes

To upload application sizes to the Infra Dashboard, use the upload-app-sizes command:

idf-ci build upload-app-sizes [PATTERN] [OPTIONS]

This command searches for JUnit XML report files matching the specified glob pattern, extracts the build size information and uploads it.

Arguments:

  • PATTERN - Glob pattern for JUnit XML files (default: **/build_summary_*.xml)

Options:

  • --job-token TOKEN - GitLab CI job token for authentication (can also be specified via the CI_JOB_TOKEN environment variable)

  • --private-token TOKEN - GitLab personal access token for authentication

  • --commit-sha SHA - Commit SHA (can also be specified via the CI_COMMIT_SHA environment variable)

For GitLab authentication at least one token must be specified. If both are provided, the GitLab CI job token takes precedence over the personal access token.

Required environment variables:

  • INFRA_DASHBOARD_API_URL - Infra Dashboard API URL

  • INFRA_DASHBOARD_PROJECT_ID - Project ID where the sizes will be uploaded

Examples:

export INFRA_DASHBOARD_API_URL="https://infra-db.example.com/api"
export INFRA_DASHBOARD_PROJECT_ID="42"

# Upload size information using default pattern
idf-ci build upload-app-sizes --job-token "my-job-token" --commit-sha "a1b2c3d4e5f6..."

# Specify a custom glob pattern for XML reports
idf-ci build upload-app-sizes "build_report_*.xml" --job-token "my-job-token" --commit-sha "a1b2c3d4e5f6..."