GitHub Actions

tutorial

Custom actions

Mender provides actions for uploading Mender Artifacts and creating deployments to a group of devices. Both actions are composite and require bash and curl to be available in a used container.

The actions use Personal Access Tokens feature which is only available in Mender Server version 3.4 or newer.

In this chapter we introduce the different actions and provide examples on how to use them.

Upload a Mender Artifact action

mendersoftware/mender-gh-action-upload-artifact action uploads a Mender Artifact to a Mender Server. Find more information about the action usage in the related documentation.

Create a deployment action

mendersoftware/mender-gh-action-create-deployment action creates a deployment on a Mender Server. Find more information about the action usage in the related documentation.

Setup

The actions require the following secret to be set in a repository settings:

Pipelines examples

Build and deploy a Mender Artifact

@build-and-deploy-mender-artifact.yml@ # https://github.com/mendersoftware/mender-ci-workflows/tree/1.0.0/examples/github/build-and-deploy-mender-artifact.yml

Build and deploy multiple Mender Artifacts

@build-and-deploy-multiple-artifacts.yml@ # https://github.com/mendersoftware/mender-ci-workflows/tree/1.0.0/examples/github/build-and-deploy-multiple-artifacts.yml

Build and deploy a Mender Artifact to a single device

@deploy-to-a-single-device.yml@ # https://github.com/mendersoftware/mender-ci-workflows/tree/1.0.0/examples/github/deploy-to-a-single-device.yml

We welcome contributions to improve this documentation. To submit a change, use the Edit link at the top of the page or email us at .