Trigger an image build

February 20, 2020

As shown in the screenshot below, newly created images indicate that they have not yet been built. You can change that in three different ways:

  1. Automatically trigger an image build upon every git push
  2. Manually trigger an image build
  3. Trigger an image build by calling a webhook

This will trigger a build process, in which the source code of your application is downloaded from its git repository and turned into an executable binary.

Images page after creation

A few seconds after triggering the build, the lower part of the image in the user interface will color yellow, indicating that a build is currently in progress. If this is not the case, try reloading the images page.

Image build in progress

The build process will usually take a few minutes, after which the lower part of the image goes back to grey. This means that the image build has succeeded. It is also possible that the lower part turns red, indicating that the image build has failed.

Image build finished

For more information about images and their builds, you can read the page understanding images in this documentation.

Trigger an image build by pushing to git #

The easiest way to trigger an image build is by pushing new code changes to the branch of the git repository linked to your image. Smoothy then automatically triggers an image build.

Manually trigger an image build #

You can manually trigger an image build by hovering the button in the right upper corner of the image and clicking Build image.

Trigger image build

Trigger an image build by calling a webhook #

A third option to trigger an image build is by making a POST request to the webhook that can be found on the builds page of your image.

Images page

Where to go from here? #

Now that you have triggered your first image build, you can use the image to install your application on one of your deployments. To learn how to do this, you can follow along with one of these tutorials.

Michiel Kempen

Michiel Kempen

A passionate cloud engineer who helps software companies adopt modern cloud technologies through an intelligent all-in-one cloud platform called Smoothy.