You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

This is currently work in progress:  FINCN-170 - Getting issue details... STATUS INFRA-18516 - Getting issue details... STATUS


How to run fineract-cn public Docker images


There are public repositories in DockerHub for fineract-cn: 

MicroserviceTemporary DockerHub URLPull Request
Provisioner Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-provisioner/tags https://github.com/apache/fineract-cn-provisioner/pull/10
Identity Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-identity/tags https://github.com/apache/fineract-cn-identity/pull/13
Office Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-office/tags https://github.com/apache/fineract-cn-office/pull/12
Customer Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-customer/tags https://github.com/apache/fineract-cn-customer/pull/13
Accounting Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-accounting/tags https://github.com/apache/fineract-cn-accounting/pull/15
Portfolio Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-portfolio/tags https://github.com/apache/fineract-cn-portfolio/pull/17 
Deposit Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-deposit-account-management/tags https://github.com/apache/fineract-cn-deposit-account-management/pull/13
Teller Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-teller/tags https://github.com/apache/fineract-cn-teller/pull/14
Reporting Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-reporting/tags https://github.com/apache/fineract-cn-reporting/pull/10
Cheques Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-cheques/tags https://github.com/apache/fineract-cn-cheques/pull/8
Payroll Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-payroll/tags https://github.com/apache/fineract-cn-payroll/pull/12
Group Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-group/tags https://github.com/apache/fineract-cn-group/pull/12
Notification Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-notifications/tags https://github.com/apache/fineract-cn-notifications/pull/15
Rhythm Servicehttps://cloud.docker.com/repository/docker/apache/fineract-cn-rhythm/tags https://github.com/apache/fineract-cn-rhythm/pull/11
Fims Web Apphttps://hub.docker.com/r/apache/fineract-cn-fims-web-appWIP


Running a micro service public image

docker run apache/fineract-cn-xxx:latest

Or if you want to run specific version

docker run apache/fineract-cn-xxx:version.number.goes-here

You need to generate keys and pass them to docker images as environmental variables. See these instructions.

There are also docker-compose scripts available: https://github.com/apache/fineract-cn-docker-compose

How the Docker Hub has been set up


Autobuild has been configured to follow the same principles as already used with publishing to JFrog Artifactory - this means that one can trigger a build by pushing to branch "develop" and by creating a release (tag) in Github. The only exception is that pushing to other branches besides "develop" doesn't trigger creating image in Docker Hub.

Dockerhub autobuild configuration:

Docker Tag

SourceImage name
latestdevelop

apache/fineract-cn-projectname:latest

Previous build is overwritten.

release-{sourceref}

/^REL([0-9.]+)$/

-Without this configuration Docker Hub doesn't work. No build should actually trigger this.

{\1}-{\2}

/^([0-9.]+)-([0-9A-Za-z.]+)$/

Github version tag becomes image name. For example:

  • apache/fineract-cn-projectname:1.3.5-M.1
  • apache/fineract-cn-projectname:1.5.7-RC.1
  • apache/fineract-cn-projectname:1.5.7.1-RC.1
  • apache/fineract-cn-projectname:2.0.0-RELEASE
Tag name has to follow versioning scheme of fineract-cn projects (see README.md of each repo).

{\1}.{\2}.{\3}

/^([0-9]+)\.([0-9]+)\.([0-9]+)$/

Github version tag becomes image name. For example:

  • apache/fineract-cn-projectname:2.0.0"
Tag name has to follow versioning scheme of fineract-cn projects.


For autobuild to work the Dockerfile of each repository has been split into two stages:

  • build stage - builds the jar. Only the jar is passed to the run stage.
  • run stage - runs the jar built
  • No labels