Jump to: navigation, search
(→‎DNS Requirements)
 
(11 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 OpenShift deployments, install the ''{{#Widget:ExtLink|link=https://docs.helm.sh/using_helm/#installing-helm|displaytext=oc}}'' utility.
−
## For GKE 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.  
−
#  Get your credentials and try using the utilities you've installed. We assume that your credentials are valid and they work without any errors.
 
−
## For non-GKE platforms: copy your configuration to ~/.kube/config and try "kubectl get nodes" and see the cluster nodes list.
 
−
## For GKE: follow the registration web-UI steps and try "gcloud container clusters list" and see all GKE clusters you have if any.
 
−
# $ cd gws-microservices/infrastructure/kubernetes/gws-deployment # The "helm" directory actually contains all helm-charts we are using.
 
−
#$ ls ../gws-settings # This will show you the environment files needed to source to operate a particular cluster with a particular environment.
 
−
# $ . ../gws-settings/<YOUR ENVIRONMENT SOURCE FILE> # After you source the cluster/env variables, you'll see all available commands. To create your own environment file you can use the others as templates.
 
−
#  Import GWS-applications docker images to your container registry or add the GWS registries' keys to /etc/docker.d
 
−
## Internal Kubernetes clusters, deployed on Genesys premise: Get the registries' keys and add them to /etc/docker.d on all hosts, then restart docker.
 
−
## GKE. Get the GWS-microservices docker images tarball via any Genesys supply channel and import it to Google Container Registry as follows: "TARBALL=/full/path/to/GWS/apps/tarball push-containers-to-gke.sh"
 
  
−
=== Working with Prometheus and Grafana ===
+
<div class="cloud-tabberlive-wrapper">
−
{{NoteFormat|These services are deployed clusterwide and do not depend on GWS-applications' loads. }}
+
<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>
 
<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 46: 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>
 
</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.
 
−
* 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>
 
−
 
−
=== 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!