From commits-return-8761-archive-asf-public=cust-asf.ponee.io@fineract.apache.org Fri May 8 20:02:26 2020 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 76E6F180647 for ; Fri, 8 May 2020 22:02:26 +0200 (CEST) Received: (qmail 27441 invoked by uid 500); 8 May 2020 20:02:25 -0000 Mailing-List: contact commits-help@fineract.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@fineract.apache.org Delivered-To: mailing list commits@fineract.apache.org Received: (qmail 27432 invoked by uid 99); 8 May 2020 20:02:25 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 08 May 2020 20:02:25 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 7387F85E29; Fri, 8 May 2020 20:02:25 +0000 (UTC) Date: Fri, 08 May 2020 20:02:25 +0000 To: "commits@fineract.apache.org" Subject: [fineract] branch develop updated: add "Instructions to build the JAR file" to README MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Message-ID: <158896814534.31197.4756221223177998288@gitbox.apache.org> From: vorburger@apache.org X-Git-Host: gitbox.apache.org X-Git-Repo: fineract X-Git-Refname: refs/heads/develop X-Git-Reftype: branch X-Git-Oldrev: bee3fb7ce52dc1d39f7e7adc1bf299786a7323ad X-Git-Newrev: c6b5b2776beea5464589e34cf04bbb6f21d43747 X-Git-Rev: c6b5b2776beea5464589e34cf04bbb6f21d43747 X-Git-NotificationType: ref_changed_plus_diff X-Git-Multimail-Version: 1.5.dev Auto-Submitted: auto-generated This is an automated email from the ASF dual-hosted git repository. vorburger pushed a commit to branch develop in repository https://gitbox.apache.org/repos/asf/fineract.git The following commit(s) were added to refs/heads/develop by this push: new c6b5b27 add "Instructions to build the JAR file" to README c6b5b27 is described below commit c6b5b2776beea5464589e34cf04bbb6f21d43747 Author: Michael Vorburger ⛑️ AuthorDate: Fri May 8 13:04:19 2020 +0200 add "Instructions to build the JAR file" to README --- README.md | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 342e9a5..bb455c2 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,6 @@ Requirements ============ * Java >= 11 (OpenJDK JVM is tested by our CI on Travis) * MySQL 5.5 -* Tomcat 9, if deploying to a separate servlet container. Until FINERACT-730, Tomcat 7/8 were also supported, but now Tomcat 9 is required. You can run the required version of the database server in a container, instead of having to install it, like this: @@ -32,6 +31,8 @@ and stop and destroy it like this: Beware that this database container database keeps its state inside the container and not on the host filesystem. It is lost when you destroy (rm) this container. This is typically fine for development. See [Caveats: Where to Store Data on the database container documentation](https://hub.docker.com/_/mysql) re. how to make it persistent instead of ephemeral. +Tomcat v9 is only required if you wish to deploy the Fineract WAR to a separate external servlet container. Note that you do not require to install Tomcat to develop Fineract, or to run it in production if you use the self-contained JAR, which transparently embeds a servlet container using Spring Boot. (Until FINERACT-730, Tomcat 7/8 were also supported, but now Tomcat 9 is required.) + Instructions how to run for local development ============ @@ -42,7 +43,7 @@ Run the following commands: 1. `./gradlew bootRun` -Instructions to download gradle wrapper +Instructions to download Gradle wrapper ============ The file fineract-provider/gradle/wrapper/gradle-wrapper.jar binary is checked into this projects Git source repository, but won't exist in your copy of the Fineract codebase if you downloaded a released source archive from apache.org. @@ -61,13 +62,23 @@ Instructions to run Apache RAT (Release Audit Tool) 2. Run `./gradlew rat`. A report will be generated under build/reports/rat/rat-report.txt +Instructions to build the JAR file +============ +1. Extract the archive file to your local directory. +2. Run `./gradlew clean bootJar` to build a modern cloud native fully self contained JAR file which will be created at `build/libs` directory. +3. Start it using `java -jar build/libs/fineract-provider.jar` (does not require external Tomcat) + + Instructions to build a WAR file ============ 1. Extract the archive file to your local directory. -2. Run `./gradlew clean bootWar` or `./gradlew build` to build a deployable war file which will be created at build/libs directory. +2. Run `./gradlew clean bootWar` to build a traditional WAR file which will be created at `build/libs` directory. +3. Deploy this WAR to your Tomcat v9 Servlet Container. + +We recommend using the JAR instead of the WAR file deployment, because it's much easier. -Instructions to execute Integration tests +Instructions to execute Integration Tests ============ > Note that if this is the first time to access MySQL DB, then you may need to reset your password. @@ -81,8 +92,9 @@ Instructions to run using Docker and docker-compose =================================================== It is possible to do a 'one-touch' installation of Fineract using containers (AKA "Docker"). -Fineract now packs the mifos community-app web ui in it's docker deploy. -You can now run and test fineract with it a GUI directly from the combined docker builds. +Fineract now packs the mifos community-app web UI in it's docker deploy. +You can now run and test fineract with a GUI directly from the combined docker builds. +This includes the database running in a container. As Prerequisites, you must have `docker` and `docker-compose` installed on your machine; see [Docker Install](https://docs.docker.com/install/) and @@ -103,9 +115,9 @@ Now to run a new Fineract instance you can simply: 1. community-app (UI) is running at http://localhost:9090/?baseApiUrl=https://localhost:8443/fineract-provider&tenantIdentifier=default 1. login using default _username_ `mifos` and _password_ `password` -The [`docker-compose.yml`](docker-compose.yml) will build the `fineract` container from the source based on the [`Dockerfile`](Dockerfile). +The [`docker-compose.yml`](docker-compose.yml) will build the `fineract` container from the source based on the [`Dockerfile`](Dockerfile). You could change that to use the pre-built container image instead of having to re-build it. -https://hub.docker.com/r/apache/fineract has a pre-built container of this project, built continuously. +https://hub.docker.com/r/apache/fineract has a pre-built container image of this project, built continuously. You must specify the MySQL tenants database JDBC URL by passing it to the `fineract` container via environment variables; please consult the [`docker-compose.yml`](docker-compose.yml) for exact details how to specify those. @@ -182,7 +194,7 @@ The project uses Jacoco to measure unit tests code coverage, to generate a repor Generated reports can be found in build/code-coverage directory. -Version +Versions ============ The latest stable release can be viewed on the develop branch: [Latest Release on Develop](https://github.com/apache/fineract/tree/develop "Latest Release").