Default cookbook chart for GOV use case

The G2p Sandbox cookbook chart is extended from the payment hub base chart ph-ee-engine. This chart is created by setting up the payment hub with government use cases( eg: G2P, P2G) defaults.

This chart is available at: https://github.com/openMF/ph-ee-env-template/tree/master/helm/g2p-sandbox

The unreleased version with the latest development changes is tagged as version 0.0.0

The chart will not install ingresses, so the services need to be accessed using port forwarding.

Using g2pSandbox chart unreleased or developer version

The developer version (version 0.0.0) can be obtained by cloning the master branch of https://github.com/openMF/ph-ee-env-template

The first step is to prepare the chart by updating all dependencies. after updating the dependencies, the chart can either be directly deployed or packaged and uploaded to a repo(helm repo or simple object/file storage) for public access.

The uploaded chart is easy to manage and can be reused for multiple users or Circle CI HELM Orb.

The following shell commands are used to prepare the chart

cd ph-ee-env-template
helm dep up helm/g2p-sandbox
helm package helm/g2p-sandbox
helm repo index .

Now the chart is ready for uploading/ installation

For installing using the helm command do the following

helm install g2psandbox helm/g2p-sandbox --namespace paymenthub

use upload commands here to upload the packaged helm chart to shared file/ object storage. the files that need to be uploaded are : index.yaml and ph-ee-g2psandbox-0.0.0.tgz

Extending g2pSandbox chart unreleased or developer version

To add specific configurations as per the requirement/org-specific details, the developer version of the chart can be extended.

To do this a HELM chart needs to be created which extends the ph-ee-g2psandbox-0.0.0with a values.yaml file which can overwrite or add properties that get applied in the base chart.

An example of such an extension is available here: https://github.com/openMF/ph-ee-env-labs/tree/master/helm/g2p-sandbox-fynarfin-SIT

The dependency of the g2p chart needs to be added as shown below

dependencies:
- name: ph-ee-g2psandbox
  repository: <repository location>/<of>/<ph-ee-g2psandbox-0.0.0>
  version: 0.0.0

In the values.yaml, properties like organization-specific secrets, ingresses, etc. can be added by changing corresponding fields.

To add additional environment variable values that are not present in the base chart, extraEnvs feature can be used.

Extending g2pSandbox chart released version

This option is the same as the previous method explained above. Here the version of the g2psandbox chart will be a release version instead of 0.0.0.

the release version can be obtained from the latest released tag of https://github.com/openMF/ph-ee-env-template in git hub

Example: here is the g2p sandbox chart version 1.2.1 is released as part of payment hub 1.10.1 release https://github.com/openMF/ph-ee-env-template/blob/v1.10.1/helm/g2p-sandbox/Chart.yaml The released version will be uploaded to the Artifact hub for direct access.