test-docker

This document describes the requirement allowing to easily run dhis2 using docker containers.

Prerequisites

• Install Docker

How to have dhis2 running in one command?

Start a terminal, then run:

git clone git://github.com/pgracio/dhis2-docker.git
cd dhis2-docker
docker-compose up -d

Once the container is up, open url http://127.0.0.1:8085 and connect using usernmame admin and password district as explained in the dhis2 documentation

When running on Mac OS X or Windows pointing to localhost will fail. It fails because de Docker Host address is not the localhost but instead the address of docker host VM. Run $ docker-machine ip default to get Docker Host address.

Docker images

Docker images can be found at Docker Hub

Using Docker Cloud for DHIS2 containers cloud deployment

Docker Cloud handles the orchestration of your infrastructure and application containers. The simplest DevOps you'll find without compromising on flexibility, they say...

Docker Cloud is free!.

Docker Cloud supports several providers:

• Amazon Web Services
• Digital Ocean
• Microsoft Azure
• SoftLayer

For testing purposes I'm using AWS Free Tier. All you have to do is

1. Create AWS Account
2. Create Docker Cloud Account or use your Docker ID if you already have one to access Docker Hub.
3. Link AWS Account with Docker Cloud
4. Create a node
5. Create and deploy stack using the following Stack file

database:
  image: 'nalinim/dhis2-db'
  environment:
    - PG_DATA=/var/lib/postgresql/data/pgdata
    - POSTGRES_DB=dhis
    - POSTGRES_PASSWORD=dhis
    - POSTGRES_USER=dhis
  volumes:
    - '/opt/dhis2/database/221-sierra-leone:/var/lib/postgresql/data'
web:
  image: 'dhis2/dhis2-web:2.25-tomcat7-jre8-latest'
  deployment_strategy: high_availability
  environment:
    - 'JAVA_OPTS=-Xmx1024m -Xms4000m'
  links:
    - database
  ports:
    - '8080'