This topic is usually the biggest source of problems and trial-and-error frustrations when deploying cloud-native applications for the first time.
As much as the Kool.dev project and the whole community try to help and facilitate container image building, it is at times ultimately an individual and singular process for your web application.
That being said, there's no escape from having some knowledge of how to properly build your images to deploy your app to the cloud—or at least seek such knowledgeable hands to assist you in this moment.
For the most basic cases — like if you are using one of our presets — you will have a great starting point by using our utility along with
kool cloud setup. This command will inquire about basic options for building your container images.
kool cloud deploy building images
kool CLI is going to handle the build of your images locally—in your own host system. That means it's required that the environment where you are going to run
kool cloud deploy has a working Docker-like engine running that can successfully process a
docker build ... command.
The syntax configuration for building your deploy image for a given service in
kool.cloud.yml is the very same as you use it locally in
Check out the Docker Compose
build Documentation for reference.
build: . # this uses the root folder as context, and expects a Dockerfile to exist on it
context: ./dir # changes the context folder
dockerfile: Dockerfile-alternate # name a different file than default 'Dockerfile'
buildno: 1 # define values for ARGS used in your Dockerfile
Your image will be built locally when running the
kool CLI for a deploy and then pushed securely to the Kool.dev Cloud registry to a repository dedicated to your app environment.
Using a Private Registry
You may already have or use your own private registry for handling images. You are welcome to hold the build process apart from the
kool cloud deploy step and just use the already built images in your
If that registry is private, you need to provide Kool.dev Cloud with credentials to read from that repo. As this is not yet fully automated, you can contact us via email at
firstname.lastname@example.org to set it up for you.