Artifakt PaaS provides specialized base docker images to build your application images.
These base images are not usable alone, as they include no code or app.
That's why Artifakt provides sample apps like this one to showcase how to build, test and deploy using our special features.
To enjoy the best experience, a recent version of Docker (>=20.10) is required. Older versions like 19.03 can work by enabling experimental features.
Docker-compose is also required. See official instructions for your own OS.
Container configuration tries to stick to 12-factor app principles as much as possible. Thus, you can edit a custom .env file containing Artifakt default env. variables.
You can use this stack to run a simple Angular stack in a few docker-compose lines.
docker-compose --env-file=.env up -d --build
NOTE: this sample repo takes code source from src folder. If you need this changed, please update the CODE_ROOT argument accordingly in docker-compose.yaml
Our standard Dockerfile defines a default workdir in /var/www/html to put your code into. By default, it is copied inside the custom docker image when you build it. The following command will build a close to production docker image on your local laptop:
DOCKER_BUILDKIT=1 docker build -t `basename $PWD`:latest --progress=plain .
We also have a development mode, with the included docker-compose file that will mount code inside the container directly, without the need to rebuild on each file update. This is a good practice and enables a fast iteration cycle.
To persist data between container updates, we inittialize a /data/ folder inside the docker image. You can use it for images, assets, uploads, cache, etc.
What happens when you build the image with our standard Dockerfile?
- base image is pulled from Artifakt free registry
- local Dockerfile is built
- if custom build args exists that are sourced from local repo
- if a build.sh script is available, it is executed
- overall, during build step we add code source and install packages and internal dependencies
- if the special folder ‘.artifakt’ is found it is copied at the container root file system for later use.
End of build step!
Here is what happens when the container runs on your workstation. We apply the same workflow in production for predictible results.
- environment variables for all dependencies are gathered: mysql, redis, elasticache, etc.
- container is created with standard volumes on /data and /var/log/artifakt.
- container is configured with standard env. variables
- container is started and runs the base image entrypoint
- base image entrypoint will look for a custom entrypoint script in /.artifakt folder and run it for you.