Changing Deployment Parameters in Qrvey
This document provides a general guide for modifying deployment parameters in Qrvey environments. It includes prerequisites for accessing your Kubernetes cluster on AWS and Azure, and uses the job downscaler as a practical example.
General Steps to Change Deployment Parameters
-
Connect kubectl to your Qrvey cluster
- For AWS, follow: https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html
- For Azure, follow: https://learn.microsoft.com/en-us/azure/aks/kubernetes-walkthrough
- Make sure your kubeconfig is set up and you can run
kubectl get nodes
to verify access.
Hint: If you prefer not to use the default editor (usually
vi
), you can set a friendlier editor like nano:export EDITOR=nano
This will make editing deployments easier.
-
Edit the Deployment
kubectl edit deploy <deployment-name> -n <namespace>
- Replace
<deployment-name>
with the name of your deployment (e.g.,job-downscaler
). - Replace
<namespace>
with your namespace (e.g.,qrveyapps
). - Do not use double quotes around arguments.
- Replace
-
Modify Parameters
- In the editor, locate the parameter you want to change (e.g.,
spec.replicas
for the number of pods). - Update the value, then save and exit.
- In the editor, locate the parameter you want to change (e.g.,
Example: Changing the Number of Pods for Job Downscaler
In Qrvey, data is loaded via a set of pods running in parallel, each responsible for inserting data into the Elasticsearch cluster. The number of replicas for the job downscaler determines how many of these pods run concurrently. You may need to adjust this number based on the size and capacity of your Elasticsearch cluster, as well as the volume of data being processed. Increasing the number of replicas can improve data loading throughput, but setting it too high for your cluster size may lead to resource contention or degraded performance. This setting allows you to configure the number of replicas for the job downscaler to best match your deployment needs.
To change the number of pods for the job downscaler:
kubectl edit deploy job-downscaler -n qrveyapps
- Find the
spec.replicas
field and set the desired number. - Save and exit the editor.
Troubleshooting
- If you encounter issues, verify your changes and consult the official Kubernetes documentation: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/