Skip to main content

Utility to simplify Dockerfiles

Project description

Model W Docker

A tool so that your Dockerfile looks like this:

FROM modelw/base:2023.03

COPY --chown=user package.json package-lock.json ./

RUN modelw-docker install

COPY --chown=user . .

RUN modelw-docker build

CMD ["modelw-docker", "serve"]

Organization

This repository contains different elements that work together, found in sub-directories here:

  • src — Contains the source of the modelw-docker package, that is published on Pypi.
  • image — Is the source for the Docker image that can be used as a base for all Model W projects.
  • demo — A demo project used to test the image during development

modelw-docker

This is a helper that is pre-installed in the Docker image and helps you build and run a Model W project.

If called from the root of a project, it will automatically detect the project's type and run appropriate commands for each step of the build. If later on the way the Docker image is built or the requirements of Model W change, it is expected that those changes can be reflected in the modelw-docker package without requiring the developers to change their Dockerfiles.

Available actions

  • modelw-docker install — Installs the project's dependencies (creates the virtualenv, runs npm install or whatever is required). It only requires the dependencies files to run (package.json/package-lock.json for front components, pyproject.toml/poetry.lock for api components).
  • modelw-docker build — Builds the project. It requires the project to be installed first. It also requires all the source code to be present.
  • modelw-docker serve — Runs the project. It requires the project to be installed and built first.
  • modelw-docker run — Runs a command in the project's virtualenv. It requires the project to be installed first.

The reason why install and build are separate and why you need first to copy just the dependencies list and then the source code is to allow for caching of the dependencies. This way, the dependencies are only re-installed when the dependencies list changes, not when the source code changes. This makes very fast builds when only the source code changes.

Dry run

There is a --dry-run option for all the commands that will just print what would have been done but not do it. The dry run mode is automatically enabled if you run the package outside of Docker in order to avoid fucking up your desktop.

Config file

All the settings are automatically detected, however if something isn't to your taste you can always override it using a model-w.toml file, following this structure:

[project]
# For printing purposes
name = "demo_project"
# Either "front" or "api"
component = "api"

[project.required_files]
# All the files to be created before the install step and their content
"src/demo_project/__init__.py" = ""

[apt.repos]
# APT repositories to be added, you need to give both the source and the key
# for each one of them
pgdg.source = "deb http://apt.postgresql.org/pub/repos/apt/ bullseye-pgdg main"
pgdg.key = { url = "https://www.postgresql.org/media/keys/ACCC4CF8.asc" }

[apt.packages]
# APT packages to be installed. Put * to install the default version, or a
# version number to install a specific version.
gdal-bin = "*"

In addition, Python project also have the following settings:

[project]
# [...]
# Either "gunicorn" or "daphne"
server = "daphne"

# Modules that have the WSGI and ASGI entry points
wsgi = "demo_project.django.wsgi:application"
asgi = "demo_project.django.asgi:application"

Contribution

The Docker image and the package are auto-built and published on Docker Hub and Pypi respectively. The build is triggered by pushing a tag to the repository (for the Python package) and for each branch's head (for the Docker image).

If you want to make a release, the Makefile will help you:

make release VERSION=2022.10.0

This will use Git Flow to make the release, and then also make sure to update the version in the Dockerfile and the modelw-docker package.

Once this is done, you have to:

  • Push the tag to the repository
  • Push develop and master
  • Make sure you update support branches accordingly (this cannot be automated it's a human decision)

Note — If you're releasing a new major version of Model W, you need to update the image/Dockerfile to match the new "upper" version limit. This script will only update the "lower" version limit, to make sure the image is built with the package you just released.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

modelw_docker-2024.10.1.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

modelw_docker-2024.10.1-py3-none-any.whl (16.6 kB view details)

Uploaded Python 3

File details

Details for the file modelw_docker-2024.10.1.tar.gz.

File metadata

  • Download URL: modelw_docker-2024.10.1.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.10.12 Linux/6.5.0-1025-azure

File hashes

Hashes for modelw_docker-2024.10.1.tar.gz
Algorithm Hash digest
SHA256 d8b032f835938eadf064c85e7cd42a9125bc7dd03f0b23a3911565997c10ba4a
MD5 a7ca2ca7773c079d3e75d14232bfe761
BLAKE2b-256 568986ff66c9459a498b70e7b648f36c6dd8c21965e25bfc1af0bf240254497f

See more details on using hashes here.

File details

Details for the file modelw_docker-2024.10.1-py3-none-any.whl.

File metadata

  • Download URL: modelw_docker-2024.10.1-py3-none-any.whl
  • Upload date:
  • Size: 16.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.10.12 Linux/6.5.0-1025-azure

File hashes

Hashes for modelw_docker-2024.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7140d0070ec9764bf25998cc21d2cc63747c4dcdad1586f9a15f4683b3dc3551
MD5 1eda1c1b2ac69c29269e19bc68b18d3e
BLAKE2b-256 0034f5f1d9f00139d66ecfa50e3b15b05e29ecde40116b21c2ae9b4250057b3c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page