Deploy GIM Config Adapter
Contents
Learn how to deploy GIM Config Adapter (GCA) into a private edition environment.
Assumptions
- The instructions on this page assume you are deploying the service in a service-specific namespace or OpenShift project, named in accordance with the requirements on Creating namespaces. If you are using a single namespace for all private edition services, replace the namespace element in the commands on this page with the name of your single namespace or project.
- Similarly, the configuration and environment setup instructions assume you need to create namespace-specific (in other words, service-specific) secrets. If you are using a single namespace for all private edition services, you might not need to create separate secrets for each service, depending on your credentials management requirements. However, if you do create service-specific secrets in a single namespace, be sure to avoid naming conflicts.
Set up your environment
To prepare your environment for the deployment, complete the steps in this section for:
Environment setup for OpenShift
- Log in to the OpenShift cluster from the remote host via CLI:
oc login --token <token> --server <URL of the API server>
- (Optional) Check the cluster version:
oc get clusterversion
- If the cluster administrator has not already done so, create a new project for GCA:
oc new-project gca
- Set the default project to GCA:
oc project gca
- Create a secret for docker-registry in order to pull images from the Genesys JFrog repository:
oc create secret docker-registry <repository secret name> --docker-server=<repository> --docker-username=<username> --docker-password=<password/API key> --docker-email=<email id> -n gca
Environment setup for GKE
- Ensure that the gcloud CLI and required Helm version are installed on the host where you will run the deployment.
- Log in to the GKE cluster from the host where you will run the deployment:
gcloud container clusters get-credentials <cluster>
- If the cluster administrator has not already done so, create a new namespace for GCA:
- Create a .json file specifying the namespace metadata. For example, create-gca-namespace.json:
{ "apiVersion": "v1", "kind": "Namespace", "metadata": { "name": "gca", "labels": { "name": "gca" } } }
- Execute the following command to create the namespace:
kubectl apply -f apply create-gca-namespace.json
- Confirm namespace creation:
kubectl describe namespace gca
- Create a .json file specifying the namespace metadata. For example, create-gca-namespace.json:
- Create a secret for docker-registry in order to pull images from the Genesys JFrog repository:
kubectl create secret docker-registry <repository secret name> --docker-server=<repository> --docker-username=<username> --docker-password=<password/API key> --docker-email=<email id> -n gca
Deploy
Execute the following command to install GCA:
helm upgrade --install <gca-helm-artifact> -f <gca-values.yaml> -n gca
Execute the following command to install GCA monitoring:
helm upgrade --install gca-monitoring <gca-monitoring-helm-artifact> -n gca
Validate the deployment
You can consider GCA deployment successful when the pod is running and in ready state. Genesys Info Mart does not report the ready state for pods until internal health checks are satisfied and the pods are operational. You can use standard kubectl commands like list and get to verify the successful deployment and readiness status of the Kubernetes objects, including connection to the database.
However, from a functional point of view, you cannot validate deployment of GCA unless GSP and GIM have been deployed as well. Do not expect consistent data until all three Genesys Info Mart services are up and running. For more details about functional checks you can perform to validate GCA deployment, see the equivalent validation section on the Deploy GIM Stream Processor page.