Skip to content

doc: include contents for rock in ubuntu #2686

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
zhijie-yang wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

doc: include contents for rock in ubuntu #2686

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion ubuntu/content.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,20 @@ ENV LANG en_US.utf8

Starting from [Ubuntu 24.10 "Oracular Oriole"](https://discourse.ubuntu.com/t/oracular-oriole-release-notes/44878#unminimize), the `unminimize` command will no longer be shipped by default on minimal images. It has now been moved to a dedicated package which can be installed via `apt-get install -y unminimize`.

## Pebble

Starting from Ubuntu 26.04 LTS "Resolute Raccoon", these images are built as [rocks](https://github.com/canonical/rockcraft) and therefore bundle [Pebble](https://github.com/canonical/pebble), a lightweight, API-driven service manager, at `/usr/bin/pebble`. Note that Pebble is not set as the image's default entrypoint: the entrypoint is left empty and the default command is `/bin/bash`, preserving the existing entrypoint behavior.

# How is the rootfs built?

## Ubuntu 25.10 "Questing Quokka" and earlier

The tarballs published by Canonical, referenced by `dist-*` tags in https://git.launchpad.net/cloud-images/+oci/ubuntu-base Git repository, are built from scripts that live in [the livecd-rootfs project](https://code.launchpad.net/~ubuntu-core-dev/livecd-rootfs/+git/livecd-rootfs/+ref/ubuntu/master), especially `live-build/auto/build`. The builds are run on Launchpad. For build history see `livefs` build pages of individual releases on Launchpad:

- [Jammy](https://launchpad.net/~cloud-images-release-managers/+livefs/ubuntu/jammy/ubuntu-oci)
- [Noble](https://launchpad.net/~cloud-images-release-managers/+livefs/ubuntu/noble/ubuntu-oci)
- [Questing](https://launchpad.net/~cloud-images-release-managers/+livefs/ubuntu/questing/ubuntu-oci)
- [Resolute](https://launchpad.net/~cloud-images-release-managers/+livefs/ubuntu/resolute/ubuntu-oci)

## Ubuntu 26.04 LTS "Resolute Raccoon" and later

Starting from Ubuntu 26.04 LTS, the rootfs is no longer built via `livefs`. Instead, it is built directly with [Rockcraft](https://github.com/canonical/rockcraft) from the recipe on the `main` branch of the same [ubuntu-base repo](https://git.launchpad.net/cloud-images/+oci/ubuntu-base). Rockcraft runs the build on Launchpad via `rockcraft remote-build`, producing a `.rock` OCI archive that is then unpacked into the rootfs tarball published under the `dist-*` tags.