Upgrade Third-Party Dependencies

This page outlines the process for upgrading third-party dependencies for Terraform-based infrastructure deployments.

Third-party dependencies refer to the software that is installed by the Terraform scripts to support the deployment of kdb Insights Enterprise.

When to upgrade

Each release of kdb Insights Enterprise includes a Third-party Dependencies section in the release notes. This section lists the specific versions of the third-party infrastructure components that have been tested and verified for compatibility with that specific kdb Insights Enterprise release and provides links to download the required files.

To ensure continued stability, compatibility, and support, it is recommended that you update these dependencies in conjunction with the corresponding upgrade of kdb Insights Enterprise.

Upgrade the cert-manager

1. Using the download links in the kdb Insights Enterprise release notes, get the latest version of the cert-manager helm chart for the specific release of kdb Insights Enterprise.

2. Switch to your local kxi-terraform directory.

3. Open the Terraform variables.tf file for your cloud provider, for example, AWS (Amazon Web Services), ACS (Azure Cloud Services), or GCP (Google Cloud Platform), and update the cert-manager helm chart version variable to the new version.

   AWS

   ACS

   GCP

   console

   Copy

   vi terraform/k8s_config_aws/variables.tf
   variable "cert_manager_helm_version" {
   ....
   default = "1.16.3"
   }                                

   console

   Copy

   vi terraform/k8s_config_azure/variables.tf
   variable "cert_manager_helm_version" {
   ....
   default = "1.16.3"
   }

   console

   Copy

   vi terraform/k8s_config_gcp/variables.tf
   variable "cert_manager_helm_version" {
   ....
   default = "1.19.1"
   }

4. Run the manage-cluster.sh script.

   Linux

   Windows

   console

   Copy

   ./scripts/manage-cluster.sh

   console

   Copy

   .\scripts\manage-cluster.bat

5. Run the terraform init command.

   Linux

   Windows

   console

   Copy

   ./scripts/terraform.sh init config

   console

   Copy

   .\scripts\terraform.bat init config

6. Run the terraform plan command.

   Linux

   Windows

   console

   Copy

   ./scripts/terraform.sh plan config

   console

   Copy

   .\scripts\terraform.bat plan config

7. Run the terraform apply command.

   Linux

   Windows

   console

   Copy

   ./scripts/terraform.sh apply config

   console

   Copy

   .\scripts\terraform.bat apply config

8. Verify the cert-manager helm chart version.

   console

   Copy

   helm ls -n cert-manager

Upgrade the ingress-nginx

1. Using the download links in the kdb Insights Enterprise release notes, get the latest version of the ngress-nginx helm chart for the specific release of kdb Insights Enterprise

2. Switch to your local kxi-terraform directory.

3. Open the Terraform variables.tf file for your cloud provider (for example, AWS, ACS, or GCP), and update the cert-manager helm chart version variable to the new version.

   AWS

   ACS

   GCP

   console

   Copy

   vi terraform/k8s_config_aws/variables.tf
   variable "ingress_nginx_helm_version" {
   ....
   default = "4.11.5"
   }                                    

   console

   Copy

   vi terraform/k8s_config_azure/variables.tf
   variable "ingress_nginx_helm_version" {
   ....
   default = "4.11.5"
   }

   console

   Copy

   vi terraform/k8s_config_gcp/variables.tf
   variable "ingress_nginx_helm_version" {
   ....
   default = "4.11.5"
   }

4. Run the manage-cluster.sh script.

   Linux

   Windows

   console

   Copy

   ./scripts/manage-cluster.sh

   console

   Copy

   .\scripts\manage-cluster.bat

5. Run the terraform init command.

   Linux

   Windows

   console

   Copy

   ./scripts/terraform.sh init config

   console

   Copy

   .\scripts\terraform.bat init config

6. Run the terraform plan command.

   Linux

   Windows

   console

   Copy

   ./scripts/terraform.sh plan config

   console

   Copy

   .\scripts\terraform.bat plan config

7. Run the terraform apply command.

   Linux

   Windows

   console

   Copy

   ./scripts/terraform.sh apply config

   console

   Copy

   .\scripts\terraform.bat apply config

8. Verify the ingress-nginx helm chart version.

   console

   Copy

   helm ls -n ingress-nginx