• For AWS

• For Azure

• For GCP

From Kyvos 2025.3 onwards, support for the latest Kubernetes version on AWS (EKS), Azure (AKS), and GCP (GKE) for cluster upgrades has been added.

• EKS and GKE: Kubernetes version 1.32 is supported.

• AKS: Kubernetes version 1.31 is supported.

To upgrade EKS, refer to AWS Documentation.

To upgrade AKS, refer to Azure Documentation.

To upgrade GKE, refer to GCP Documentation.

Post upgrade steps to configure Kubernetes on AWS

1. Upgrade the cluster with the release version you want to upgrade to.

2. Update the IAM Stack automated_deployment_iam_role.json and select yes to give EKS-related permissions to the IAM role.

3. Create an EKS cluster using CreateEks.json.

4. Run the following commands one by one on every Kyvos node to install kubectl

   1. curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

   2. unzip awscliv2.zip

   3. sudo ./aws/install --bin-dir /usr/local/bin/ --install-dir /usr/local/aws-cli --update o curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl

   4. chmod +x ./kubectl

   5. sudo chown kyvos:kyvos kubectl

   6. sudo mv kubectl /bin/

   7. sudo mkdir -p /home/kyvos/.kube

   8. sudo chown -R kyvos:kyvos /home/kyvos/.kube

5. Run the commands below from sudo user on Kyvos Manager node to install eksctl.

   1. curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$ (uname -s)_amd64.tar.gz" | tar xz -C /tmp

   2. sudo cp /tmp/eksctl /bin/

6. Once the EKS cluster is created, go to the created node then go to Security.

7. Click the eks-cluster-sg-kyvosEks-{STACK-NAME}-random number as Security group.

8. Add inbound rule to the above security group with TCP 6903 and source group will be the Security Group attached to the BI server.

9. Add inbound rule to the Web server security group with TCP 2181 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

10. Add inbound rule to the BI Server security group with TCP 2181 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

11. Add inbound rule to the BI Server security group with TCP 45460 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

12. Add inbound rule to the BI Server security group with TCP 6803 and source group will be the Security Group which was mentioned above (eks-cluster-sg-kyvosEks-{STACK-NAME}-random number).

13. Open the deployment bucket permission section and add the ARN of OIDC and Node group role in the array.

14. Once the above changes are done, navigate to compute cluster page on Kyvos Manager and click on Native. Choose Containerized Kubernetes.

15. Provide the name of the Kubernetes Cluster, then Node Pool name and then the K8S auth role name. The name of the role can be found in the resource section of the EKS creation stack.

16. Copy the value of the EKSOidcRole key and that is the K8S auth role name.

17. Validate the information and click Save.

Post upgrade steps to configure Kubernetes on Azure

1. Create an AKS cluster via script. To create the AKS cluster, refer to Azure documentation.

2. Upload the CreateAks.json script (available in Azure Installation files folder) and complete the parameters given in the script.

3. Once the AKS cluster is created, configure it through Kyvos Manager on the Computer cluster page.

Post upgrade steps to configure Kubernetes on GCP

To configure Kubernetes on GCP, perform the following steps.

1. Execute the following commands using the gcloud CLI to link the Kubernetes Service account to the IAM Service account.

   • gcloud iam service-accounts add-iam-policy-binding IAM_SA_NAME@IAM_SA_PROJECT_ID.iam.gserviceaccount.com --role roles/iam.workloadIdentityUser --member "serviceAccount:PROJECT_ID.svc.id.goog[kyvos-compute/kyvos-sa]"

     NOTE: Namespace can be custom.

     In the above-mentioned commands, replace the following:

     • IAM_SA_NAME: a name for your new IAM service account.

     • IAM_SA_PROJECT_ID: the project ID for your IAM service account.

     • PROJECT_ID: your Google Cloud project ID.

2. Additionally, if using a shared Virtual Network, below roles and permissions are required on by Default service account of Kubernetes (service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com) on project of Shared Virtual Network

   • Compute Network User

   • kubernetes_role (create a custom role)

     • compute.firewalls.create

     • compute.firewalls.delete

     • compute.firewalls.get

     • compute.firewalls.list

     • compute.firewalls.update

     • compute.networks.updatePolicy

     • compute.subnetworks.get

     • container.hostServiceAgent.use

3. · Add the following roles to the existing IAM Kyvos service account:

   • roles/iam.serviceAccountTokenCreator (Service Account Token Creator)

   • roles/container.developer (Kubernetes Engine Developer)

   • roles/container.clusterAdmin (Kubernetes Engine Cluster Admin)

4. Add the below permissions to existing service account:

   • compute.instanceGroupManagers.update

   • compute.instanceGroupManagers.get

5. SSH on All Instances one by one and run the below commands-

   • sudo apt-get update

   • sudo apt-get install apt-transport-https ca-certificates gnupg curl -y

   • curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   • sudo apt-get update && sudo apt-get install google-cloud-cli -y

   • sudo apt-get install google-cloud-cli-gke-gcloud-auth-plugin

   • sudo apt-get install kubectl

6. To install the Google Cloud CLI on all Kyvos nodes, refer to Google documentation.

7. Create Kubernetes cluster using Deployment scripts.

8. Open Kyvos Manager, go to Compute cluster page, Click the Kyvos Native tab.

9. Fill in the required inputs. Value provided to Worker Nodes Maximum Count should be same as you configured in templates. Click Save.

10. On Kyvos Manager > navigate to the Kyvos Properties page, ensure that the value of the KYVOS_PROCESS_COMPUTE_SUBTYPE property is Kubernetes compute.