Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

The official Kubernetes extension for Visual Studio Code lets you work with configured clusters from the editor: browse resources, inspect logs and events, manage Kubernetes manifests, work with Helm charts, and run or debug applications. You need kubectl at minimum; building images, Helm workflows, and Azure or Minikube setup call for additional tools.

What Kubernetes Tools for VS Code does

The extension is intended for developers building applications for Kubernetes and DevOps staff troubleshooting them. Its workflows connect VS Code to a configured Kubernetes cluster rather than replacing the cluster or its command-line tools. The extension listing describes support across environments such as Azure, Minikube, AWS, and GCP; that is a stated compatibility scope, not a guarantee that every authentication method or cluster feature works identically.

Install the official Kubernetes extension from the Visual Studio Marketplace. Its main capabilities include:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Cluster exploration: Browse workloads, services, pods, and nodes. Inspect resource status, descriptions, events, and logs; open a shell or run a command in a pod; and forward ports.
  • Manifest workflows: Get resource explanations and create, apply, expose, or diff Kubernetes resources from manifest files.
  • Helm workflows: Edit and validate charts, render templates, manage dependencies, package or fetch charts, and install them.
  • Application workflows: Run or debug applications in Kubernetes, subject to the image-repository setup those commands require.

What you need before using it

kubectl is the minimum named dependency. The extension recommends that required binaries be available on your PATH, though it also provides settings for custom binary paths and an option to install dependencies such as kubectl and Helm.

Workflow Additional requirement
Connect to and manage Kubernetes resources kubectl
Build an application image with the extension Docker or Buildah
Use Helm features Helm
Create or register Azure clusters Azure CLI
Use the Minikube option Minikube
Use working-copy synchronization Git

These dependencies are conditional: for example, Helm is not required just to browse cluster resources. Check the extension listing for current setup instructions and requirements.

Connect VS Code to a cluster

By default, the extension uses the active kubeconfig: the configuration identified by KUBECONFIG, or the default kubeconfig when that variable is not set. You can provide a kubeconfig path or keep multiple known kubeconfigs and switch between them. The extension also exposes context and namespace controls, so check the selected context and namespace before applying changes or inspecting resources.

  1. Install the Kubernetes extension from the Visual Studio Marketplace.
  2. Install and configure kubectl and confirm that its kubeconfig can access the intended cluster.
  3. If you use a non-default configuration, set the extension’s kubeconfig path or add the configuration to its known kubeconfigs, then select the intended context and namespace.
  4. Open the cluster explorer and inspect the resources available in the selected context.

Authentication depends on your kubeconfig and cluster environment. Marketplace support for a cloud or local environment should not be taken to mean that all authentication configurations are interchangeable.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use cluster and manifest workflows

For troubleshooting, use the explorer to locate a workload or pod, then inspect its status, events, description, and logs. The extension also provides ways to open a shell or execute a command in a pod and to forward a port for local access.

For manifest work, the extension can explain resource types and provides create, apply, expose, and diff commands. A diff is useful for reviewing the proposed resource changes before applying them. Confirm the selected context and namespace before running commands that change cluster state.

Use Helm in VS Code

Helm support includes syntax highlighting and completion for chart templates, chart scaffolding, linting, template rendering or preview, dependency operations, packaging, fetching, and installation. Install Helm and configure its binary path if it is not available on PATH.

A specific preview limitation matters for nested charts: deeply nested Helm chart previews use values from the top-level, or umbrella, chart. For Helm: Template, you can select a chart. If you previously used the separate vscode-helm Marketplace extension, its listing directs users to the official Kubernetes Tools extension, which it describes as including its features plus more and being kept up to date.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run or debug an application

The extension documents Kubernetes: Run and Kubernetes: Debug workflows. Configure an image user or repository first: these commands need to push the application image so the cluster can run it. Debug launch can create a deployment and associated pod. The extension listing documents launch and attach debugging for Go, Node.js, Java, Python, and .NET applications.

An auto-cleanup setting controls cleanup after a debug session fails or is terminated. Review that setting and the selected cluster before starting a session, particularly if you do not want the extension to remove resources created for debugging.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Resolve common setup problems

VS Code cannot find kubectl or Helm

Check that the executable is on PATH or set the corresponding custom binary-path option in the extension settings. If prompted, use the extension’s dependency-install option for kubectl or Helm.

Commands target the wrong cluster or namespace

Review the active kubeconfig, context, and namespace in the extension before querying or changing resources. If you maintain multiple kubeconfigs, confirm that the intended configuration is selected.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linux Snap installations encounter permission errors

The extension listing warns that installing VS Code or kubectl through Snap on Linux can cause permission errors and documents an extension-setting workaround. Consult the listing’s known-issues guidance for the current setting and steps rather than assuming the problem is a cluster failure.

Telemetry disclosed by the extension

The extension’s Marketplace documentation says it collects which commands are executed and whether they target Azure, Minikube, or another cluster type. For create-cluster and add-existing-cluster commands, it says it collects the selected cluster type and whether the operation succeeded. The same documentation says image names and paths are not collected, and that collection respects VS Code’s telemetry.telemetryLevel setting. This describes the Kubernetes extension’s stated collection; it is not a general statement about all VS Code or Kubernetes telemetry.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.