Skip to content

Building Docker images

Create and manage Docker files as follows:

  1. Create a Dockerfile in your VSCode environment:

Name your file either Dockerfile or use a name with the .dockerfile extension.

InformationThe system provides syntax highlighting and special icons for these files.
  1. Build a Docker Image.

    1. Go to Desk main page > Deployment > Docker images.
    2. Click New Docker Image.
    3. Select your Dockerfile from the desk file system.
    4. Enter a unique name for your image (must be unique across all project images).
    5. Click Build to start the process.
  2. Monitor the building process that consists of two stages:

    1. Creating a desk snapshot
    2. Building the image

You can view real-time logs during the build process. Logs help you understand how the building process works and troubleshoot issues.

  1. After the image is built, view the image information:
  • Status (success, failed to build, in progress)
  • Creation date and time (with seconds)
  • Image name
  • Size in MB or GB
  • Autogenerated tag (8 hex symbols, e.g., 241b500f4)
  1. Manage the created images:
  • Delete images that are not currently being built.
  • Access images at both the desk and project levels.

Important notes

  • Built images are stored in the internal Docker image registry.
  • Logs for image building are available only while the process is running.
  • The context of Docker images is limited to the folder where the Dockerfile originates.
  • If changes are made to the Dockerfile, the Docker image must be rebuilt for those changes to take effect.
  • Images do not have public links and cannot be used externally.
  • Image downloading is not available in the current version.
  • Shared storage is not supported during image building. Within the project, only files from the current desk can be used. However, external sources explicitly specified in the Dockerfile will be downloaded during the build process and included in the image.