Upgrading Edge Delta

Upgrading the Edge Delta agent.

  2 minute read  

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

This means you can upgrade an agent without changing the agent configuration. To upgrade, you pass the same API key in while installing a more recent version.

To see installation instructions for an agent you want to upgrade:

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

  1. Click Pipelines and select Pipelines.
  2. Click the kebab (⋮) icon and select Deploy Pipeline.
  3. Select the deployment method.

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

  1. Click Pipelines and select Legacy Pipelines.
  2. Click the kebab (⋮) icon in the Actions column for the agent and select Deploy/Upgrade.
  3. Select the deployment method.

The deployment commands for the agent using the selected method are listed.

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 agent’s configuration.

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

Agent and Configuration Versions

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

Helm Example

Suppose you have an existing agent on version 0.1.69 that is using the configuration API key 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