Deploy IWD

Learn how to deploy IWD.

Related documentation:

• How Intelligent Workload Distribution works
• Suite-level guide
• All services
• Intelligent Workload Distribution Release Notes

RSS:

• For private edition

Prepare your environment

Important

• Make sure to review Before you begin for the full list of prerequisites required to deploy IWD.
• The sample code snippets and install commands in this document use an example version of IWD. Ensure that you replace the example version with the version that is applicable for your deployment.

1. Create a new project using the following command:
   

   kubectl create namespace iwd

   For OpenShift:

   oc get clusterversion
   oc new-project iwd

2. Create a pull secret for accessing the JFrog registry. See Create the pull secret.
3. Download the IWD helm chart from the JFrog repository. See Download the Helm charts.
4. Create gauth Client.
   IWD requires clientId and clientSecret registered in Auth Service. These have to be provided during Helm Chart deployment. Create new client credentials if they are not already created . Refer to the GWS documentation for more information.

Deploy

Extract parameters from chart to see multiple (default) values used to fine tune the installation.

$ helm show values iwd-100.0.0741322.tgz > values.yaml

For information on parameters and values in the values.yaml file, see Override Helm chart values.

Sample override file:

replicaCount: 1
 
image:
  registry: pureengage-docker-staging.jfrog.io
  repository: nexus/iwd
  pullSecrets: []
 
gauth:
  auth:
    url: http://gauth-auth.gauth
    redirectUrl: https://gauth.${domain}
 
redis:
  nodes: redis://infra-redis-redis-cluster.infra.svc.cluster.local:6379
  useCluster: true
  enableTLS: false
  password: <test_password>
 
gws:
  url: http://gauth-auth.gauth
  clientId: <test_clientID>
  clientSecret: <test_clientSecret>
  apiKey: <test_apikey>
 
ingress:
  enabled: true
  hosts:
    - host: iwd.${domain}
      paths:
        - path: '/iwd/'
          port: 4024
  tls:
    - hosts:
        - iwd.${domain}
      secretName: letsencrypt
 
nexus:
  url: http://nexus.nexus
  apikey: <test_apikey>
 
elasticsearch:
  host: elastic-es-http.infra.svc.cluster.local
  port: 9200

Install IWD using the following command (replace <> with applicable values):

helm install iwd ./iwd-<version>.tgz -f override_values.yaml --namespace=iwd

Add route (for OpenShift deployment only):

oc create route edge --service=iwd --hostname=iwd.apps.<your_cluster> --port=api --path=/iwd

Validate the deployment

Watch the helm output at the end of installation. It provides the status and additional information about where to log in to the IWD UI.

See the following sample output:

Release "iwd" has been upgraded. Happy Helming!
NAME: iwd
LAST DEPLOYED: Tue Jul 13 10:18:07 2021
NAMESPACE: iwd
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Please be patient while iwd 100.0.0741322 is being deployed