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

Compare with Current View Page History

« Previous Version 12 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 URLImage built?PR
Provisioner Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-provisioner/tags+https://github.com/apache/fineract-cn-provisioner/pull/10
Identity Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-identity/tags+https://github.com/apache/fineract-cn-identity/pull/13
Office Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-office/tags+https://github.com/apache/fineract-cn-office/pull/12
Customer Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-customer/tags+https://github.com/apache/fineract-cn-customer/pull/13
Accounting Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-accounting/tags+https://github.com/apache/fineract-cn-accounting/pull/15
Portfolio Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-portfolio/tags+https://github.com/apache/fineract-cn-portfolio/pull/17 
Deposit Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-deposit-account-management/tags+https://github.com/apache/fineract-cn-deposit-account-management/pull/13
Teller Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-teller/tags+https://github.com/apache/fineract-cn-teller/pull/14
Reporting Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-reporting/tags+https://github.com/apache/fineract-cn-reporting/pull/10
Cheques Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-cheques/tags+https://github.com/apache/fineract-cn-cheques/pull/8
Payroll Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-payroll/tags+https://github.com/apache/fineract-cn-payroll/pull/12
Group Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-group/tags+https://github.com/apache/fineract-cn-group/pull/12
Notification Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-notifications/tags+https://github.com/apache/fineract-cn-notifications/pull/15
Rhythm Servicehttps://cloud.docker.com/repository/docker/aasaru/fineract-cn-rhythm/tags-https://github.com/apache/fineract-cn-rhythm/pull/11


Running a micro service public image

TODO - replace "aasaru" with "apache" once the set-up has been completed

docker run aasaru/fineract-cn-xxx:latest

Or if you want to run specific version

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


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

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