Required tools for CluedIn upgrade
On this page
- Kubernetes
- Azure Kubernetes Service
- Kubeconfig file
- kubectl
- Helm
- Visual Studio Code
- Lens or Freelens
Before starting CluedIn upgrade, make sure you have the necessary tools installed and ready:
- Kubernetes
- Azure Kubernetes Service (AKS)
- kubectl
- Helm
- (Optional) Visual Studio Code
- (Optional) Lens or Freelens
In addition to the above, you also need a valid kubeconfig file.
Kubernetes
Kubernetes is an open-source container orchestration platform. It automates the deployment, scaling, and management of containerized applications.
Download link: Official website.
Azure Kubernetes Service
Azure Kubernetes Service (AKS) is a managed Kubernetes service provided by Microsoft Azure. It simplifies running Kubernetes by handling cluster management tasks such as upgrades, scaling, and security.
Link to get AKS: Official website.
Kubeconfig file
The kubeconfig file is a configuration file used by kubectl and other Kubernetes tools to connect to a cluster. It contains the information required for authentication and cluster access, including:
-
Cluster details – The API server address and certificate data.
-
User credentials – Authentication tokens, certificates, or keys.
-
Contexts – Mappings that define which cluster, user, and namespace to use by default.
The kubeconfig is a plain-text YAML file that stores access details (credentials and cluster information):
-
The file does not require a file extension.
-
By default, the file is stored in the user’s home directory under the hidden .kube folder:
~/.kube/config
To get the kubeconfig file
-
Contact your Azure administrator and ask them to provide the kubeconfig file to you.
Your administrator can find the kubeconfig file in Azure Portal.
-
Store the file in a secure location.
Treat this file as sensitive information – it contains access credentials and cluster details.
Do not commit the file to a source control tool.
kubectl
kubectl is command-line tool for interacting with Kubernetes clusters. It lets you deploy applications, inspect and manage cluster resources, and view logs.
When it comes to CluedIn, kubectl lets you communicate directly with the Kubernetes API server defined in your kubeconfig file. This means that you can:
-
Inspect cluster resources (pods, services, deployments, and nodes).
-
Apply configuration files (
kubectl apply -f deployment.yaml
). -
Scale applications up or down.
-
Restart, delete, or debug the workloads.
Without kubectl, there is no simple way to manage or query what’s running inside your AKS cluster.
Required version: 1.30 or higher.
Installation instructions: See Kubernetes documentation.
Helm
Helm is a package manager for Kubernetes. It simplifies the deployment, upgrade, and management of applications by using reusable, versioned packages called charts.
When it comes to CluedIn, we use Helm for upgrades because it makes updating applications simple, consistent, and reversible. With a single command, you can apply changes while keeping version history for easy rollbacks.
Required version: 3.x.x.
Installation instructions: See Helm documentation.
Visual Studio Code
Visual Studio Code is lightweight, cross-platform code editor. The editor is useful for editing YAML files and reviewing configuration files during the upgrade.
This tool is optional to use.
Download link: Official website.
Lens or Freelens
Lens and Freelens are powerful, free tools designed to monitor and manage Kubernetes clusters. They provide a user-friendly graphical interface that simplifies multiple everyday Kubernetes tasks. By reducing the need to recall and execute long or complex command-line instructions, these tools improve productivity and save valuable time.
Reasons to use Lens:
-
Ease of use – It offers an intuitive dashboard to view and manage cluster resources.
-
Productivity boost – It eliminates the need to memorize kubectl commands for common tasks.
-
Built-in logs – The Freelens version includes built-in log viewing, which makes it especially useful for troubleshooting.
We recommend using Freelens, as it includes built-in log access and offers a more complete out-of-the-box experience. For teams that work regularly with Kubernetes, Lens can quickly become an indispensable daily tool for monitoring and troubleshooting clusters.
Once you connect Lens (or Freelens) your CluedIn cluster, it allows you to:
-
View and manage pods, services, deployments, and namespaces.
-
Monitor CPU, memory, and other resource usage.
-
Access and search through logs directly from the UI.
-
Inspect and edit Kubernetes objects without leaving the dashboard.
Lens and Freelens are optional to use.
Download links: