From commits-return-7915-archive-asf-public=cust-asf.ponee.io@fineract.apache.org Sun Apr 12 11:37:55 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 C2C81180608 for ; Sun, 12 Apr 2020 13:37:54 +0200 (CEST) Received: (qmail 4552 invoked by uid 500); 12 Apr 2020 11:37:54 -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 4543 invoked by uid 99); 12 Apr 2020 11:37:54 -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; Sun, 12 Apr 2020 11:37:54 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 0C7258B6AA; Sun, 12 Apr 2020 11:37:54 +0000 (UTC) Date: Sun, 12 Apr 2020 11:37:53 +0000 To: "commits@fineract.apache.org" Subject: [fineract] branch develop updated: chmod +x kubernetes/*.sh (and some README updates) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Message-ID: <158669147396.8432.1702469808776415029@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: a9c214046346b100a548b3e828734262e9a79c7a X-Git-Newrev: c9a1b38b0ea2a56b21dc9c88563db99a663729ad X-Git-Rev: c9a1b38b0ea2a56b21dc9c88563db99a663729ad 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 c9a1b38 chmod +x kubernetes/*.sh (and some README updates) c9a1b38 is described below commit c9a1b38b0ea2a56b21dc9c88563db99a663729ad Author: Michael Vorburger AuthorDate: Sat Apr 11 14:43:55 2020 +0200 chmod +x kubernetes/*.sh (and some README updates) --- README.md | 47 ++++++++++++++++++++++++++++-------------- kubernetes/kubectl-shutdown.sh | 3 +-- kubernetes/kubectl-startup.sh | 6 +++--- 3 files changed, 35 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 9326e5a..914ebf2 100644 --- a/README.md +++ b/README.md @@ -107,40 +107,55 @@ _(Note that in previous versions, the `mysqlserver` environment variable used at and the `mysqlserver` environment variable is now no longer supported.)_ -Instructions to run on kubernetes +Instructions to run on Kubernetes ================================= -You can also run Fineract using containers on a kubernetes cluster. +General Clusters +---------------- + +You can also run Fineract using containers on a Kubernetes cluster. Make sure you set up and connect to your Kubernetes cluster. You can follow [this](https://cwiki.apache.org/confluence/display/FINERACT/Install+and+configure+kubectl+and+Google+Cloud+SDK+on+ubuntu+16.04) guide to set up a Kubernetes cluster on GKE. Make sure to replace `apache-fineract-cn` with `apache-fineract` -Now from your cloud shell, run the following commands: +Now e.g. from your Google Cloud shell, run the following commands: 1. `git clone https://github.com/apache/fineract.git ; cd fineract/kubernetes` -1. `sh kubectl-startup.sh` +1. `./kubectl-startup` -To shutdown and reset your cluster, run: - `sh kubectl-shutdown.sh` +To shutdown and reset your Cluster, run: + + ./kubectl-shutdown -Alternatively, you can run fineract on a local kubernetes cluster(minikube). +Using Minikube +-------------- + +Alternatively, you can run fineract on a local kubernetes cluster using [minikube](https://minikube.sigs.k8s.io/docs/). As Prerequisites, you must have `minikube` and `kubectl` installed on your machine; see [Minikube & Kubectl install](https://kubernetes.io/docs/tasks/tools/install-minikube/). -Now to run a new Fineract instance on minikube you can simply: +Now to run a new Fineract instance on Minikube you can simply: 1. `git clone https://github.com/apache/fineract.git ; cd fineract/kubernetes` 1. `minikube start` -1. `sh kubectl-startup.sh` -1. `minikube service fineract-server --url` -1. Fineract will run at the provided url +1. `./kubectl-startup.sh` +1. `minikube service fineract-server --url --https` +1. Fineract is now running at the printed URL (note HTTP), which you can check e.g. using: + + http --verify=no --timeout 240 --check-status get $(minikube service fineract-server --url --https)/fineract-provider/actuator/health -NB : Change protocol from `http` to `https` +To check the status of your containers on your local minikube Kubernetes cluster, run: -To check the status of your containers on your local kubernetes cluster, run: - `minikube dashboard` + minikube dashboard + +You can check Fineract logs using: + + kubectl logs deployment/fineract-server To shutdown and reset your cluster, run: - `sh kubectl-shutdown.sh` + + ./kubectl-shutdown + +We have [some open issues in JIRA with Kubernetes related enhancement ideas](https://jira.apache.org/jira/browse/FINERACT-783?jql=labels%20%3D%20kubernetes%20AND%20project%20%3D%20%22Apache%20Fineract%22%20) which you are welcome to contribute to. Checkstyle @@ -154,7 +169,7 @@ You could also use Checkstyle directly in your IDE (but you don't neccesarily ha Code Coverage Reports ============ -The project uses Jacoco to measure unit tests code coverage, to generate a report run the following command: +The project uses Jacoco to measure unit tests code coverage, to generate a report run the following command: `./gradlew clean build jacocoTestReport` diff --git a/kubernetes/kubectl-shutdown.sh b/kubernetes/kubectl-shutdown.sh old mode 100644 new mode 100755 index 17c8493..e42361b --- a/kubernetes/kubectl-shutdown.sh +++ b/kubernetes/kubectl-shutdown.sh @@ -18,8 +18,7 @@ # under the License. # - kubectl delete -f secrets.yml kubectl delete -f fineractmysql-configmap.yml kubectl delete -f fineractmysql-deployment.yml -kubectl delete -f fineract-server-deployment.yml \ No newline at end of file +kubectl delete -f fineract-server-deployment.yml diff --git a/kubernetes/kubectl-startup.sh b/kubernetes/kubectl-startup.sh old mode 100644 new mode 100755 index 27fef6d..a3e393a --- a/kubernetes/kubectl-startup.sh +++ b/kubernetes/kubectl-startup.sh @@ -19,10 +19,10 @@ # echo "Setting Up Fineract service configuration..." -kubectl apply -f secrets.yml +kubectl apply -f secrets.yml kubectl apply -f fineractmysql-configmap.yml -echo "" +echo echo "Starting fineractmysql..." kubectl apply -f fineractmysql-deployment.yml @@ -37,6 +37,6 @@ while [[ ${fineractmysql_status} -ne 'Running' ]]; do fineractmysql_status=$(kubectl get pods ${fineractmysql_pod} --no-headers -o custom-columns=":status.phase") done -echo "" +echo echo "Starting fineract server..." kubectl apply -f fineract-server-deployment.yml