Skip to main content
Version: 0.4.0


How to: Upgrade to Weave Gitops Enterprise#

Upgrading requires we:

  1. Already have Weave GitOps installed on the cluster
  2. Install Profiles onto the cluster
  3. Apply the entitlements secret
  4. Upgrade
  5. Configure
  6. Check that Weave Gitops Enterprise has been installed

2. Install profiles#

This step will be removed

This step will be removed when Profiles are included in Weave Gitops

Download the latest pctl release and install the Profile custom resources:

pctl install --flux-namespace wego-system

3. Apply the entitlements secret#

Contact for a valid entitlements secret. Then apply it to the cluster:

kubectl apply -f entitlements.yaml

4. Upgrade#

Run the upgrade command from a local copy of git repo that is sync'd to the cluster:

cd my-cluster-repogitops upgrade

A Pull Request will be created against your cluster repository. Review and merge this pull request to upgrade to Weave Gitops Enterprise.

5. Configure Weave Gitops Enterprise#

Weave Gitops Enterprise has a number of configration options but two importants aspect to configure are:

5.1. Ingress#

An Ingress address is necessary in order to establish connectivity between agents and your WGE instance. The way to determine this depends on your cluster type and provisioning method.

Update the agentTemplate.natsURL value in the Weave Gitops Enterprise ConfigMap in your config repo.

5.2. Git repository configuration#

WGE will make pull requests against your git config repo when creating new CAPI clusters etc. The GIT_PROVIDER_TOKEN in the git-provider-credentials secret specified above will be used to authenticate.

Update the capi.config.repositoryURL with the correct url to your git config repository in the Weave Gitops Enterprise ConfigMap in git config repository itself.

Restart capi-service

After configuring values in the ConfigMap you may have to delete the cluster-service pod for the changes to take effect.

6. Checking that WGE is installed#

You should now be able to load the WGE UI by running the following command:

$ kubectl port-forward --namespace wego-system deployments.apps/mccp-nginx-ingress-controller 8000:80

The WGE UI should now be accessible at http://localhost:8000.