Upgrade the provider to v2¶

The v2 version of the Terraform provider:

Doesn’t introduce any breaking changes to resources.
Adds support for Juju 4.x controllers.
Drops support for Juju 2.9 controllers.

Before you upgrade¶

Check which version of Juju your controller is running before deciding whether to upgrade.

Juju 2.9 controllers are not supported in v2. If you are using v1 against a Juju 2.9 controller, do not upgrade to v2. We will keep supporting 2.9 controller in the v1 track for security and bug fixes.
Juju 3.x controllers: Upgrade to the latest v1 release first, then upgrade to v2.
Juju 4.x controllers: v2 is the first provider release to support Juju 4.

Upgrade steps¶

Update the provider version constraint in your Terraform configuration:

terraform {
  required_providers {
    juju = {
      source  = "juju/juju"
      version = "~> 2.0"
    }
  }
}

Run terraform init -upgrade to download the new provider version.
Run terraform plan to review any changes before applying.