a dead-simple backplane for Dockerized applications
Project description
backplane
A dead-simple backplane for your Docker Compose services. No more friction between development and production environments. git push
to deploy.
Get started
pip install backplane
backplane install
backplane start
You can now visit the dashboards of Traefik and Portainer in your browser:
Configure your containers
To expose one of your services through backplane, hook it up to the backplane
Docker network and add a label called backplane.enabled
with value true
. backplane will pick up the container's name
and expose it as a subdomain of your BACKPLANE_DOMAIN (defaults to 127-0-0-1.nip.io
):
docker-compose
version: "3.3"
services:
whoami:
image: "traefik/whoami"
container_name: "whoami"
networks:
- backplane
labels:
- "backplane.enabled=true"
networks:
backplane:
name: backplane
external: true
Your container will be exposed as http://whoami.127-0-0-1.nip.io.
Use in production
backplane can be used on public cloud hosts, too. Simply change --environment
to production
and add a mail address for LetsEncrypt. An optional --domain
can be set on installation (defaults to $SERVER_IP.nip.io
, e.g. 193-43-54-23.nip.io
).
backplane install --environment production --mail letsencrypt@mydomain.com [--domain mydomain.com]
backplane start
This enables the following additional features:
- access your backplane services as subdomains of
mydomain.com
- automatic SSL for your containers through LetsEncrypt (HTTP-Validation)
- automatic HTTP to HTTPS redirect
- sane security defaults
docker-compose
version: "3.3"
services:
whoami:
image: "traefik/whoami"
container_name: "whoami"
networks:
- backplane
labels:
- "backplane.enabled=true"
networks:
backplane:
name: backplane
external: true
Deploy to backplane
git push
your code to the built-in runner for dead-simple auto-deployment of your Docker Compose Service. The runner deploys whatever you define in the repository's docker-compose.yml
file and can load additional environment variables from a .env
file.
Update your ssh config
Add the following to your local ~/.ssh/config
file. This allows you to reach the runner under backplane
without further configuration.
Host backplane
HostName 127.0.0.1
User backplane
Port 2222
NOTE: replace "HostName" with your server's IP if you're running in production
Update your git remote
Assuming your repository is called whoami
, this is how you add the backplane runner to your git remotes:
git remote add origin "git@backplane:whoami"
Deploy to your server
git commit -am "feat: figured out who I am"
git push backplane master
That's it!
What is backplane
backplane consists of 3 main services:
- Traefik, a very popular, cloud-native reverse-proxy
- Portainer, a very popular management interface for Docker
- backplane Runner, a simple CI/CD server
It aims to provide simple access to core prerequisites of modern app development:
- Endpoint exposure
- Container management
- Deployment workflows
To develop and run modern web-based applications you need a few core ingredients, like a reverse-proxy handling request routing, a way to manage containers and a way to deploy your code. backplane offers this for local development as well as on production nodes in a seemless way.
The runner makes it easy to bypass long CI pipelines and deploy your application to a remote backplane host with ease.
backplane is mainly aimed at small to medium sized development teams or solo-developers that don't require complex infrastructure. Use it for rapid prototyping or simple deployment scenarios where the full weight of modern CI/CD offerings just isn't bearable.
You can migrate from local development to production with a simple git push
when using backplane on both ends. Think of it as a micro-PaaS that you can use locally.
Advanced configuration
backplane is only a thin wrapper around Traefik. If you require more complex routing scenarios or have more complex service setups (e.g. multiple domains per container), simply use Traefik's label-based configuration.
Read more in the docs.
Development
Dependencies
pip install poetry
poetry shell
poetry install
Build
poetry build
Generate release
semantic-release version
Publish release
semantic-release publish
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for backplane-0.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 079fe431a1b4a4c8046cf3cc175acb90e86e420e838b1da60a34899cb5830efe |
|
MD5 | 755f82dd2ad93641ef3f89259f3fc017 |
|
BLAKE2b-256 | 4edd2769f53b6be9c01bbc31e1dddd722250a3beb6240fb0341e75265aa0b044 |