PEC-Email/Current/EmailPEGuide/Deploy

Learn how to deploy Email.

Related documentation:

• How Email works
• Suite-level guide
• All services
• Email Release Notes

RSS:

• For private edition

Kubernetes

Prepare

1. Create a new project using the following command:

   kubectl create namespace iwdem

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. Email requires the Digital Channels API key. The key must be provisioned and shared via Digital Channels.

Deploy

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

   $ helm show values iwdem-<version>.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-email
     pullSecrets:
       - name: pullsecret
    
   gauth:
     auth:
       url: http://gauth-auth.${GAUTH_NAMESPACE}:80
    
   redis:
     nodes: redis://${REDIS_ADDR}:${REDIS_PORT}
     useCluster: true
     enableTLS: false
     #password: xxx #in secrets
    
   nexus:
     url: http://nexus.${NEXUS_NAMESPACE}
     #apikey: xxx #in secrets
    
   monitoring:
     # Deploy PodMonitor
     enabled: true
     # Create PrometheusRule k8s object with alarm definitions
     alarms: true
     # Create ConfigMap with Grafana Dashboards
     dashboards: true
     # URL to Runbook
     # runbookUrl:

2. Install Email using the following command (replace <> with applicable values):

   helm install iwdem ./iwdem-<version>.tgz -f override_values.yaml \
       --set redis.password=<password to redis> \
       --set nexus.apikey=<Nexus API key> \
       --namespace=iwdem

OpenShift

Prepare

1. Create a new project using the following command:

   oc get clusterversion
   oc new-project iwdem

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. Email requires the Digital Channels API key. The key must be provisioned and shared via Digital Channels.

Deploy

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

   $ helm show values iwdem-<version>.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-email
     pullSecrets:
       - name: pullsecret
    
   gauth:
     auth:
       url: http://gauth-auth.${GAUTH_NAMESPACE}:80
    
   redis:
     nodes: redis://${REDIS_ADDR}:${REDIS_PORT}
     useCluster: true
     enableTLS: false
     #password: xxx #in secrets
    
   nexus:
     url: http://nexus.${NEXUS_NAMESPACE}
     #apikey: xxx #in secrets
    
   monitoring:
     # Deploy PodMonitor
     enabled: true
     # Create PrometheusRule k8s object with alarm definitions
     alarms: true
     # Create ConfigMap with Grafana Dashboards
     dashboards: true
     # URL to Runbook
     # runbookUrl:

2. Install Email using the following command (replace <> with applicable values):

   helm install iwdem ./iwdem-<version>.tgz -f override_values.yaml \
       --set redis.password=<password to redis> \
       --set nexus.apikey=<Nexus API key> \
       --namespace=iwdem

Google Kubernetes Engine (GKE)

Prepare

1. Log in to the GKE cluster.

   gcloud container clusters get-credentials <cluster-name>

2. Create a new project:
   1. Create a create-iwdem-namespace.json :

      {
        "apiVersion": "v1",
        "kind": "Namespace",
        "metadata": {
          "name": "iwdem",
          "labels": {
            "name": "iwdem"
          }
        }
      }

   2. Create a namespace using the above JSON:

      kubectl apply -f create-iwdem-namespace.json

   3. Confirm the namespace creation:

      kubectl describe namespace iwdem

3. Create a pull secret for accessing the JFrog registry.

   kubectl create secret docker-registry jfrog-stage-credentials \
   --docker-server=pureengage-docker-staging.jfrog.io \
   --docker-username=<camelot-username> \
   --docker-password=<API key from jfrog> \
   --docker-email=<emailid>

4. Download the IWD helm chart from the JFrog repository. See Download the Helm charts.
5. Email requires the Digital Channels API key. The key must be provisioned and shared via Digital Channels.

Deploy

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

   $ helm show values iwdem-<version>.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-email
     pullSecrets:
       - name: pullsecret
    
   gauth:
     auth:
       url: http://gauth-auth.${GAUTH_NAMESPACE}:80
    
   redis:
     nodes: redis://${REDIS_ADDR}:${REDIS_PORT}
     useCluster: true
     enableTLS: false
     #password: xxx #in secrets
    
   nexus:
     url: http://nexus.${NEXUS_NAMESPACE}
     #apikey: xxx #in secrets
    
   monitoring:
     # Deploy PodMonitor
     enabled: true
     # Create PrometheusRule k8s object with alarm definitions
     alarms: true
     # Create ConfigMap with Grafana Dashboards
     dashboards: true
     # URL to Runbook
     # runbookUrl:

2. Install Email using the following command (replace <> with applicable values):

   helm install iwdem ./iwdem-<version>.tgz -f override_values.yaml \
       --set redis.password=<password to redis> \
       --set nexus.apikey=<Nexus API key> \
       --namespace=iwdem

Validate the deployment

Watch the helm output at the end of installation. Pods must be in a Running state and they must pass all READY checks.

See the following sample output:

Release "iwdem" has been upgraded. Happy Helming!
NAME: iwdem
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