Deployment

Social Registry Deployment

The instructions here pertain to the deployment of all Social Registry and associated components on the Kubernetes cluster using Helm charts. 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, 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 on 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 Create.

5. Select the namespace in which you would like to install Social Registry, 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 under Helm Charts.

7. Navigate to Apps->Charts page on Rancher. You should see "OpenG2P Social Registry" Helm charts listed.

1. You can ignore "Part 1" as it refers to an older version of the Helm chart, and proceed directly to "Part 2" for the updated Helm chart instructions.

2. Click on "Part 2" Helm chart, select the latest version to be installed, and click Install.

3. On the next screen, choose a name for installation, like social-registry. Select the checkbox Customise Helm options before install, and click Next.

4. Go through 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: socialregistry.dev.openg2p.org and odk-sr.dev.openg2p.org , etc. <appname> is arbitrary - default names have been provided.
   2. Keycloak Base Url is your organization-wide Keycloak URL. (Refer to Keycloak installation).
   3. OIDC Client details are asked. Create Keycloak client, refer to Keycloak Client Creation guide.
   4. To change the docker image from the default image, click on Edit YAML table and update the following section in Helm. This step is required only if you have separate docker image to be deployed or else you can go with default one skip this step.

      image:
          pullPolicy: Always
          repository: openg2p/openg2p-social-registry-odoo-package
          tag: 17.0-develop-social-registry

5. To pull docker from a private repository on Docker Hub, follow guide here. This step is required only if you have separate private docker image to be deployed or else you can go with default one skip this step.
6. Click Next to reach Helm Options page. Disable wait flag. Click on Install.

7. Wait for all pods to get into Running state. This may take several minutes.

Installation using the command line

• Install the following utilities on your machine:

  • kubectl, istioctl, helm, jq, curl, wget, git, bash, envsubst.

• TBD

Post Installation

Keycloak

Assigning roles to users

Create Keycloak client roles for the following components and assign them to users:

Component	Role name
OpenSearch Dashboards for logging	admin
OpenSearch Dashboards for Reporting	admin
Kafka UI for Reporting	Admin
Apache Superset	Admin
Minio Console	consoleAdmin

Assigning roles to clients

• For Social Registry to be able to access Keymanager APIs, create a realm role in Keycloak with the name "KEYMANAGER_ADMIN" and assign this as a service account role to the Social Registry Keycloak client.

Odoo

• Follow with Odoo post-install guide to activate Odoo modules.