isabella232 / ubuntu-advantage-client

Ubuntu Advantage client for offerings from Canonical

Ubuntu Advantage Client

Clean and Consistent CLI for your Ubuntu Advantage Systems

The Ubuntu Advantage (UA) Client provides users with a simple mechanism to view, enable, and disable offerings from Canonical on their system. The following entitlements are supported:

• Common Criteria EAL2 Certification Tooling
• CIS Benchmark Audit Tooling
• Ubuntu Security Guide (USG) Tooling
• Ubuntu Extended Security Maintenance (ESM)
• Robot Operating System (ROS) Extended Security Maintenance
• FIPS 140-2 Certified Modules
• FIPS 140-2 Non-Certified Module Updates
• Livepatch Service

Obtaining the Client

The client comes pre-installed on all Ubuntu systems in the debian ubuntu-advantage-tools package. "Ubuntu Pro" images on AWS, Azure and GCP will also contain ubuntu-advantage-pro which automates machine attach on boot for custom AWS, Azure and GCP images.

Ubuntu Pro images are available on the following cloud platforms on all Ubuntu LTS releases (Xenial, Bionic, Focal):

1. AWS: Ubuntu PRO and Ubuntu PRO FIPS
2. Azure: Ubuntu PRO and Ubuntu PRO FIPS
3. GCP: Ubuntu PRO

Additionally, there are 3 PPAs with different release channels of the Ubuntu Advantage Client:

1. Stable: This contains stable builds only which have been verified for release into Ubuntu stable releases or Ubuntu PRO images.
   • add with sudo add-apt-repository ppa:ua-client/stable
2. Staging: This contains builds under validation for release to stable Ubuntu releases and images
   • add with sudo add-apt-repository ppa:ua-client/staging
3. Daily: This PPA is updated every day with the latest changes.
   • add with sudo add-apt-repository ppa:ua-client/daily

Users can manually run the ua command to learn more or view the manpage.

User Documentation

Tutorials

• Create a FIPS compliant Ubuntu Docker image

How To Guides

• How to Configure Proxies
• How to Enable Ubuntu Advantage Services in a Dockerfile
• How to Create a custom Golden Image based on Ubuntu Pro

Reference

• Ubuntu Release and Architecture Support Matrix

Explanation

• What is the daemon for? (And how to disable it)

Contributing

See CONTRIBUTING.md