Deployment of Example Bank

Helm Chart Deployment of OpenG2P Example Bank Simulator

Prerequisites

Before deploying the Helm charts, ensure that the following prerequisites are met:

1. Kubernetes Cluster: A Kubernetes cluster is up and running. You can use any Kubernetes provider.

2. Helm CLI: Helm CLI installed. Version 3.x or higher is recommended. You can install Helm using the official Helm installation guide.

3. Access to Docker Hub: Ensure that Docker Hub can be accessed to pull the required container images.

4. Configured Values: Update the values.yaml file with any custom settings needed for your deployment, including image versions, credentials, hostnames, etc.

Deployment Artefacts

An overview of all necessary artifacts to deploy the G2P Bridge Example Bank application, stored in designated repositories to ensure controlled access and ease of deployment.

1. Helm Chart for G2P Bridge Example Bank

• Purpose: Deploys the complete G2P Bridge suite on Kubernetes, including the API, Celery Beat (for scheduled tasks), and Celery Workers (for background processing).

• Repository: G2P Bridge Example Bank Deployment on GitHub​

• Access and Installation:

  • Add the GitHub Helm chart repository and install the openg2p-g2p-bridge-example-bank chart, which includes all Example Bank components:

    helm repo add openg2p https://github.com/OpenG2P/openg2p-g2p-bridge-example-bank-deployment
    helm repo update
    helm install openg2p-example-bank openg2p/openg2p-g2p-bridge-example-bank --namespace your-namespace

  • Environment Configuration: Ensure the required environment variables are configured before installation. Refer to Example Bank Developer section to know more about environment configuration.

2. Docker Images

• Purpose: Provides containerized versions of each G2P Bridge component for consistent and repeatable deployments.

• Repository: Docker Hub

• Available Images:

  • API: openg2p-g2p-bridge-example-bank-api​

  • Celery Workers: ​

• Usage:

  • Each image can be pulled directly from Docker Hub:

    docker pull openg2p/openg2p-g2p-bridge-example-bank-api:<version>
    docker pull openg2p/openg2p-g2p-bridge-example-bank-celery:<version>

  • Replace <version> with the specific tag or latest for the latest stable release.

2. Python Libraries

• Purpose: Provides essential libraries and dependencies for Example Bank services. These are available on PyPI and should be installed where necessary.

• Repository: PyPI (Python Package Index)​

• Available Libraries:

  • openg2p-fastapi-common: Common FastAPI components.

  • openg2p-fastapi-auth: Authentication modules.

  • openg2p-g2pconnect-common-lib: Core library for G2P Connect.

  • openg2p-g2p-bridge-example-bank-models: Database models.

  • openg2p-g2p-bridge-example-bank-api: API components.

  • openg2p-g2p-bridge-example-bank-celery: Celery tasks.

• Installation:

  • Install each required package using pip

    pip install openg2p-fastapi-common
    pip install openg2p-fastapi-auth
    pip install openg2p-g2pconnect-common-lib
    pip install openg2p-g2p-bridge-example-bank-models
    pip install openg2p-g2p-bridge-example-bank-api
    pip install openg2p-g2p-bridge-example-bank-celery

3. Post-Installation Configuration

After deploying the Example Bank, the following database table must be configured to enable the benefit program features:

• Table: accounts

• Purpose: Stores bank account details, which are essential for the operation of the G2P Bridge.

Deployment Steps

1. Clone the GitHub Repository

# Clone the GitHub repository containing the Helm charts
$ git clone https://github.com/OpenG2P/openg2p-g2p-bridge-example-bank-deployment
$ cd openg2p-g2p-bridge-example-bank-deployment/charts

2. Install Helm Dependencies

# Install the dependencies for the Helm chart
$ helm dependency update

3. Install the Helm Chart

# Install the openg2p-g2p-bridge-example-bank chart using Helm
$ helm install openg2p-g2p-example-bank ./openg2p-g2p-bridge-example-bank -f values.yaml -n <namespace>

• Replace openg2p-g2p-example-bank with the desired release name.

• Replace namespace with your kubernetes namespace.

• Use the -f flag to provide custom configurations through a values.yaml file.

4. Update Values File (Optional)

To customize the configuration, update the values.yaml file. Here's a sample of what you might want to configure:

• Set the hostname, Docker image tags, and various other configurations to match your environment.

5. Check the Deployment

After running the install command, ensure that all pods and services are running correctly.

# Check the status of the Helm release
$ helm status openg2p-g2p-example-bank

# View the Kubernetes pods and services
$ kubectl get pods,svc

6. Updating the Helm Release

If changes are made to the values.yaml or any part of the Helm chart, use the following command to upgrade the release:

$ helm upgrade openg2p-g2p-example-bank . -f ./values.yaml -n <namespace>

7. Uninstalling the Chart

To remove the deployment, run the following:

$ helm uninstall openg2p-g2p-example-bank -n <namespace>

This will delete all Kubernetes resources associated with the release.