Kubernetes

• Upgrading to 1.15.0
  • Step 1. Obtain SENTIENT ANALYTICS Kubernetes scripts
  • Step 2. Connect to your Kubernetes cluster
  • Step 3. Reduce pods count
  • Step 4. Create flag-file
  • Step 5. Change image version
  • Step 6. Apply the deployment file
  • Step 7. Check the logs
  • Step 8. Increase pods count
  • Step 9. Check synchronization status in SENTIENT

Upgrading to 1.15.0

These steps are applicable for 1.14.0 SENTIENT ANALYTICS version.

Step 1. Obtain SENTIENT ANALYTICS Kubernetes scripts

Use the Kubernetes configuration files used for installation. If you did not save the files you need to download them again by the next link and fill in by necessary data as in the installation guide:

1
git clone https://github.com/sentient/sentient-analytics-k8s.git --depth 1

Step 2. Connect to your Kubernetes cluster

You need to connect to the dedicated kube-config configuration Use the next commands:

1
2
kubectl config get-contexts
kubectl config use-context <your config name>

Step 3. Reduce pods count

The deployment must have only one pod for the next steps of a successful upgrade. Use this command to set the pod count:

1
kubectl scale deployment sentient-analytics-app-deployment --replicas=1

Step 4. Create flag-file

Create a file “.upgradeversion” inside the directory by calling the command that must be executed by SENTIENT ANALYTICS pod. Run the command (replace 1.14.0 with SENTIENT ANALYTICS version from which you are updating):

1
kubectl exec <POD_NAME> -- sh -c "echo '1.14.0' > /data/.upgradeversion"

You can get the pod name by the command:

1
kubectl get pods -l app=sentient-analytics-app-pod-label

Step 5. Change image version

Open the sentient-analytics-app-deployment.yml file with the command

1
nano sentient-analytics-app-deployment.yml

and change the image version:

Step 6. Apply the deployment file

Use the command to apply the new configuration of the deployment and wait until the pods are ready:

1
kubectl apply -f sentient-analytics-app-deployment.yml

Step 7. Check the logs

Now check the logs and be sure that the instance is started successfully and the upgrade was performed. The logs can be opened by the command:

1
kubectl logs -f <sentient-analytics-pod-name>

There should be the following lines:

1
2
3
4
5
Upgrading SENTIENT ANALYTICS from version … 
…
Current version is …, upgrade is not needed
…
Started SENTIENT ANALYTICSApplication in …

Step 8. Increase pods count

Now you can return your preferred pod count to the deployment. Use this command to set the pod count:

1
kubectl scale deployment sentient-analytics-app-deployment --replicas=<pod-count>

Step 9. Check synchronization status in SENTIENT

After upgrade, it’s necessary to check sync status for SENTIENT ANALYTICS with SENTIENT. You can find out how to do it here.