Skip to main content

Upgrading the OPA

The latest agent versions are available in the agent GitHub repository. Follow the instructions below to upgrade the agent based on your deployment method.

Bump the version tag on the superblocks_agent_image variable in your agent'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>"

Upgrading from version 0.x.x to 1.x.x

Agent version 1.x.x is a major upgrade that enables support for Control Blocks. To upgrade from version 0.x.x to 1.x.x, follow the instructions below.

Update the version of the Superblocks module in your Terraform file to "~>1.0".

version = "~>1.0"

For AWS ECS Fargate, also note the changes in the migration guide here and update any affected variables.

Upgrading from version < 0.69.0

Agent version 0.69.0 introduced a single container architecture, making it simpler to manage and scale. Specifically, the agent now runs as one container image, ghcr.io/superblocksteam/agent. The following containers used in versions < 0.69.0 have been removed:

  • ghcr.io/superblocksteam/agent-controller
  • ghcr.io/superblocksteam/agent-worker
  • ghcr.io/superblocksteam/agent-worker-python

If upgrading from a version below 0.69.0, be sure your agent configuration no longer references these containers and removes any autoscaling associated with them. Your agent configuration should match the latest Docker Compose file or Helm chart, depending on your deployment method.