Weaveworks GitOps Extension (in the Visual Studio Code Marketplace) provides an intuitive way to manage, troubleshoot and operate your Kubernetes environment following the GitOps operating model, accelerating your development lifecycle and simplifying your continuous delivery pipelines. The extension is built on Flux (a CNCF open source project); to learn more about the GitOps toolkit, visit FluxCD.io
Your feedback is very important to us, please help us by submitting issues for bugs, enhancements and share with us how you are using the extension.
Weaveworks GitOps Extension integrates with Kubernetes Tools,
flux (FluxCD) for a consolidated and tightly integrated user experience.
This extension is under active development and is in a rolling beta release cycle with stable releases. Breaking changes remain a possibility.
In order to use the extension, you must satisfy a few requirements:
- Make sure you have the various tools listed under Dependencies installed in your system and available in your
- You must have at least one cluster configured in your
kubectl config. We rely on the Kubernetes extension to discover and connect to clusters. If you are having issues accessing or viewing your cluster, follow the documentation provided by the Kubernetes extension.
Once you have satisfied these requirements, you are ready to install the GitOps Extension!
You can find us in the Visual Studio Code Marketplace by searching "FluxCD" or "GitOps", and hopefully even "Flux".
The GitOps Extension depends on the Kubernetes Tools extension, which will be automatically installed on your system if you don't already have it.
You will need
flux CLI at the minimum to use this GitOps extension and its Kubernetes cluster management operations.
For users running clusters in Azure including AKS and Arc clusters, the
az command line tool is also required.
|The kubectl command line tool lets you control Kubernetes clusters.
|Flux is a set of continuous and progressive delivery solutions for Kubernetes.
||Install Flux CLI
|Git is a free and open source distributed version control system.
|Azure CLI. (only if using the extension to create or register Azure clusters)
|Docker is an open platform for developing, shipping, and running applications.
We recommend you install these CLI tools on your system PATH before using GitOps extension. If these tools aren't on your system
PATH, then some commands may not work. If the extension needs one of the core Kubernetes tools and they are missing, it will prompt you to install them.
Azure specific recommendations
- Make sure you have successfully authenticated on your
az CLI and have access to the correct subscription for your AKS or ARC cluster.
- The easiest way to get your AKS or ARC cluster visible by the GitOps and Kubernetes Extensions, is by using the
az CLI to merge the config for accessing your cluster onto the default
kubectl config. Use
get-credentials as shown in the official CLI documentation. In order to enable GitOps in a cluster you will likely need the
- Access to custom GitOps sidebar
- View GitOps Output panel with CLI command traces for diagnostics
- View configured Kubernetes Clusters from
- Enable/Disable GitOps Cluster operations support
- View GitOps Toolkit components, version info, and deployment status for the GitOps enabled clusters and Flux controllers
- View Git/Helm Repositories and Bucket Sources info for the selected cluster
- View Kustomizations and Helm Releases for the selected cluster
- View Flux controller logs in the webview editor
- Reconcile Sources and Workloads demand
- Pull Git Repository Source to user machine and open it in VSCode
- Create Git Repository from opened in vscode folder
- Create Kustomization from opened in vscode folder
- Preview short Kubernetes Object info in rich markdown table tooltips on hover for the loaded Clusters, Sources, and Workloads
- Load Kubernetes Object manifest
.yaml configs in vscode editor via Kubernetes Tools API and virtual Kubernetes file system provider
- Open GitOps Documentation links to Flux and Weave GitOps CLI top level topics in your default web browser
You can access GitOps tools check, CLI dependendency versions, Clusters, Sources and Workloads views Focus and Refresh commands by typing
View -> Command Palette... menu prompt:
GitOps Feature Contributions
GitOps extension contributes the following Commands, View Containers, Views, and Activation Events to VSCode IDE for working with GitOps Kubernetes clusters:
Data and telemetry
The GitOps Tools Extension for Visual Studio Code collects usage data and sends it to Weaveworks to help improve our products and services. Read our privacy statement to learn more. This extension respects the
In case you don't have access to the Marketplace or use VSCodium, or need to for some other reason:
- Download the latest
vsix artifact version from our Releases page.
- Install it on your local Visual Studio Code following these instructions.
VS Codium and Open-VSX Registry
If you use VSCodium, we have now added the GitOps Tools on Open-VSX 🎉. You can search and install from your VSCodium editor's extension registry.