** Description changed:

  [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.
+     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>
  
  [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]
- <TODO: other background>
+ 
+ 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]
  
  <TODO: Paste in change log entry>

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/1934902

Title:
   [SRU] ubuntu-advantage-tools (27.1 -> 27.2) Xenial, Bionic, Focal,
  Hirsute

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-advantage-tools/+bug/1934902/+subscriptions

-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to