Upgrading the data plane - Superblocks Docs

Superblocks periodically releases new versions of the data plane with bug fixes, performance improvements, and new features. We recommend keeping your data plane up to date to ensure compatibility with the latest Superblocks platform capabilities. See the changelog for details on each release.

Release notifications

To be notified when new data plane versions are published, you can watch the Superblocks agent repository on Docker Hub. Available tagged versions are listed there and can be used when specifying the image version in your deployment configuration.

Upgrade instructions

Follow the instructions below to upgrade the data plane based on your deployment method.

Terraform
Helm
Docker

Bump the version tag on the superblocks_agent_image variable in the service’s Terraform file.AWS ECS Fargate

superblocks_agent_image = "ghcr.io/superblocksteam/agent:<VERSION>"

Google Cloud Run

superblocks_agent_image = "gcr.io/superblocks-registry/superblocks/agent:<VERSION>"

Fetch the latest chart.

helm repo update

Redeploy the chart.

helm upgrade -i -n superblocks superblocks-agent superblocks/superblocks-agent \
  --create-namespace \
  -f values.yaml \
  --set superblocks.agentKey="<YOUR_AGENT_KEY>" \

Download the latest Docker Compose file and redeploy. To specify a version, set SUPERBLOCKS_DOCKER_AGENT_TAG. Otherwise the latest version is used by default.

curl -s https://charts.superblocks.com/agent/compose.yaml | \
SUPERBLOCKS_AGENT_KEY="<YOUR_AGENT_KEY>" \
SUPERBLOCKS_AGENT_HOST_URL="<YOUR_AGENT_URL>" \
SUPERBLOCKS_DOCKER_AGENT_TAG="<VERSION>" \
docker compose -p superblocks -f - up

​Release notifications

​Upgrade instructions

Release notifications

Upgrade instructions