[Impact]
This release sports both bug-fixes and new features and we would like to
make sure all of our supported customers have access to these
improvements. The notable ones are:
* Schema of `ua status --format=json` has been updated to include more
information and better organize the information already present.
* `yaml` is now a format option for `ua status`
* `http_proxy` and `https_proxy` configuration fields were added
- When set, `ua` will use the specified proxy.
- When set, `ua` will configure snap (if installed) and livepatch
(if enabled) to use the specified proxy
* `apt_http_proxy` and `apt_https_proxy` configuration fields were added
- When set, `ua` will configure apt to use the specified proxy
* `ua refresh` now accepts optional sub commands: `ua refresh contract`
and `ua refresh config`. `ua refresh contract` does what `ua refresh`
used to do. `ua refresh config` re-processes the uaclient config file.
`ua refresh` with no sub command does the equivalent of `ua refresh
config && ua refresh contract`.
* `ua config set key=val` is a new command that edits a key in
uaclient's config file.
* `ua config unset key` is a new command that removes the value of a key
uaclient's config file
* `ua config show` is a new command that shows the current value of
uaclient config options.
See the changelog entry below for a full list of changes and bugs.
[Test Case]
The following development and SRU process was followed:
https://wiki.ubuntu.com/UbuntuAdvantageToolsUpdates
The ubuntu-advantage-tools team will be in charge of attaching the artifacts and console output of the appropriate run to the bug. ubuntu-advantage-tools team members will not mark ‘verification-done’ until this has happened.
* Automated Test Results
<TODO>
Attach or link the following automated integration test runs for ubuntu-advantage-tools on each affected LTS release:
- lxd.container platform
- lxd.kvm platform
- AWS Ubuntu PRO
- AWS Ubuntu cloud-images (non-Pro)
- Azure Ubuntu PRO
- Azure Ubuntu cloud-images (non-Pro)
- GCP Ubuntu PRO
- GCP Ubuntu cloud-images (non-Pro)
</TODO>
* Additional Manual tests:
- upgrade LTS -> LTS attached container + post-upgrade operations
- upgrade LTS -> LTS unattached container + post-upgrade operations
- package dependency validation verification for distro-info
[Regression Potential]
In order to mitigate the regression potential, the results of the
aforementioned integration tests are attached to this bug.
The changes most likely to produce an unexpected regression are the changes to the output of `ua status --format=json`. We had (and still have) a notice in the output that tools should _not_ rely on the structure of the output of this command; however, we know of at least one tool that does, and others may as well despite the warning. We have avoided changes that we know will break others, but it is possible that we broke some unknown integration.
The behavior of `ua refresh` has slightly changed. It now processes the proxy configuration before refreshing the contract. Since the proxy configuration is also new with this release, it is unlikely that any existing use of `ua refresh` will start doing anything new, unless the user also adds the new proxy config fields.
This update also changes the schema of some of our state that we keep in a json file. We're introducing a basic migration mechanism specifically to avoid anything breaking if the json file on disk is the old version. In the worst case if the migration script doesn't work, then running `ua status` with root privileges will overwrite the existing json file with the new version, which will resolve any problems.
[Discussion]
In this release, we're starting to lay the foundation for more proper schema versioning of `ua status` output. In the future when we need to change the output again, we plan to properly bump the schema version and implement a way to select the version the caller expects. At that time we will remove our warning from the output and start to guarantee version compatibility.
[Changelog]
Release 27.2.1
* d/control:
- remove unnecessary distro-info dependency from build-depends
* d/rules:
- pick right version of distro-info based on release
* docs:
+ add information about proxy auth to manpage and readme
* lib:
+ handle missing configStatus key in patch status json script
Release 27.2
* d/control:
- add comments to explain complex build-depends
- add version requirement to distro-info (LP: #1932028)
* d/tools.postinst:
- run status.json schema patch script to avoid non-root status errors
* New upstream release 27.2:
- attach: print contract server reason for 403 (GH: #1630)
- cli: add ua config set, unset and show subcommands
- config:
+ add default ua_config setting values
+ only allow some fields to be set by envvar
+ use defaults for contract and security url
- docs:
+ add proxy config options to man page
+ add instructions to generate MOTD messages
+ add support matrix info
+ remove broken api link
- enable: allow downgrading packages during enable (GH: #1659)
- fips:
+ add focal test for fips-updates
+ alert if wrong fips package installed on gov clouds
+ install correct fips package on gov clouds
+ only install conditional_packages if necessary and available
- logs: log env vars that affect config on cli runs
- proxy:
+ add config options to set proxies
+ print message when setting proxy
+ support configuring apt proxies
+ support configuring snap and livepatch proxies
+ support setting proxy for web requests
+ validate urls before setting as proxies
- refresh: support refreshing config and contract separately
- status
+ add config info to json output
+ add env vars to json output
+ do not show unavailable services in json output
+ support yaml format with same content as json format
+ update account info in json output
+ update contract info in json output
+ update root level keys of json output
- refactor:
+ remove side effects from can_enable (GH: #1654, #1571)
+ use DatetimeAwareJSONDecoder to parse date strings
- tests:
+ add additional enable test for incompatible services
+ add flag to enable proposed pocket
+ add test to check and print version being tested
+ drop trusty specific tests
27.2~21.10.1 released to impish