Jump to: navigation, search
 
(8 intermediate revisions by the same user not shown)
Line 10: Line 10:
 
## For OpenShift deployments, install the ''{{#Widget:ExtLink|link=https://docs.helm.sh/using_helm/#installing-helm|displaytext=oc}}'' utility.
 
## For OpenShift deployments, install the ''{{#Widget:ExtLink|link=https://docs.helm.sh/using_helm/#installing-helm|displaytext=oc}}'' utility.
 
## For Google Kubernetes Engine deployments, install and configure the ''{{#Widget:ExtLink|link=https://cloud.google.com/sdk/docs/#linux
 
## For Google Kubernetes Engine deployments, install and configure the ''{{#Widget:ExtLink|link=https://cloud.google.com/sdk/docs/#linux
−
|displaytext=gloud}}'' utility/
+
|displaytext=gcloud}}'' utility.
 
# The scripts reside in the '''gws-microservices''' hg repository.  
 
# The scripts reside in the '''gws-microservices''' hg repository.  
  
Line 33: Line 33:
 
   
 
   
 
|-|
 
|-|
−
GKE=
+
Google Kubernetes Engine=
 
<div class="cloud-wrapper">
 
<div class="cloud-wrapper">
 
<h2>Deploying GWS with Google Kubernetes Engine</h2>
 
<h2>Deploying GWS with Google Kubernetes Engine</h2>
 
<div class="cloud-left">
 
<div class="cloud-left">
 
* Follow the registration web-UI steps.
 
* Follow the registration web-UI steps.
−
Type <tt>gcloud container clusters list</tt> to list existing clusters for running containers.
+
* Type <tt>gcloud container clusters list</tt> to list existing clusters for running containers.
 
* Type <tt>cd gws-microservices/production/premise/kubernetes</tt>  to go to the '''kubernetes''' directory.
 
* Type <tt>cd gws-microservices/production/premise/kubernetes</tt>  to go to the '''kubernetes''' directory.
 
* Create your own environment configuration file and put it to "env-examples" directory. Or use the ones available.
 
* Create your own environment configuration file and put it to "env-examples" directory. Or use the ones available.
 
* Type  <tt>. env-examples/<YOUR ENVIRONMENT SOURCE FILE></tt> to source the cluster environment variables.
 
* Type  <tt>. env-examples/<YOUR ENVIRONMENT SOURCE FILE></tt> to source the cluster environment variables.
−
*  Import GWS-applications docker images to your container registry or add the GWS registry keys to '''/etc/docker.d'''.
+
**  Import GWS-applications docker images to your container registry or add the GWS registry keys to '''/etc/docker.d'''.
−
** Get the GWS-microservices docker images tarball via any Genesys supply channel and import it to Google Container Registry:
+
* Get the GWS-microservices docker images tarball via any Genesys supply channel and import it to Google Container Registry: <tt>TARBALL=/full/path/to/GWS/apps/tarball push-containers-to-gke.sh</tt>
−
<tt>"TARBALL=/full/path/to/GWS/apps/tarball push-containers-to-gke.sh"</tt>
 
  
 
</div>
 
</div>
Line 53: Line 52:
 
<div style="clear: both;"> </div>
 
<div style="clear: both;"> </div>
  
 +
{{NoteFormat|{{Editgrn_open}}XR: Is there a sequence to be followed? What needs to be deployed first?{{Editgrn_close}}|}}
  
−
=== Working with Prometheus and Grafana ===
+
=== Deploying GWS Infrastructure===
−
{{NoteFormat|These services are deployed clusterwide and do not depend on GWS-applications' loads. }}
+
{{Editgrn_open}}XR: Should we delete first before deploying?{{Editgrn_close}}
 
<pre>
 
<pre>
−
$ ./monitoring-deploy.sh delete
+
./gws-infra-deploy.sh delete  
−
$ ./monitoring-deploy.sh
+
./gws-infra-deploy.sh
 
</pre>
 
</pre>
  
−
=== Working with GWS Infrastructure===
+
=== Deploying  GWS Application Stack===
 
<pre>
 
<pre>
−
$ ./gws-infra-deploy.sh delete
+
./gws-app-deploy.sh delete
−
$ ./gws-infra-deploy.sh
+
./gws-app-deploy.sh
 
</pre>
 
</pre>
  
−
=== Working with GWS Application Stack===
+
=== Deploying  Prometheus and Grafana ===
 +
{{NoteFormat|These services are deployed cluster-wide and do not depend on GWS-applications' loads. }}
 
<pre>
 
<pre>
−
$ ./gws-app-deploy.sh delete
+
$ ./monitoring-deploy.sh delete
−
$ ./gws-app-deploy.sh
+
$ ./monitoring-deploy.sh
 
</pre>
 
</pre>
  
Line 76: Line 77:
  
 
<pre>
 
<pre>
−
- $ STACK_DOCKER_IMAGE_PATH=gws-registry-usw1.genhtcc.com ./pull-containers.sh
+
$ STACK_DOCKER_IMAGE_PATH=gws-registry-usw1.genhtcc.com ./pull-containers.sh
−
</pre>
 
−
 
 
−
=== DNS Requirements ===
 
−
 
 
−
All of the services, either cluster-wide, infrastructure or GWS-applications ingresses require DNS names to be pre-populated to get access to and for host-based naming virtualization.
 
−
* [[Prerequisites#scrollNav-3-3|Openshift]]
 
−
* GKE
 
−
<pre>
 
−
    XX.XX.XX.XX  grafana.gke.local
 
−
    XX.XX.XX.XX  consul.gke.local
 
−
    XX.XX.XX.XX  active.gke.local
 
−
    XX.XX.XX.XX  test.gke.local
 
 
</pre>
 
</pre>
−
 
−
=== Persistent Storage Requirements===
 
−
* Openshift : the GlusterFS storage can be pre-populated manually.
 
−
* GKE : No specific configuration is required.
 
−
* No storage : Set the <tt>PERSISTENT_STORAGE</tt>=''false'' in the environment file.
 
−
 
  
 
[[Category:V:HTCC:9.0.0DRAFT]]
 
[[Category:V:HTCC:9.0.0DRAFT]]

Latest revision as of 08:21, November 21, 2018

Deploying with bash scripts

The following Kubernetes distributions are supported:

  • OpenShift (Fully Supported)
  • Google Kubernetes Engine (Partially Supported)

Requirements

  1. Kubectl and Helm client utilities
    • Tiller is not required.
    1. For OpenShift deployments, install the oc utility.
    2. For Google Kubernetes Engine deployments, install and configure the gcloud utility.
  2. The scripts reside in the gws-microservices hg repository.

Deploying GWS with OpenShift Platform

  • Copy your configuration to ~/.kube/config.
  • Type kubectl get nodes to list the nodes in your cluster.
  • Type cd gws-microservices/production/premise/kubernetes to go to the kubernetes directory.
  • Create your own environment configuration file and put it to env-examples directory. Or use the ones available.
    • Type . env-examples/<YOUR ENVIRONMENT SOURCE FILE> to source the cluster environment variables.
  • Import GWS-applications docker images to your container registry or add the GWS registry keys to /etc/docker.d.
    • Get the registry keys and add them to /etc/docker.d on all hosts.
  • Restart docker.

Deploying GWS with Google Kubernetes Engine

  • Follow the registration web-UI steps.
  • Type gcloud container clusters list to list existing clusters for running containers.
  • Type cd gws-microservices/production/premise/kubernetes to go to the kubernetes directory.
  • Create your own environment configuration file and put it to "env-examples" directory. Or use the ones available.
  • Type . env-examples/<YOUR ENVIRONMENT SOURCE FILE> to source the cluster environment variables.
    • Import GWS-applications docker images to your container registry or add the GWS registry keys to /etc/docker.d.
  • Get the GWS-microservices docker images tarball via any Genesys supply channel and import it to Google Container Registry: TARBALL=/full/path/to/GWS/apps/tarball push-containers-to-gke.sh


Important
XR: Is there a sequence to be followed? What needs to be deployed first?

Deploying GWS Infrastructure

XR: Should we delete first before deploying? 

./gws-infra-deploy.sh delete 
./gws-infra-deploy.sh

Deploying GWS Application Stack

./gws-app-deploy.sh delete
./gws-app-deploy.sh

Deploying Prometheus and Grafana

Important
These services are deployed cluster-wide and do not depend on GWS-applications' loads. 
$ ./monitoring-deploy.sh delete
$ ./monitoring-deploy.sh

Pulling Current GWS Applications Container

$ STACK_DOCKER_IMAGE_PATH=gws-registry-usw1.genhtcc.com ./pull-containers.sh
This page was last edited on November 21, 2018, at 08:21.
Comments or questions about this documentation? Contact us for support!