CXARM container images

The IAR Build Tools for cloud-based environments and modern workflows. All the images from this registry are created directly from the IAR Releases.

Scenarios

Fetch only the base image

Using a container from the base image on GitHub Actions.

...
jobs:
  job-name:
    runs-on: ubuntu-24.04
    container: ghcr.io/fae-emea/cxarm
    steps:
    ...

Fetch a base image with device support for a single vendor

Using a container from the base image with device support on GitHub Actions. In the example below <vendor> can be additional, base, infineon, microchip, minimal, nxp, renesas, st or ti.

...
jobs:
  job-name:
    runs-on: ubuntu-24.04
    container: ghcr.io/fae-emea/cxarm:9.60.4-<vendor>
    steps:
    ...

Fetch base images with device support from multiple vendors

Using a container from the base image with device support from multiple vendors on GitHub Actions. In the example below <vendorN> can be additional, base, infineon, microchip, minimal, nxp, renesas, st or ti.

...
jobs:
  job-name-1:
    runs-on: ubuntu-24.04
    container: ghcr.io/fae-emea/cxarm:9.60.4-<vendor1>
    steps:
    ...
  job-name-2:
    runs-on: ubuntu-24.04
    container: ghcr.io/fae-emea/cxarm:9.60.4-<vendor2>
    steps:
    ...

Fetch a minimalistic image

The minimalistic image is a lightweight variant from the base image that can be used for faster fetching. It comes only with the bare essentials: the compiler and its binary utilities. For icstat and iarbuild, use the -base image instead.

...
jobs:
  job-name:
    runs-on: ubuntu-24.04
    container: ghcr.io/fae-emea/cxarm:9.60.4-minimal
    steps:
    ...

Dev container

The very same images can be used in dev containers on Visual Studio Code, by adding a .devcontainer/devcontainer.json file to the project. For example:

{
  "image": "ghcr.io/fae-emea/cxarm:9.60.4-st",
  "containerEnv": {
    "IAR_LMS_BEARER_TOKEN": "${localEnv:IAR_LMS_BEARER_TOKEN}"
  },
  "customizations": {
  "vscode": {
    "extensions": [
      "ms-vscode.cpptools-extension-pack",
      "ms-vscode-remote.vscode-remote-extensionpack",
      "ms-vscode.vscode-serial-monitor",
      "github.vscode-github-actions",
      "iarsystems.iar-debug"
      ]
    }
  }
}

Install the Remote Development Extension Pack and then use the Pallete menu (CTRL+SHIFT+P) searching for "Dev Containers: Reopen in Container".

Live example

The repository modern-workflow is a live example using a container image with device support for building and analysis of a project developed with the IAR technology.