Image releasing

Introduction

Images release allows you to share images with specific users or teams within the factory. This release will contain all the image applications, all architectures, and for the moment, only one distribution per release.

WebUI

To release an image you need at least one built application. In order to make the release follow these steps:

  • Go on “Images” tab
  • Click on the image you want to release
  • Go on under “SETTINGS” tab
  • Expand “Release image” (at the bottom)
  • Choose a release version (e.g. 1.0)
  • Click on the “RELEASE IMAGE” button

Once the image is released you need to choose the audience (the users or teams you will share it with). You can also choose Release to all people using this factory.

  • Go on “Images” tab
  • Click on RELEASED IMAGES
  • Choose the released image you want to share
  • Go to the “AUDIENCE” tabs
  • Select one or multiples users/teams at the left
  • Click the » (move-to-the-right) button to select them
  • Click on “UPDATE AUDIENCE”

Finally, in order to use the released image outside the WebUI you need the token that was created during the release. The Repository URL and Repository access token are found in the release Overview (Images > RELEASED IMAGES > selected image). With them you will be able to use the download server that turns within the factory.

redpesk-cli

It is also possible to release an image from redpesk command line, alias rp-cli. In order to do that you have to specify the slug of the image you want to release, the distribution targeted by the release, and the release version. Additionally, you can specify a name for the “released image” that will be created.

The other flags are here if you want to set-up a specific audience for the released image:

  • One or several user(s): flag --user
  • One or several team(s): flag --team
  • The whole factory: flag --stack

In order to get the slug of your image, you can use the rp-cli images list as below.

$ rp-cli images list
ID                                       Slug                                Name                                Architecture    Type                Disabled
a3d51574-35d7-4019-b677-b0fbc13effb2     intel-upboard                       Intel-Upboard                       x86_64          iotbzh (external)   false
4e3c8997-affb-4768-ad6d-b213ff0356f0     redpesk-generic                     Redpesk-generic                     x86_64          standard            false
b4a97e36-7b8d-42f6-83c4-55ad24324f46     redpesk-minimal-arz-aarch-64-smack  Redpesk-Minimal-Arz-aarch_64-Smack  aarch64         iotbzh (external)   false
09ce0d28-00a8-4d07-9ac0-95c37c9e5bed     redpesk-minimal-arz-x86-64-smack    Redpesk-Minimal-Arz-x86_64-Smack    x86_64          iotbzh (external)   false
21bf5665-c773-4e84-8d74-bb1460323547     renesas-gen3                        Renesas-Gen3                        aarch64         iotbzh (external)   false
1205a8f4-1e7a-45f5-b581-80b7fabbc1cc     rpi3-rpi4                           Rpi3-Rpi4                           aarch64         iotbzh (external)   false
4477ebf9-5911-4bf9-bd7b-0204abc10f9b     solidrun-solidsense                 SolidRun-SolidSense                 aarch64         iotbzh (external)   false

In order to save time do not forget that rp-cli has a completion system, for example once you wrote the --distribution flag you can press TAB and rp-cli will give you the available distributions! It is the same for users or teams.

Then, run the following command (adapt the distribution, the version and eventually the audience flags to your needs):

$ rp-cli images release redpesk-generic --distribution redpesk-lts-arz-1.0 -v 1.5
-- Image release requested by user --
Checking distribution validity...					[OK]
Requesting the stack to release the image "redpesk-generic"...	[OK]
Waiting for the image "redpesk-generic" to be released...[OK]

After that, you will be able to get the list of released images using:

$ rp-cli images releases list
ID                                       Slug                   Version  Reference
b8d5d383-142a-49ae-b8b6-d0f2ae04dc72     redpesk-generic-1.5    1.5      redpesk-generic

Here below the whole release image process using rp-cli.