Skip to content

drupsio/docker

Repository files navigation

Drups.io Docker

Development Docker stack for Drups.io

GitHub release GitHub license Documentation Status

Stack

Container Service name Image
Engine engine _/python
Application Back application_back _/node
Application Front application_front _/node
RabbitMQ rabbitmq _/rabbitmq
Redis redis _/redis
Postgres postgres _/postgres
Docker docker _/docker
Docker Registry registry.loc _/registry
Traefik traefik _/traefik

Requirements

  • Docker
  • Docker Compose
  • GNU Make
  • OpenSSL
  • kubectl
  • minikube (Recommended)

You need to have a running Kubernetes Cluster on your machine. We recommend using minikube. minikube is local Kubernetes, focusing on making it easy to learn and develop for Kubernetes. You can install minikube using the official guide.

Installation

  • Clone the repository: git clone git@github.com:drupsio/docker.git
  • Go to the project directory: cd docker
  • Run the project installer: make install

The installer script will clone the application parts into /apps directory, install them and run servers and daemons. You can get information about running stack (Application URLs, Credentials, etc.) by running make info.

Usage

Basic Make commands

  • make up- Pull and start up containers.
  • make stop- Stop containers.
  • make start- Start containers without updating.
  • make shell- Access engine container via shell. You can optionally pass an argument with a service name to open a shell on the specified container (e.g. make shell application_back, make shell rabbitmq).

Note: You can see all available commands by running make help.

Project Settings

Project settings are stored in the .env file. You can modify them before running make up or make install. e.g. you can change the version of Redis in the redis container by updating the REDIS_TAG variable.

Basic variables from .env

  • ENGINE_GIT_REPO/APPLICATION_GIT_REPO - Git repository of Engine/Application to clone.
  • ENGINE_GIT_BRANCH/APPLICATION_GIT_BRANCH - Git branch of Engine/Application to clone.
  • POSTGRES_USER - Username of Postgres default user.
  • POSTGRES_PASSWORD - Password of Postgres default user.

Documentation

You can see the project documentation at drupsio.rtfd.io/projects/docker.

Changelog

Please see CHANGELOG for details.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Authors

License

Copyright © 2021 Drups.io.
Released under the MIT license.