Jump to: navigation, search
(Created page with "= Deploying with bash scripts = The following Kubernetes distributions are supported: * Openshift (Fully Supported) * GKE (Partially Supported) * AWS EKS (TBD) * Pure Kuberne...")
 
 
(13 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
The following Kubernetes distributions are supported:
 
The following Kubernetes distributions are supported:
−
* Openshift (Fully Supported)
+
* OpenShift (Fully Supported)
−
* GKE (Partially Supported)
+
* Google Kubernetes Engine (Partially Supported)
−
* AWS EKS (TBD)
 
−
* Pure Kubernetes (TBD)
 
  
 
== Requirements ==
 
== Requirements ==
−
* {{#Widget:ExtLink|link=https://kubernetes.io/docs/tasks/tools/install-kubectl/|displaytext=Kubectl}} and {{#Widget:ExtLink|link=https://docs.helm.sh/using_helm/#installing-helm|displaytext=Helm}} client utilities
+
# {{#Widget:ExtLink|link=https://kubernetes.io/docs/tasks/tools/install-kubectl/|displaytext=Kubectl}} and {{#Widget:ExtLink|link=https://docs.helm.sh/using_helm/#installing-helm|displaytext=Helm}} client utilities
−
** Tiller is not required.
+
#* Tiller is not required.
 +
## 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
 +
|displaytext=gcloud}}'' utility.
 +
# The scripts reside in the '''gws-microservices''' hg repository.  
  
 +
<div class="cloud-tabberlive-wrapper">
 +
<tabber>
 +
 +
OpenShift=
 +
<div class="cloud-wrapper">
 +
<h2>Deploying GWS with OpenShift Platform</h2>
 +
<div class="cloud-left">
 +
 +
* Copy your configuration to '''~/.kube/config'''.
 +
* Type  <tt>kubectl get nodes</tt> to list the nodes in your cluster.
 +
* 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.
 +
** 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'''.
 +
** Get the registry keys and add them to '''/etc/docker.d''' on all hosts.
 +
* Restart docker.
 +
</div>
 +
</div>
 +
 +
|-|
 +
Google Kubernetes Engine=
 +
<div class="cloud-wrapper">
 +
<h2>Deploying GWS with Google Kubernetes Engine</h2>
 +
<div class="cloud-left">
 +
* Follow the registration web-UI steps.
 +
* 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.
 +
* 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.
 +
**  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: <tt>TARBALL=/full/path/to/GWS/apps/tarball push-containers-to-gke.sh</tt>
 +
 +
</div>
 +
</div>
 +
 +
 +
</tabber>
 +
<div style="clear: both;"> </div>
 +
 +
{{NoteFormat|{{Editgrn_open}}XR: Is there a sequence to be followed? What needs to be deployed first?{{Editgrn_close}}|}}
 +
 +
=== Deploying GWS Infrastructure===
 +
{{Editgrn_open}}XR: Should we delete first before deploying?{{Editgrn_close}}
 +
<pre>
 +
./gws-infra-deploy.sh delete
 +
./gws-infra-deploy.sh
 +
</pre>
 +
 +
=== Deploying  GWS Application Stack===
 +
<pre>
 +
./gws-app-deploy.sh delete
 +
./gws-app-deploy.sh
 +
</pre>
 +
 +
=== Deploying  Prometheus and Grafana ===
 +
{{NoteFormat|These services are deployed cluster-wide and do not depend on GWS-applications' loads. }}
 +
<pre>
 +
$ ./monitoring-deploy.sh delete
 +
$ ./monitoring-deploy.sh
 +
</pre>
 +
 +
=== Pulling Current GWS Applications Container ===
 +
 +
<pre>
 +
$ STACK_DOCKER_IMAGE_PATH=gws-registry-usw1.genhtcc.com ./pull-containers.sh
 +
</pre>
  
 
[[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!