EEA & Eionet documentation hub

Browse documentation for IT-systems used by the European Environment Agency and the Eionet network.

Docker Orchestration for ESD Review Tool

Installation

  1. Install Docker 1.10.3.

  2. Install Docker Compose 1.6.2.

  3. Install Rancher Compose 0.7.4+

Usage

Development

In order to be able to edit source-code on your machine using your favorite editor, without having to do it inside a Docker container, you’ll have to create a new user on your laptop with uid=500 and use this user for development:

$ useradd -u 500 zope-www
$ usermod -a -G docker zope-www
$ sudo su - zope-www

Now get the source code:

$ git clone https://github.com/eea/eea.docker.esdrt.git
$ cd eea.docker.esdrt/devel
$ docker-compose -f source-code.yml up

Start the application:

$ docker-compose up

Within your favorite browser head to http://localhost:8080, add a Plone site and install the following add-ons:

  • EEA Plone buildout profile
  • esdrt.theme
  • esdrt.content

Now you are ready to develop Plone Add-ons within src folder:

$ ls -l src/

Once you’re done editing, restart the application and test your changes:

$ docker-compose restart

Deployment

Pre-requirements:

  • Rancher Compose
  • Within Rancher UI register min 1 hosts with label: esdrt=yes

On your laptop:

$ git clone https://github.com/eea/eea.docker.esdrt.git
$ cd eea.docker.esdrt/deploy

Deploy on staging/demo:

$ rancher-compose --project-name esdrt-demo --env-file staging.env up -d

Deploy in production:

$ rancher-compose --project-name esdrt --env-file production.env up -d

Upgrade:

$ rancher-compose --project-name esdrt --env-file production.env up -d --upgrade

…and confirm that the upgrade went well:

$ rancher-compose --project-name esdrt --env-file production.env up -d --confirm-upgrade

…or roll-back:

$ rancher-compose --project-name esdrt --env-file production.env up -d --roll-back