Docker

Last update: Edit

1 Introduction

This page explains how to build a Docker image from your Mendix Project. Each release of a project will result in a unique Docker image that can be pushed through the different stages of your application pipeline.

You will learn how to do the following:

  • Build the image
  • Push the image

2 Prerequisites

Before starting these instructions, make sure you have completed the following prerequisites:

3 Building the Image

To build the Docker image, follow these steps:

  1. Install Docker on your computer.
  2. Restart the computer to ensure that you have been granted access to Docker.
  3. Unzip the buildpack in a location of your choice.
  4. Open the Command Prompt and navigate to the buildpack folder.
  5. Open an app project in Studio Pro and in the top menu, select Project > Show project directory in Explorer:

  6. Copy the project folder to the unzipped docker build folder. The project folder needs to be on the same level as the Docker file. The Docker build is not allowed to access files outside the context of the Docker build location.

  7. Execute the following command:

    docker build --build-arg BUILD_PATH="<relative-mendix-project-location>" -t <image name>
    

4 Pushing the Image

A new Docker image has been created with the name you gave it. You can see the image by using the command docker images.

Next, you need to push the image to a registry. This can be a public registry or your own. To push it to your own registry, use the command docker push <image name>.

5 Read More