Upgrading Edge Delta

Upgrading the Edge Delta Fleet.

  2 minute read  

The Edge Delta Fleet is abstracted from its Pipeline configuration. A unique Pipeline ID is used by each Fleet to communicate with the Edge Delta web app to populate your dashboard and retrieve its configuration. The Pipeline ID is passed in during installation.

This means you can upgrade a Fleet without changing its Pipeline configuration. To upgrade, you pass the same Pipeline ID in while installing a more recent version.

To see installation instructions for a Fleet you want to upgrade:

To view the deployment commands for an existing v3 pipeline configuration:

  1. Click Pipelines and select the Fleet.
  2. Click Add Agents.
  3. Select the deployment type.

To view the deployment commands for an existing v2 pipeline configuration:

  1. Click Pipelines and select Legacy Fleets.
  2. Click the kebab (⋮) icon in the Actions column for the agent and select Add Agents.
  3. Select the deployment method.

This example uses helm to upgrade. Replace the version v0.0.00 with the one you want to upgrade to, and replace the secretApiKey.value with the key associated with the Fleet’s configuration.

helm upgrade edgedelta edgedelta/edgedelta -i --version v0.0.00 --set secretApiKey.value=123456789 -n edgedelta --create-namespace

Fleet and Configuration Versions

Starting at version 0.1.71, Edge Delta Fleets use a Pipeline YAML file that has a config v3 structure, which enabled Visual Pipelines. In addition, v0.1.71 Fleets also support v2 configurations. You can’t downgrade a Fleet that uses a v3 configuration older than v0.1.71 without converting the configuration to v2.

Helm Example

Suppose you have an existing Fleet on version 0.1.69 that is using the configuration Pipeline ID of 123456789. To upgrade to version 0.1.71:

  1. Update the Chart
helm repo update
  1. Run the deployment command provided by the Edge Delta application.
helm upgrade edgedelta edgedelta/edgedelta -i --version v0.1.71 --set secretApiKey.value=123456789 -n edgedelta --create-namespace

Clean Install

Occasionally, you need to do a clean Fleet installation by removing any existing Edge Delta Fleets and re-installing with the latest version. The Fleet release notes indicate which Fleet versions require a clean installation.

For kubernetes with Helm installations:

helm delete edgedelta -n edgedelta

Note: use the release name you specified and the namespace you specified when you installed the agent. The edgedelta release name and edgedelta namespace are the default values.

For Kubernetes with Kubectl installations:

kubectl delete -f https://raw.githubusercontent.com/edgedelta/k8s/master/edgedelta-agent-k8s-from-helm.yaml

Note: If an older manifest was used you can remove the entire namespace: kubectl delete namespace edgedelta

Some resources such as clusterrole and clusterrolebinding, which are not in the edgedelta namespace may remain. You can remove them as follows:

kubectl delete clusterrole edgedelta

kubectl delete clusterrolebinding edgedelta