Comment 0 for bug 1989279

[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:

   * The rebranding done to match the launch of Ubuntu Pro
     - 'esm-apps' is now generally available as a non-beta service
     - Messages, commands and services have been reworded/rewritten to use `pro`
       and the Ubuntu Pro defined terms
   * A new public API is being released, with a few starting endpoints. This
     feature will grow in subsequent releases as more endpoints are added
   * Improvements in auto-attach to better integrate with cloud-init
   * Magic attach endpoints let users attach without explicitly providing a token
   * The security-status command output has information like
     'ubuntu-security-status', aiming to replace it in the future
   * Fix a LP bug where an APT auth file was growing exponentially (LP: #1985863)
   * Several improvements and bug fixes

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>

[Regression Potential]
People may still be relying on `ua` as a command in their scripts instead of `pro`. To avoid regression, `ua` will still be generally available as a CLI alias.

Changes in the text/messages are done for the CLI commands output, but the machine-readable data provided by the client has not changed their schema in any way, so scripts relying on the client will not break.

Changes for both text and functionality are covered by the integration test suite - which should be executed and passing as part of this SRU process.

Other changes introduce new features or options, and there is no expected risk of regression there.

[Changelog]

  * d/control:
    - Update VCS references
  * d/links:
    - add usr/bin/pro as an alias to ubuntu-advantage
  * d/postinst:
    - include root_mode parameter when creating UAConfig instances
    - change calls to add_notice to notice_file.add
    - create public machine-token file if it does not exist
  * New upstream release 27.11
    - api:
      + new `pro api` command to access the public client API
      + 'version' endpoint returning version information
      + 'should auto attach' endpoint informing if a system should run
        auto-attach on startup
      + 'full auto attach' endpoint performing auto-attach
      + 'magic attach' endpoints for the Magic Attach flow
    - auto-attach:
      + better errors for invalid pro images (GH: #2180, #1833)
      + don't detach on already auto-attached instances
      + no-op when ubuntu-advantage information is present on cloud-init userdata
      + change systemd unit to run after cloud-config
    - cli:
      + cli: better error message on unrecognized flags (GH: #672)
    - collect-logs:
      + can now be executed as a non-root user
      + is executed automatically and result is appended when using apport to
        report a bug
    - docs:
      + now formatted to be built with sphinx, and published in readthedocs
      + added explanation on how auto-attach works (GH: #2179)
    - enable:
      + new access-only flag for usecases where auto-install is undesired
      + fix apt auth line replacement (LP: #1985863)
    - esm-apps: generally available as non-beta as part of Ubuntu Pro
    - fix: check if livepatch has already fixed a CVE before attempting a fix
    - jobs: new timer job to check if the release reached end of support
    - magic-attach: new way to attach a machine without using a token directly
    - pro:
      + Ubuntu Pro is released as a product
      + make `pro` the recommended executable for the client
      + client, apt and motd messages updated/rewritten to show Pro
        information
      + base URL changed from /advantage to /pro
      + ESM services renamed as part of Pro
    - ros: released as a non-beta entitlement
    - security-status
      + does not require the --format flag anymore
      + human readable output added based on ubuntu-security-status
      + machine readable output contains CVEs fixed by Livepatch
      + package counts include all esm-infra and esm-apps repositories
    - status:
      + don't show unavailable services by default (GH: #2156, #2159)
      + expiry date formatted based on timezone (GH: #695)
      + non-root users get the current status instead of a cached version
      + --wait flag now working for non-root users
    - version: warn about new available versions of the client in CLI command
      output and API calls