Deployment

G2P Bridge Deployment

The instructions here pertain to the deployment of all G2P Bridge components on the Kubernetes cluster using Helm charts. The charts install G2P Bridge components along with the Postgresql server specific to G2P Bridge. All the components are installed in the same namespace. The deployment may be achieved by the following methods:

• Using Rancher UI

• Using command line

Prerequisites

Before you deploy G2P Bridge, make sure the following are available:

• Base infrastructure along with domain name and certificates for Rancher and Keycloak

• Domain names and certificates specific to Social Registry.

• Nginx server configuration

  • A conf file is created under sites-enabled on Nginx containing the above SSL certs. See sample conf file.

• Namespace is created (On Rancher a namespace is created under a Project).

• Project Owner permission on the namespace of OpenG2P cluster.

• Gateways are setup for the domain as given here Istio namespace setup.

Installation using Rancher UI

1. Log in to Rancher admin console.

2. Select your cluster.

3. Under Apps -> Repositories click the Create to add a repository.

4. Provide Name as "openg2p" and target HTTPS Index URL as https://openg2p.github.io/openg2p-helm/rancher and click on Create.

5. Select the namespace in which you would like to install PBMS, from the namespace filter on the top-right.

6. To display prerelease versions of OpenG2P apps, click on your user avatar in the upper right corner of the Rancher dashboard. Then click on Include Prerelease Versions under Preferences below the Helm Charts.

7. Navigate to Apps->Charts page on Rancher. You can find the OpenG2P SPAR is listed in the dashboard.

1. Click on the Helm chart, select the version to be installed, and click Install.

2. On the next screen, choose a name for installation, like g2p-bridge. Select the checkbox Customise Helm before the installation, and then click on Next.

3. Navigate to each app's configuration page, and configure the following:

   1. Configure a hostname for each app in the following way. <appname>.<base-hostname> , where base hostname is the wildcard hostname chosen during Istio namespace setup. Example: g2p-bridge.dev.openg2p.org etc. <appname> is arbitrary - default names have been provided.

   2. Select all the recommended services you want to install. Bridge installation comes with API and Celery Background task services.

   3. Click on Next to navigate to Helm Options page. Disable wait flag. Click on Install.

   4. Watch for every pods to enter a Running state. This may take several minutes.

Access links

After installation, G2P-BRIDGE is accessible over following URLs based on the url given above:

• G2P-Bridge API: https://g2p-bridge.openg2p.sandbox.net/api/

Database

Postgresql is installed as part of the above procedure in the same namespace. The default database created is openg2p_g2p_bridge_db.

Sanity testing

TBD