IAR Build Tools for Arm on Bitbucket Pipelines

Warning

The information in this repository is subject to change without notice and does not constitute a commitment by IAR. While it serves as reference model for implementing Continuous Integration with IAR Tools, IAR assumes no responsibility for any errors, omissions, or specific implementations.

Introduction

This repository provides a reasonably simple example to start with, alongside general guidelines on how a CI/CD pipeline can be set up on Bitbucket, using Bitbucket-hosted runners to automatically build, test, and deploy a project with the IAR Build Tools for Arm.

In case you need an introduction on how to get started with Bitbucket, refer to Getting started with Bitbucket.

Prerequisites

Before you begin, you will need:

• A CI Token for the IAR Build Tools¹
• A Bitbucket account.

Quickstart

Importing the repository

Under your Bitbucket account:

• Click Import repository . (https://bitbucket.org/<username>/workspace/repository/import)
• Fill Old repository with this repository's URL.
• Set the Project name*. (e.g., ci)
• Set the Repository name*. (e.g., bitbucket-ci-example)
• Set the Access level to [x] Private.
• Finally click Import repository. Once the importing process is complete, Bitbucket will take you to your newly imported repository.

Setting up your CI Token

Under your Repository settings:

• Enter a new secret repository variable uner Repository variables.
• Name it IAR_LMS_BEARER_TOKEN, and paste your CI Token under Value.
• Make sure Secured is selected and click Add .

Bitbucket pipeline example

On your private repository, navigate to bitbucket-pipelines.yml workflow file. This file uses the Bitbucket-flavored YAML to describe an example of a pipeline workflow containing multiple jobs typically performed in embedded firmware projects.

Note

• Refer to the bitbucket-pipelines.yml workflow file for detailed comments.
• Learn how to configure your pipeline.

Test your pipeline

Now we are good to perform a quick test to see if your runner is taking jobs properly.

• From the repository page, go to Settings → Pipelines.
• Check [x] Enable Pipelines.
• Go to Pipelines → Run pipeline.

Now you and/or your team can start pushing code to your repository and get automated results.

Summary

This example provided an overview of how to get started with the IAR Build Tools for Arm on Bitbucket pipelines. Development teams can immediately benefit from the comprehensive feedback these modern workflows offer, enabling them to quickly build, analyze, test, and deploy with high quality.

Follow us on GitHub to get updates about examples like this and more.

Issues

For technical support contact IAR Customer Support.

For questions or suggestions related to this example: try the wiki or check earlier issues. If those don't help, create a new issue with detailed information.

Footnotes

1. The use of the IAR Build Tools is subject to the IAR Software License Agreement and requires a valid subscription-based activation token for operation. If you are not yet a subscriber, please contact us for more information. ↩