Racetrack Plugin: Dockerfile Job Type

This is a plugin for Racetrack which extends it with Dockerfile-based Job Type.

With Dockerfiles, you can deploy any image to Racetrack as long as it handles HTTP calls and adheres to few rules.

"dockerfile" job type itself is dead simple. It basically says that a Dockerfile will be provided by a Job, in its main directory.

It's intended to handle the HTTP calls to your Web server written in any programming language, enclosed in a docker image by Dockerfile recipe.

Setup

1. Install racetrack client and generate ZIP plugin by running make bundle.

2. Activate the plugin in Racetrack Dashboard Admin page by uploading the zipped plugin file.

Usage

You can deploy sample Dockerfile job by running:

racetrack deploy sample/dockerfile-python

Using secrets

You can use secret environment variables in your Dockerfile. Use RUN --mount=type=secret to access user's secret values without baking them into the image. The secret values will be taken according to secret_build_env_file field of a Job's manifest. If not provided, the secret will have empty data.

Basically, use RUN --mount=type=secret,id=build_secrets,target=/run/secrets/build_secrets.env in your Dockerfile command and activate the vars prepending the shell command with env $(cat /run/secrets/build_secrets.env | xargs)

Here's the example:

RUN --mount=type=secret,id=build_secrets,target=/run/secrets/build_secrets.env \
    env $(cat /run/secrets/build_secrets.env | xargs) pip install -r requirements.txt

Development

Setup & activate Python venv (this is required for local development):

# in a project-root directory
make setup
. venv/bin/activate

Releasing a new version

1. Make sure you have latest racetrack client.
2. Change the current version in a plugin-manifest.yaml
3. Create ZIP plugin: make bundle