An important part of the Docker ecosystem is a Docker registry. It acts as a folder of images, taking care of their storing and building. Docker Hub is the official Docker registry.
For reliability reasons, we strongly recommend to use the Amazon AWS ECR provisioned by the Keboola Developer Portal. We also support Docker Hub and Quay, both public and private repositories.
In order to run an image, pull (
docker pull) the image to your machine. The
command does that automatically for you. So, when you do:
docker run -i quay.io/keboola/docker-custom-php
you will see something like this:
Unable to find image 'quay.io/keboola/docker-custom-php:latest' locally latest: Pulling from keboola/docker-custom-php ad74af05f5a2: Pull complete 8fa9669af8ec: Pull complete Digest: sha256:ff21e0f0e58614aa5d8104d9f263552e583e6ddeb6215e83cae181d5169a150a Status: Downloaded newer image for quay.io/keboola/docker-custom-php:latest Interactive shell
When you build an image locally, push (
docker push) it to the Docker registry. Then the
image can be shared with anyone (if public), or with your organization (if private).
Because the image is defined only by the Dockerfile instructions (and optionally build context), you can take a shortcut and give the registry only the Dockerfile. The registry will then build the image on its own infrastructure. This is best done by setting up an automated deploy script or by linking a git repository containing the Dockerfile (and usually the application code) with the registry.
This may get slightly confusing because we will create a new Image Repository and link that to an existing Github Repository. Use the sample repository created in our tutorial.
Create an account and organization, and then create a new repository:
In the repository configuration, select Link to a Github Repository Push:
Then link the image repository to a Github repository. You can use our sample repository:
After that, configure the build trigger. The easiest way to do that is setting the trigger to
All Branches and Tags.
It will trigger an image rebuild on every commit to the repository.
You can also set the build trigger only to a specific branch, for example,
An alternative option is to configure the trigger to a specific tag. For Semantic versioning,
the following regular expression
^tags/[0-9]+\.[0-9]+\.[0-9]+$ ensures the image is rebuilt only
when you create a new tag.
Regardless of your chosen approach, finish setting up the trigger by completing the wizard:
Pushing a new commit into a git repository or creating a new tag (depending on the trigger setting) will now
trigger a new build of the Docker image. Also note that the image automatically inherits the git repository tag
or branch name. So, when you push a commit to the
master branch, you will get an image with a tag
will move away from any older image builds). When creating a
1.0.0 tag, you will get an image with a
When using images in Keboola Connection, we highly recommend to use our ECR repository.