Roadmap & Releases

jnsgruk · 5 February 2023 23:30

The expander below has instructions to try any specific release version snap. You can also find release tarballs on GitHub.

Switch to a specific Juju client, model and controller version with snaps

To try a new release of Juju, you need to upgrade the client and the controller of your model.

Upgrading the client is as easy as:

sudo snap refresh juju --classic --channel=latest/stable
# or
sudo snap refresh juju --classic --channel=latest/candidate

If you’d like to upgrade a controller to a stable release:

juju upgrade-controller <controller>

And for a candidate release:

juju upgrade-controller <controller> --agent-stream=proposed

Before attempting any controller upgrades, you should consider if you need to backup your controller.

Juju 3.1.0 - 6 February 2023

Juju 3.1 includes quality of life improvements, removal of charmstore support, introduction of secret backends (Vault and Kubernetes), open-port support for Kubernetes sidecar charms, introduction of --base CLI argument, support for multi-homing on OpenStack and Bootstrap to LXD VM.

Juju 3.1-rc2 - TBC [Release Candidate]

Several bug fixes from 3.1-rc1, including:

juju using Openstack provider does not remove security groups on remove-machine after a failed provisioning (LP1940637)
k8s: unable to fetch OCI resources - empty id is not valid (LP1999060)
Juju doesn’t mount storage after lxd container restart (LP1999758)

See the full list in the milestone page.

Juju 3.1-rc1 - TBC [Release Candidate]

Juju 3.1 includes quality of life improvements, removal of charmstore support, introduction of secret backends (Vault and Kubernetes), open-port support for Kubernetes sidecar charms, introduction of --base CLI argument, support for multi-homing on OpenStack and Bootstrap to LXD VM.

See the full list in the milestone page.

Juju 3.1-beta1 - 20 January 2023

Juju 3.1 includes quality of life improvements, removal of charmstore support, introduction of secret backends (Vault and Kubernetes), open-port support for Kubernetes sidecar charms, introduction of --base CLI argument, support for multi-homing on OpenStack and Bootstrap to LXD VM.

To bootstrap 3.1-beta1 please set agent-stream to proposed:

snap install juju --channel 3.1/beta
juju bootstrap localhost --config agent-stream=proposed

See the full list in the milestone page.

Juju 2.9.38 - 17 January 2023

This release fixes some critical issues ending in panic and a some problems regarding the usage of lxd 5.x.

The main fixes in this release are below.

Fixes:

Juju panics when trying to add-k8s with no obvious storage to use (LP#1996808)
Panic after agent-logfile-max-backups-changed (LP#2001732)
Failing to deploy lxd containers with lxd latest/stable as lxd version 5.x is promoted to latest/stable (LP#2002309)

See the full list in the milestone page.

Juju 3.0.2 - 1 Dec 2022

The main fixes in this release are below. Two bootstrap issues are fix: one on k8s and the other on arm64, plus an intermittent situation where container creation can fail. There’s also a dashboard fix.

Fixes (more on the milestone):

Provisioner worker pool errors cause on-machine provisioning to cease (LP#1994488)
charm container crashes resulting in storage-attach hook error (LP#1993309)
not able to bootstrap juju on arm64 with juju 3.0 (LP#1994173)

See the full list in the milestone page.

Juju 2.9.37 - 15 Nov 2022

The main fixes in this release are below. A startup issue on k8s is fixed, plus an intermittent situation where container creation can fail.

Fixes (more on the milestone):

Provisioner worker pool errors cause on-machine provisioning to cease (LP#1994488)
charm container crashes resulting in storage-attach hook error (LP#1993309)

See the full list in the milestone page.

Juju 3.0.0 - 22 Oct 2022

See also: How to migrate your Juju deployment from 2.9 to 3.0

What’s Changed

CLI Changes

Commands that have been added

juju list-operations
juju list-secrets
juju operations
juju secrets
juju show-operation
juju show-secret
juju show-task
juju wait-for

Commands that have been renamed

juju constraints (replaces get-constraints)
juju integrate (replaces add-relation, relate)
juju model-constraints (replaces get-model-constraints)
juju set-application-base (replaces set-series)
juju upgrade-machine (replaces upgrade-series)
juju sync-agent-binary (replaces sync-tools)
juju refresh (replaces upgrade-charm)
juju exec (replaces juju run)
juju run (replaces juju run-action)

Commands that have been dropped

juju add-subnet
juju attach
juju budget
juju cached-images
juju cancel-action
juju charm
juju create-wallet
juju gui
juju hook-tool
juju hook-tools
juju list-cached-images
juju list-plans
juju list-wallets
juju plans
juju remove-cached-images
juju run-action
juju set-plan
juju set-wallet
juju show-action-output
juju show-action-status
juju show-status
juju show-wallet
juju sla
juju upgrade-dashboard
juju upgrade-gui
juju wallets

Removal of Juju GUI

Juju GUI is no longer deployed and the --no-gui flag was dropped from juju bootstrap. The Juju Dashboard replaces the GUI and is deployed using the juju-dashboard charm.

Windows charms no longer supported

Windows charms are no longer supported.

Bionic and earlier workloads no longer supported

Only workloads on focal and later are supported.

No longer create default model on bootstrap

Running juju bootstrap no longer creates a default model. After bootstrap you can use add-model to create a new model to host your workloads.

add-k8s helpers for aks, gke, eks

The Juju add-k8s command no longer supports the options “–aks”, “–eks”, “–gke” for interactive k8s cloud registration. The strict snap cannot execute the external binaries needed to enable this functionality. The options may be added back in a future update.

Note: it’s still possible to register AKS, GKE, or EKS clusters by passing the relevant kube config to add-k8s directly.

Deprecated traditional kubernetes charms

Traditional kubernetes charms using the pod-spec charm style are deprecated in favor of newer sidecar kubernetes charms.

From juju 3.0, pod-spec charms are pinned to Ubuntu 20.04 (focal) as the base until their removal in a future major version of juju.

Rackspace and Cloudsigma providers no longer supported

Rackspace and Cloudsigma providers are no longer supported

What’s New

Juju Dashboard replaces Juju GUI

The Juju Dashboard replaces the GUI; it is deployed via the juju-dashboard charm, which needs to be integrated with the controller application in the controller model.

juju bootstrap
juju switch controller
juju deploy juju-dashboard
juju integrate controller juju-dashboard
juju expose juju-dashboard

After the juju-dashboard application shows as active, run the dashboard command:

juju dashboard

Note: the error message which appears if the dashboard is not yet ready needs to be fixed. (https://bugs.launchpad.net/juju/+bug/1994953)

Actions

The client side actions UX has been significantly revamped. See the doc here: https://juju.is/docs/olm/manage-actions

To understand the changes coming from 2.9 or earlier, see the post here: https://discourse.charmhub.io/t/juju-actions-opt-in-to-new-behaviour-from-juju-2-8/2255

Secrets

It is now possible for charms to create and share secrets across relation data. This avoids the need for sensitive content to be exposed in plain text. The feature is most relevant to charm authors rather than end users, since how charms use secrets is an internal implementation detail for how workloads are configured and managed. Nonetheless, end users can inspect secrets created by deployed charms:

https://juju.is/docs/olm/secret

https://juju.is/docs/olm/manage-secrets

Charm authors can learn how to use secrets in their charms:

https://juju.is/docs/sdk/add-a-secret-to-a-charm

https://juju.is/docs/sdk/secret-events

Juju Controller Application

The controller model has a Juju controller application deployed at bootstrap. This application currently provides integration endpoints for the Juju dashboard charm. Future work will support integration with the COS stack and others.

MongoDB server-side transactions now default

Since the move to mongo 4.4 in juju 2.9, juju now uses server-side transactions.

Fixes

deploy k8s charms to juju 3.0 beta is broken (LP1947105)
Juju bootstrap failing with various Kubernetes (LP1905320)
bootstrapping juju installs ‘core’ but ‘juju-db’ depends on ‘core18’ (LP1920033)
bootstrap OCI cloud fails, cannot find image. (LP1940122)
Instance key stability in refresh requests (LP1944582)

See the full list in the milestone page.

Juju 2.9.35 - 12 Oct 2022

Fixes (more on the milestone):

juju series inconsistency deploying by charm vs bundle (LP1983581)
Azure provider: New region ‘qatarcentral’ (LP1988511)
Better error message for add-model with no credential (LP1988565)
juju ssh does not work for non admin user for a k8s model (LP1989160)
refresh: ERROR selecting releases: unknown series for version: “22.10” (LP1990182)

See the full list in the milestone page.

Juju 2.9.34 - 7 Sep 2022

Fixes (more on the milestone):

cloudinit-userdata doesn’t handle lists in runcmd (LP1759398)
juju doesn’t remove KVM virtual machines on maas nodes when using juju remove-unit (LP1982960)
juju does not honor --channel latest/* option (LP1984061)
cannot deploy bundle, invalid fields (LP1984133)
juju assumes lxd always available on machine nodes (LP1986877)

See the full list in the milestone page.

Juju 2.9.33 - 9 Aug 2022

Fixes (many more on the milestone):

lxd profiles not being applied (LP)
remove a unit with lxd profile doesn’t update (LP)
Instance poller reports: states changing too quickly (LP)
juju wants to use the LXD UNIX socket when configured to use HTTP (LP)
cannot pin charm revision without mention series in bundle (LP)
add retry-provisioning --all (LP)

See the full list in the milestone page.

Juju 2.9.32 - 24 June 2022

Fixes:

Juju 2.9.31 breaks yaml format accepted by juju add-credential(LP)
azure failed provisioning: conflict with a concurrent request(LP)
Juju attach-resource returns ‘unsupported resource type “”’ error(LP)
OpenStack: open-port icmp doesn’t work(LP)
Juju bootstrap aks can’t find storage(LP)

See the full list in the milestone page.

Juju 2.9.31 - 31 May 2022

Fixes:

juju controller doesn’t reference juju-https-proxy when deploying from charmhub (LP)
sidecar application caasapplicationprovisioner worker restarts due to status set failed (LP)
LXD container fails to start due to UNIQUE constraint on container.name (LP)
k8s application stuck in an unremoveable state (LP)
Juju keeps creating OpenStack VMs if it cannot allocate a floating IP (LP)
Instance type constraint throws “ambiguous constraints” error on GCP (LP)

See the full list in the milestone page.

Juju 2.9.29 - 30 Apr 2022

Fixes:

Controller bootstrap fails on local LXD with “Certificate not found”(LP)
Juju unable to add a k8s 1.24 k8s cloud(LP)
model migration treats “TryAgain” as a fatal error(LP)
juju 2.9.26 unable to deploy centos7(LP)

See the full list in the milestone page.

Juju 2.9.28 - 08 Apr 2022

Fixes:

Juju renders invalid netplan YAML for nameservers in IPv4/IPv6 dual-stack environment (LP)
juju 2.9.27 glibc errors(LP)
Juju controller keeps restarting when deployed with juju-ha-space and juju-mgmt-space (LP)

See the full list in the milestone page.

Juju 2.9.27 - 21 Mar 2022

Candidate release: 18 Mar 2022

Fixes:

juju client panics during bootstrap on a k8s cloud (LP1964533)
Controller upgrade ends up with locked upgrade (LP1942447)
juju fails to upgrade ha controllers on for (at least) lxd controllers (LP1963924)

See the full list in the milestone page.

Juju 2.9.26 - 12 Mar 2022

This release includes a fix for broken upgrades coming from a deployment with cross model relations to multiple offers hosted on an external controller (LP1964130).

Fixes:

2.9.25 Upgrade Fails for Cross-Controller CMRs(LP1964130)
Unauthorized for K8s API during charm removal(LP1941655)
CRD creation fails in pod spec charms on juju 2.9.25(LP1962187)
Juju prompted for a password in the middle of a bundle deploy(LP1960635)
Unable to set snap-store-assertions on model-config (LP1961083)
- Note: This fix changes how to use log labels in model-config, extra single quotes are no longer required: juju model-config -m controller "logging-config=#charmhub=TRACE"

See the full list in the milestone page.

Juju 2.9.25 - 24 Feb 2022

This release is significant because it transitions to using the juju-db snap from the 4.4/stable channel (running mongodb 4.4.11 at the time of writing) for newly bootstrapped controllers. NB the juu-db snap is not used if the default series is changed from focal to an earlier vrsion. Existing controllers which are upgraded to this release will not change the mongo currently in use.

Fixes:

Juju trust not working for K8s charm(LP)
cannot migration nor upgrade without manual intervention for a machine after a container is removed- (LP1960235 )
- On machines exhibiting the above behavior, the agents will show as lost during the upgrade, you must kill the jujud process on the machine. This allow it to be restarted and continue the upgrade.
- Also seen on machine’s having an LXD container which haven’t been removed.
destroy model fails if there’s a relation to offered application (LP)
Sidecar charm get stuck if PodSpec charm with same name was deployed previously (LP)
2.9.22 regression: local charm paths resolved wrongly in bundles (LP)
juju migrate failing with manual machines, verifying controller instance(LP)
Offer permissions are not migrated (LP)
destroy model fails if there’s a relation to offered application(LP)

See the full list in the milestone page.

Juju 2.9.22 - 13 Dec 2021

Fixes:

Juju 2.9.9 fails to bootstrap on AWS (LP)
controller migration is very hard when dealing with large deployments (LP)
models not logging (LP)
ceph-osd is showing as fail (LP)
Bootstrap with Juju 2.8.11 breaks on LXD 4.0.8 (LP)
juju ssh --proxy not working on aws when targeting containers with FAN addresses (LP)

See the full list in the milestone page.

Juju 2.9.21 - 3 Dec 2021

Fixes:

juju enable-ha fails to cluster on 2.9.18 manual machines (LP)
juju storage events are missing JUJU_STORAGE_ID (LP)
Juju failing to remove unit due to attached storage stuck dying (LP)
Juju creates two units for sidecar CAAS application (LP)

See the full list in the milestone page.

Juju 2.9.19 - 23 Nov 2021

Fixes:

controller models with valid credentials becoming suspended (LP)
FIP created in incorrect AZ for instance when bootstrapped against OpenStack. (LP)
[2.9.16 & 2.9.17] juju trust gets lost if juju config is run on application (LP)
mongo 4.4 has a multiline --version (LP)

See the full list in the milestone page.

Juju 2.8.13 - 11 Nov 2021

This release fixes various issues with Juju 2.8

Fixes:

Juju ~~2.9.9~~ fails to bootstrap on AWS (LP)
controller migration is very hard when dealing with large deployments (LP)
models not logging (LP)
ceph-osd is showing as fail (LP)
Bootstrap with Juju 2.8.11 breaks on LXD 4.0.8 (LP)
juju ssh --proxy not working on aws when targeting containers with FAN addresses (LP)

See the full list in the milestone page.

Juju 2.9.18 - 8 Nov 2021

Fixes:

agent cannot be up on LXD/Fan network on OpenStack OVN/geneve mtu=1442 (LP1936842)
no way to declare a k8s charm with metadata v2 that doesn’t need a workload container (LP1928991)
Method to run an action in a workload container in sidecar charms (LP1923822 )

See the full list in the milestone page.

Juju 2.9.17 - 27 Oct 2021

This release introduces telemetry as a configurable option per model. It also supports more OCI image registry providers for pulling images used for CAAS models.

Fixes:

Leader role not transferred when the inital leader goes offline (LP)
if the primary node of an HA config goes down, the controller stops responding (LP)
Trust permissions not ready on install hook in sidecar charms (LP)
deployed application loses trust after charm upgrade (LP)

See the full list in the milestone page.

Juju 2.9.16 - 11 Oct 2021

Fixes:

Unable to deploy workloads to lxd cloud added to k8s controller (LP)
memory usage leading to OOMs on controllers
LXD bootstrap fails with “Executable /snap/bin/juju-db.mongod not found” (LP)
Requested image’s type ‘virtual-machine’ doesn’t match instance type ‘container’ (LP)

See the full list in the milestone page.

Juju 2.9.15 - 28 Sept 2021

This release improves the robustness of repeated cross model relation setup / teardown. There’s also some improvements to how raft is used internally to manage leases.

Fixes:

ceph mon does not render data to ceph-rados after redployment of ceph-radosgw only (LP)
Unable to remove offers when 2 endpoints are offered with the same application (LP)
upgrading 2.9.12 to 2.9.13 gets stuck in ‘raftlease response timeout’ (LP)
pod-spec uniter exits on pending action op when remote caas container died (LP)

See the full list in the milestone page.

Juju 2.9.14 - 14 Sept 2021

This release fixes an upgrade issue found during testing of the 2.9.13 release. There’s also an additional fix for an earlier regression deploying LXD containers on AWS.

Fixes:

Juju fails to provision LXD containers with LXD >= 4.18 (LP)
Juju is unable to match machine address CIDRs to subnet CIDRs on Equinix Metal clouds (LP)
Non POSIX-compatible script used in /etc/profile.d/juju-introspection.sh (LP)
In AWS using spaces and fan network for a private network does not allow LXC containers to start(LP)

See the full list in the milestone page.

Juju 2.9.13 - Release cancelled, replaced by 2.9.14

This release adds support for pulling images used for CAAS models from private OCI registries! This means you can host your own jujud-operator, charm-base and juju-db images. This initial release focuses on private registries on Dockerhub, with other public cloud registry support coming in a future release. More details in this post.

Fixes:

Juju fails to provision LXD containers with LXD >= 4.18 (LP)
Juju is unable to match machine address CIDRs to subnet CIDRs on Equinix Metal clouds (LP)
Non POSIX-compatible script used in /etc/profile.d/juju-introspection.sh (LP)

Juju 2.9.12 - 30 Aug 2021

Fixes:

Cross-model relations broken for CAAS (LP)
Boot failure when model-config sets snap-proxy (LP)
The juju export-bundle command gives error after upgrade (LP)
Several updates for the Raft engine that handles leases. These are steps to address (LP), though that issue is not completely resolved.

See the full list in the milestone page.

Juju 2.9.11 - 17 Aug 2021

Fixes:

Resource downloads are very slow in some cases (LP)
Upgrading the mongodb snap causes controller to hang without restarting mongod (LP)
OpenStack provider: retry-provisioning doesn’t work for Quota exceeded for ... (LP)

See the full list in the milestone page.

Juju 2.9.10 - 03 Aug 2021

A new logging label: charmhub. To enable debugging information about Charmhub, you can now use the following:

juju model-config -m controller "logging-config='#charmhub=TRACE'"

Fixes:

Unable to upgrade-charm a pod_spec charm to sidecar charm (LP)
OOM and high load upgrading to 2.9.7 (LP)
Controller not caching agent binaries across models (LP)
Bundle with local metadata v2 k8s sidecar charm fails for “metadata v1” (LP)
The network-get hook returns the vip as ingress address (LP)

See the full list in the milestone page.

Juju 2.9.9 - 19 Jul 2021

Fixes:

Juju 2.9.8 tries to use an empty UID when deleting Kubernetes objects, and cannot remove applications (LP)
The juju-log output going to machine log file instead of unit log file in Juju 2.9.5 (LP)
Deployment of private charms is broken in 2.9 (was working in 2.8) (LP)
[Windows] Juju.exe and MicroK8s.exe bootstrap error (LP)

See the full list in the milestone page.

Juju 2.9.8 - 13 Jul 2021

This release introduces support for bootstrapping and deploying workloads to Equinix cloud. To try out the new provider:

Run juju update-public-clouds --client to ensure that provider API endpoint list is up to date.
Add a credential for the equinix cloud (juju add-credential equinix). You will need to specify your equinix project ID and provide an API key. You can use the equinix console to look up your project ID and generate API tokens.
Select a metro area and bootstrap a new controller. For example to bootstrap to the Amsterdam data-center you may run the following command: juju bootstrap equinix/am.

Caveats:

Due to substrate limitations, the equinix provider does not implement support for firewalls. As a result, workloads deployed to machines under the same project ID can reach each other even across Juju models.
Deployed machines are always assigned both a public and a private IP address. This means that any deployed charms are implicitly exposed and proper access control mechanisms need to be implemented to prevent unauthorized access to the deployed workloads.

This release also introduces logging labels which will help with the aggregation of logs via a label rather than a namespace.

juju model-config "logging-config='#http=TRACE'"

The above will turn on HTTP loggers to trace. This is a new UX feature to help with debugging, it’s not been full worked through Juju yet and might be subject to change.

Fixes:

Juju fails to deploy mysql-k8s charm with its image resource (LP)
Juju 2.9 failing to create ClusterRoleBinding (LP)
Juju interprets caas-image-repo containing port number incorrectly (LP)

See the full list in the milestone page.

Juju 2.9.7 - 06 Jul 2021

Fixes:

Juju upgrade 2.9 controller from local branch fails with wrong namespace. (LP)
Unit network data not populated on peer relations in sidecar charms (LP)
A juju refresh --switch ./local fails for metadata v1 charm (LP)
A migrated CaaS model will be left in the cluster after model destroyed (LP)
Unable to deploy postgresql-k8s charm from charmhub (LP)
Unable to deploy bundle with sidecar and pod_spec charms (LP)
IP address sometimes not set or incorrect on pebble_ready event (LP)
Improve juju ssh on k8s poor ux (LP)
Support encrypted EBS volumes for bootstrapping controllers on AWS (LP)
Document and support charmcraft's bundle.yaml fields (LP)
install hook run after juju upgrade-model 2.7.8 to 2.9.4 (LP)
controller fails to bring up jujud machine (LP)
The juju ssh --proxy command is not working on aws when targeting containers with FAN addresses (LP)
The juju resources revision date format uses year-date-month format instead of year-month-date (LP)
Using juju config with empty values erroneously resets since 2.9 (LP)

See the full list in the milestone page.

Expand to see the release notes for 2.9.0-2.9.5

Expand to see the release notes for the 2.8 series

Expand to see the release notes for the 2.7 series

Expand to see the release notes for the 2.6 series

Expand to see the release notes for the 2.5 series

Expand to see the release notes for the 2.4 series

jnsgruk · 3 September 2021 13:46