In addition to the mender-ci-tools Docker image, Mender provides stage templates for uploading Mender Artifacts and creating deployments to a group of devices.
The templates use the Personal Access Tokens feature which is only available in Mender Server version 3.4 or newer.
In this chapter we introduce the different stages and provide examples on how to use them.
Upload Mender Artifact stage template uploads a Mender Artifact to a Mender Server.
The template has the following parameters:
mender_uri: Mender Server's URL (default: https://hosted.mender.io)mender_pat: Mender Personal Access Token (read the documentation for more information)mender_artifact: Path of Mender Artifact file, relative to $(System.DefaultWorkingDirectory)Create deployment on Mender Server stage template creates a deployment on a Mender Server.
The template has the following parameters:
mender_uri: Mender Server's URL (default: https://hosted.mender.io).mender_pat: Mender Personal Access Token (read the documentation for more information).mender_deployment_name: Mender deployment's name.mender_release_name: Mender release's name.mender_devices_list: The list of Mender devices a deployment will be triggered to.mender_deployment_group: The name of the Mender devices group your deployment will target. One of mender_deployment_group or mender_devices_list is required. mender_devices_list takes the priority if both are set.@build-and-deploy-mender-artifact.yml@ # https://github.com/mendersoftware/mender-ci-workflows/tree/1.0.0/examples/azure/build-and-deploy-mender-artifact.yml@build-and-deploy-multiple-artifacts.yml@ # https://github.com/mendersoftware/mender-ci-workflows/tree/1.0.0/examples/azure/build-and-deploy-multiple-artifacts.yml@deploy-to-a-single-device.yml@ # https://github.com/mendersoftware/mender-ci-workflows/tree/1.0.0/examples/azure/deploy-to-a-single-device.yml© 2025 Northern.tech AS