kevinpalis / gobii-base

README

EBS-GOBii Base Docker Containers

This repository holds all the dockerfiles and config scripts that create the base containers for EBS-GOBii. They contain requisite software installed on an Ubuntu 18.04 LTS image. These base containers are taken by Bamboo CI/CD pipeline to run builds and integration on. After a successful build, new containers are created with the latest EBS-GOBii changes.

Repository contents

• ebs_gobii_ubuntu - This contains the footing Dockerfile that builds the base OS image by which all the foundational containers are built on. This is an attempt to unify the working environment and increase synergy between all EBS-GOBii containers, particularly when running on swarm mode.
• ebs_gobii_base_db - This is the base container for EBS-GOBii data warehouse. As of the time of this writing, this is preconfigured with PostgreSQL 12 with some optimizations to the configuration.
• ebs_gobii_base_tomcat - This is the base container for EBS-GOBii web applications and web services API. As of the time of this writing, this is preconfigured with Tomcat 9, along with modifications to the configuration.
• ebs_gobii_base_process - This is the base container for EBS-GOBii middleware. As of the time of this writing, this is preconfigured with OpenJDK 13 (packaged by Zulu).

Contribution guidelines

• Changes to the Dockerfiles:
  Ideally, the Dockerfiles here should barely change once they get to a stable version. Any changes should be approved by Kevin Palis [email protected] and thoroughly tested before being merged to the master branch. The corresponding modifications should also be made in Bamboo.
• Automated Builds: This repository triggers multiple Docker Hub repository builds. The following branches directly affect builds on one or more Docker Hub repo:
  • master - triggers ebs_gobii_ubuntu, ebs_gobii_base_db, ebs_gobii_base_process, and ebs_gobii_base_tomcat with tag:latest
  • bionic - triggers ebs_gobii_ubuntu with tag:bionic
  • tomcat([0-9.]+) - triggers ebs_gobii_base_tomcat with tag:tomcat-([0-9.]+) - Note that the latter part is a regex expression that should resolve to the version of Tomcat the container used as base
  • postgres([0-9.]+)+ - triggers ebs_gobii_base_db with tag:postgres-([0-9.]+) - Note that the latter part is a regex expression that should resolve to the version of PostgreSQL the container used as base
  • java([0-9.]+) - triggers ebs_gobii_base_process with tag:java-([0-9.]+) - Note that the latter part is a regex expression that should resolve to the version of Java the container used as base
• Code review:
  Once all the version 1 tags are in place, ie. the Dockerfiles are functional and stable, no direct merge to the master branch will be allowed. All changes should follow the gitflow workflow (modified to include the branches described above) and a corresponding PR should be created for every merge request.
• Other guidelines: These Dockerfiles and configuration scripts are foundational to the EBS-GOBii software. They contain required tools for the build system to work, ex. postgres, Java, Python, and as such unless there is a huge change in the architecture, these files should not be modified.

Who do I talk to?

• Kevin Palis [email protected]