Difference between revisions of "GWS/Current/GWSPEGuide/Deploy"
| Line 1: | Line 1: | ||
{{ArticlePEServiceDeploy | {{ArticlePEServiceDeploy | ||
|ServiceId=11ff3d39-ae2b-4526-b7e5-7dcdf781ef01 | |ServiceId=11ff3d39-ae2b-4526-b7e5-7dcdf781ef01 | ||
| + | |IncludedServiceId=c2867b76-3cf4-4d72-b8f2-cabf1986f5db | ||
|IncludeAssumptions=Yes | |IncludeAssumptions=Yes | ||
|Section={{Section | |Section={{Section | ||
| Line 17: | Line 18: | ||
First, confirm the cluster is running: | First, confirm the cluster is running: | ||
oc get clusterversion | oc get clusterversion | ||
| − | Create a new project for Web Services and Applications: | + | Create a new project for Genesys Web Services and Applications (GWS): |
oc new -project gws | oc new -project gws | ||
===GKE=== | ===GKE=== | ||
Log in to the GKE cluster from 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> | gcloud container clusters get-credentials <cluster> | ||
| − | Create a new namespace for Web Services and Applications: | + | Create a new namespace for Genesys Web Services and Applications: |
kubectl create ns gws | kubectl create ns gws | ||
|Status=No | |Status=No | ||
| Line 29: | Line 30: | ||
|anchor=deploy | |anchor=deploy | ||
|alignment=Vertical | |alignment=Vertical | ||
| − | |structuredtext=To deploy GWS, you'll need the Helm package and your override files. Copy '''values.yaml''', '''versions.yaml''' and the Helm package ('''gws-services-<version>.tgz''') to the installation location. | + | |structuredtext=To deploy GWS services, you'll need the Helm package and your override files. Copy '''values.yaml''', '''versions.yaml''' and the Helm package ('''gws-services-<version>.tgz''') to the installation location. |
For OpenShift, select the '''gws''' project you created in {{Link-SomewhereInThisVersion|manual=GWSPEGuide|topic=Deploy|anchor=OpenShift|display text=Prepare your environment}}: | For OpenShift, select the '''gws''' project you created in {{Link-SomewhereInThisVersion|manual=GWSPEGuide|topic=Deploy|anchor=OpenShift|display text=Prepare your environment}}: | ||
| Line 65: | Line 66: | ||
kubectl get all -n gws | kubectl get all -n gws | ||
The result should show all the created pods, services, ConfigMaps, and so on. | The result should show all the created pods, services, ConfigMaps, and so on. | ||
| + | |||
| + | Finally, confirm Agent Setup is accessible by navigating to '''gws.<domain>/ui/provisioning''' in a web browser. | ||
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
Revision as of 19:31, May 24, 2022
Contents
Learn how to deploy Genesys Web Services and Applications (GWS) into a private edition environment.
Assumptions
- The instructions on this page assume you are deploying the service in a service-specific namespace, 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.
Prepare your environment
To prepare your environment for the deployment, complete the steps in this section for either OpenShift or Google Kubernetes Engine (GKE).
OpenShift
Log in to the OpenShift cluster from the host where you will run the deployment:
oc login --token <token> --server <url of api server>
First, confirm the cluster is running:
oc get clusterversion
Create a new project for Genesys Web Services and Applications (GWS):
oc new -project gws
GKE
Log in to the GKE cluster from the host where you will run the deployment:
gcloud container clusters get-credentials <cluster>
Create a new namespace for Genesys Web Services and Applications:
kubectl create ns gws
Deploy
To deploy GWS services, you'll need the Helm package and your override files. Copy values.yaml, versions.yaml and the Helm package (gws-services-<version>.tgz) to the installation location.
For OpenShift, select the gws project you created in Prepare your environment:
oc project gws
For debugging purposes, use the following command to render templates without installing so you can check that resources are created properly:
helm template --debug /gws-services-<version>.tgz -f values.yaml -f versions.yaml
The result shows Kubernetes descriptors. The values you see are generated from Helm templates, and based on settings from values.yaml and versions.yaml. Ensure that no errors are displayed; you will later apply this configuration to your Kubernetes cluster.
Now you're ready to deploy Web Services and Applications:helm upgrade command.helm upgrade --install gws-services helm-staging/gws-services --version=<version> -n gws -f ./override.gws-services.values.yaml -f ./versions.yaml
Validate the deployment
First check the installed Helm release:
helm list –n gws
The result should show the gws-services deployment details. For example:
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION gws-services gws 1 2021-05-19 11:49:49.2243107 +0530 +0530 deployed gws-services-1.0.18 1.0
Check the gws-services status:
helm status gws-services
The result should show the namespace details with a status of deployed:
NAME: gws-services LAST DEPLOYED: Wed May 19 11:49:49 2021 NAMESPACE: gws STATUS: deployed REVISION: 1 TEST SUITE: None
Check the GWS Kubernetes objects created by Helm:
kubectl get all -n gws
The result should show all the created pods, services, ConfigMaps, and so on.
Finally, confirm Agent Setup is accessible by navigating to gws.<domain>/ui/provisioning in a web browser.