DUE TO SPAM, SIGN-UP IS DISABLED. Goto Selfserve wiki signup and request an account.
| Table of Contents |
|---|
How to run fineract-cn public Docker images
Running with Docker Compose
Docker-compose scripts for conveniently running a set of fineract Cloud Native micro services are available here.
There are also Postman scripts available to provision the micro services after one has started them.
Running individual images
There are public repositories in DockerHub for fineract-cn:
This is currently work in progress:
| Jira | ||||||
|---|---|---|---|---|---|---|
|
| Jira | ||||||
|---|---|---|---|---|---|---|
|
How to run fineract-cn public Docker images
There are public repositories in DockerHub for fineract-cn:
| Micro service | Apache URL | Temporary URL for setting up (this column be deleted once the job is completed)https://cloud.docker.com/repository/docker/ | aasaruapache/fineract-cn | -provisioner-fims-web-app/tags |
|---|
Running a micro service public imageTODO - replace "aasaru" with "apache" once the set-up has been completed
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.: https://github.com/apache/fineract-cn-docker-compose
How the Docker Hub has been set up
Autobuild has been configured for these repositories with following setup: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"
...
- if the tag has a form "numbers.and.dots-RELEASE" (case insensitive) then the docker tag will be "release-numbers.and.dots"
- example: 1.2.3-RELEASE becomes "release-1.2.3"
- example: v-1.2.3 - nothing is triggered as only numbers and dots are allowed
- if the tag has a form "numbers.and.dots" then docker tag will be: "numbers.and.dots"
- example: 1.2.3 becomes "ver-1.2.3"
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 | Source | Image name | |
|---|---|---|---|
| latest | develop | 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:
| 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:
| Tag name has to follow versioning scheme of fineract-cn projects. |
...
For autobuild to work the Dockerfile of each 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