The extension detects and highlights references in manifests based on local manifests, resources in an existing cluster, and resources generated by Kustomize and Helm. The extension continuously validates references in manifests while the developer is typing, and it updates the highlighting in real-time.
The extension only focuses on references between resources and validating if they are correct or not. The extension does not validate if the manifests' syntax is correct or has all the required fields.
Currently, the extension supports scanning of Services
, Pods
, Deployments
, StatefulSet
, Jobs
, CronJobs
, Secrets
, and ConfigMaps
. More resources will be added at a later point.
All resources are namespace-sensitive. A resource will not be highlighted if the resource exists in another namespace.
The extension calls the Kubernetes API of the user's current context and collects the names of all the objects the user has access to.
The extension will collect the names of all the objects in the manifest files found in the open VSCode workspace.
The extension will run kustomize build
on all kustomization
-files in the open workspace and collect the names of all the objects found in the generated kustomize-output.
The extension will run helm template
on all helm charts in the open workspace and collect the names of all the objects found in the generated helm-output.
If a reference is not found, but a reference with a similar name exists, the extension will suggest using that instead.
Clicking any filename in one of the hovering boxes will send the user to that file/folder.
The extension will inform the user if the kustomize-file builds or not.
Note: If you have kustomize installed as a stand-alone binary in your PATH, the extension will use kustomize build
instead of kubectl kustomize
.
The extension will inform the user if the helm chart builds or not.
VS Code Command | Effect |
---|---|
Kubernetes Reference Highlighter: Toggle WorkSpace Scanning |
Toggles Workspace Scanning |
Kubernetes Reference Highlighter: Toggle Cluster Scanning |
Toggles Cluster Scanning |
Kubernetes Reference Highlighter: Toggle Kustomize Scanning |
Toggles Kustomize Scanning |
Kubernetes Reference Highlighter: Toggle Helm Scanning |
Toggles Helm Scanning |
Kubernetes Reference Highlighter: Toggle Reference Correction Hints |
Toggles Suggestions |
Kubernetes Reference Highlighter: Toggle Bi-directional Reference Highlighting |
Toggles Bi-directional Reference Highlighting (Disabling it may increase performance) |
Setting | Default | Effect |
---|---|---|
kubernetesReferenceHighlighter.enableWorkSpaceScanning |
true |
Toggles Workspace Scanning |
kubernetesReferenceHighlighter.enableKustomizeScanning |
true |
Toggles Kustomize Scanning |
kubernetesReferenceHighlighter.enableHelmScanning |
true |
Toggles Helm Scanning |
kubernetesReferenceHighlighter.enableClusterScanning |
true |
Toggles Cluster Scanning |
kubernetesReferenceHighlighter.enableCorrectionHints |
true |
Toggles Suggestions |
kubernetesReferenceHighlighter.enabledBiDirectionalReferences |
true |
Toggles Bi-directional Reference Highlighting (Disabling it may increase performance) |
Please open an issue on GitHub if you experience any issues or have ideas for features.