Skip to content
This repository was archived by the owner on Dec 16, 2024. It is now read-only.

Commit ae9024f

Browse files
committed
docs: Add steps to configure ingress class and vNext hostname
1 parent 9827778 commit ae9024f

File tree

2 files changed

+43
-6
lines changed

2 files changed

+43
-6
lines changed

README.md

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,8 +79,46 @@ kubectl get pods -n fineract-n #For testing fineract. n is a number of a finerac
7979
Copyright © 2023 The Mifos Initiative
8080
```
8181

82+
# Further Steps
83+
84+
## Ingress Class Setup
85+
Create a file anywhere with name as `ingressclass.yaml` and paste the following lines inside it:
86+
```yaml
87+
apiVersion: networking.k8s.io/v1
88+
kind: IngressClass
89+
metadata:
90+
name: nginx-ext
91+
spec:
92+
controller: k8s.io/ingress-nginx
93+
```
94+
Save the file and run the following command:
95+
```
96+
kubectl apply -f ingressclass.yaml
97+
```
98+
Now, we need to restart the ingress nginx controller, to do that hit the command:
99+
```
100+
kubectl rollout restart deploy/ingress-nginx-controller
101+
```
102+
82103
# USING THE DEPLOYED APPS
83104

105+
## Determining the IP Address - Local
106+
If you are using a local environment, then you need to run the following commands in order to fetch the IP address of the ingress cluster:
107+
```
108+
kubectl get ingress -n <namespace>
109+
```
110+
You'll get an output something similar to this:
111+
```
112+
NAME CLASS HOSTS ADDRESS PORTS AGE
113+
greenbank-backend nginx-ext greenbank.local,greenbank-specapi.local 192.168.35.121 80 5h28m
114+
...
115+
```
116+
In your host file, you need to add an entry for the address you receive here (Here, for example it is `192.168.35.121`) and add the hosts in this entry as mentioned below.
117+
118+
## Determining the IP Address - Remote
119+
In case you are using a remote virtual instance to deploy the mojafos, you'll need to create the entry of the public IP address of your instance in the host file of your machine instead of the IP of the ingress cluster.
120+
121+
84122
## Accessing Mojaloop
85123
The Mojafos scripts add the required host names to the 127.0.0.1 entry in the /etc/hosts of the "install system" i.e. the system where mojafos is run. To access Mojaloop from beyond this system it is necessary to:-
86124

@@ -90,7 +128,7 @@ ensure that http / port 80 is accessible on the install system. For instance if
90128
add the hosts listed below to an entry for the external/public ip address of that install system in the /etc/hosts file of the laptop you are using.
91129
For example if Mojaloop vNext is installed on a cloud VM with a public IP of 192.168.56.100 Then add an entry to your laptop's /etc/hosts similar to ...
92130
```bash
93-
192.168.56.100 vnextadmin.local elasticsearch.local kibana.local mongoexpress.local kafkaconsole.local fspiop.local bluebank.local greenbank.local
131+
192.168.56.100 vnextadmin.local vnextadmin fspiop.local mongohost.local greenbank.local greenbank-specapi.local bluebank.local bluebank-specapi.local
94132
```
95133

96134
You should now be able to browse or curl to Mojaloop vNext admin url using http://vnextadmin you can also access the deloyed instances of the Mojaloop testing toolkit at http://bluebank.local and http://greenbank.local or access the mongo and kafka consoles.
@@ -203,4 +241,3 @@ This tool is intended to simplify the deployment process for Payment Hub EE, Moj
203241

204242

205243

206-

src/mojafos/deployer/fin_values.yaml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ fineract:
1919
preStopScript: 'echo -e "******Fineract is stopping********";'
2020
ingress:
2121
enabled: true
22-
hostname: "2-fynams.sandbox.fynarfin.io"
22+
hostname: "1-fynams.sandbox.fynarfin.io"
2323
path: "/"
2424
wildcardhostname: "*.sandbox.fynarfin.io"
2525
annotations:
@@ -39,9 +39,9 @@ communityapp:
3939
image: "openmf/community-app:latest"
4040
ingress:
4141
enabled: true
42-
hostname: "2-communityapp.sandbox.fynarfin.io"
42+
hostname: "1-communityapp.sandbox.fynarfin.io"
4343
path: "/"
44-
wildcardhostname: "2-communityapp.sandbox.fynarfin.io"
44+
wildcardhostname: "1-communityapp.sandbox.fynarfin.io"
4545
annotations:
4646
kubernetes.io/ingress.class: "nginx"
4747
resources:
@@ -57,7 +57,7 @@ webapp:
5757
image: "fintecheando/web-app:master"
5858
ingress:
5959
enabled: true
60-
hostname: "2-webapp.sandbox.fynarfin.io"
60+
hostname: "1-webapp.sandbox.fynarfin.io"
6161
path: "/web"
6262
annotations:
6363
kubernetes.io/ingress.class: "nginx"

0 commit comments

Comments
 (0)