(→Deployment Steps) |
|||
| Line 26: | Line 26: | ||
# Validate your Kubernetes credentials: | # Validate your Kubernetes credentials: | ||
| − | #* Follow the registration web-UI steps. and type | + | #* Follow the registration web-UI steps. and type <tt>gcloud container clusters list</tt> command to see all GKE clusters available to you, if any. |
| − | + | <ol start="2" style="list-style-type: decimal;"> | |
| + | <li> <p>Unpack the ''gws-microservices''.tgz file with the following command:<br /> | ||
| + | <tt>tar -zxf ''gws-microservices''.tgz</tt></p></li></ol> | ||
| − | |||
| − | |||
<ol start="3" style="list-style-type: decimal;"> | <ol start="3" style="list-style-type: decimal;"> | ||
| − | <li><p>Go to the '''kubernetes''' directory:</p></li></ol> | + | <li><p>Go to the '''kubernetes''' directory:<br /> |
| + | <tt>cd gws-microservices/kubernetes</tt> | ||
| + | </p></li></ol> | ||
| − | |||
| − | |||
<ol start="4" style="list-style-type: decimal;"> | <ol start="4" style="list-style-type: decimal;"> | ||
| − | <li><p>Modify the '''<ToBeChanged: …>''' values defined in the '''conf/gke.env''' file with the actual values required by deployment.</p></li> | + | <li><p>Modify the '''''<ToBeChanged: …''>''' values defined in the '''conf/gke.env''' file with the actual values required by deployment.</p></li> |
| − | <li><p>Apply the modified configuration file to the current bash session:</ | + | <li><p>Apply the modified configuration file to the current bash session:<br /> |
| − | + | <tt>source conf/gke.env</tt> | |
| − | < | + | </p></li></ol> |
| − | </ | ||
<ol start="6" style="list-style-type: decimal;"> | <ol start="6" style="list-style-type: decimal;"> | ||
<li><p>Deploy the monitoring stack using '''gws-monitoring-deploy.sh''' script'''.''' The script will deploy Prometheus and Grafana solutions at your Kubernetes cluster.</p></li> | <li><p>Deploy the monitoring stack using '''gws-monitoring-deploy.sh''' script'''.''' The script will deploy Prometheus and Grafana solutions at your Kubernetes cluster.</p></li> | ||
Revision as of 06:21, November 29, 2018
Contents
Deployment procedure
Prerequisites
- Kubernetes cluster deployed and available. The following Kubernetes distributions are currently supported:
- Google Kubernetes Engine (GKE).
- Client-side utilities installed at deployment host:
- Valid credentials for your Kubernetes cluster.
- The gws-microservices.tgz package downloaded from Genesys FTP to the deployment host.
- Images of GWS components uploaded into target Kubernetes registry.
Configuring GWS in Configuration Server
Use Genesys Administrator to configure Applications and Users for Genesys Web Services and Applications.
- Configure (or use existing) super administrator account. It will be used by GWS to connect and perform read and write operations.
- Create an application of type Genesys Generic Server. Suggested name is GWS.
- For this application, add connections to Config Server, TServer (SIPServer), StatServer. In the Advanced tab of Connection in Application parameters, add the following locations, e.g. locations=/USW2 - as configured in environment variable, GWS_REGION.
- Create an application of type, Genesys Generic Client. Suggested name is GWS_app.
- Add a connection to the Genesys Generic Server application created in Step 2.
Deployment Steps
- Validate your Kubernetes credentials:
- Follow the registration web-UI steps. and type gcloud container clusters list command to see all GKE clusters available to you, if any.
-
Unpack the gws-microservices.tgz file with the following command:
tar -zxf gws-microservices.tgz
Go to the kubernetes directory:
cd gws-microservices/kubernetes
Modify the <ToBeChanged: …> values defined in the conf/gke.env file with the actual values required by deployment.
Apply the modified configuration file to the current bash session:
source conf/gke.env
Deploy the monitoring stack using gws-monitoring-deploy.sh script. The script will deploy Prometheus and Grafana solutions at your Kubernetes cluster.
Deploy GWS infrastructure using gws-infra-deploy.sh script. The script will deploy GWS dependency servers - ElasticSearch, Redis, Consul, etc., at your Kubernetes cluster.
Deploy GWS microservices using gws-app-deploy.sh script.
Initialize GWS using gws-postinstall.sh script. The script uses GWS REST API to provision environment, contact center, and authentication client.
Upgrade Procedure
Download new version of gws-microservices.tgz package from Genesys FTP to the deployment host.
Unpack the gws-microservices.tgz file with the following command:
tar -zxf gws-microservices.tgz
Go to the kubernetes directory:
cd gws-microservices/kubernetes
Modify the <ToBeChanged: …> values defined in the conf/gke.env file with the actual values required by deployment. Refer to the file used in deployment.
Apply the modified configuration file to the current bash session:
source conf/gke.env
Upgrade GWS microservices using gws-app-deploy.sh script.