From 18f33db2a6bad6f8243688e6269471ebb252ff21 Mon Sep 17 00:00:00 2001 From: Zhijie Yang Date: Fri, 31 Jul 2026 15:51:08 +0200 Subject: [PATCH 1/4] doc: include contents for rock --- ubuntu/content.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/ubuntu/content.md b/ubuntu/content.md index 891f6ad45d30..6f4300cb931e 100644 --- a/ubuntu/content.md +++ b/ubuntu/content.md @@ -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. From f36c4d5bb3d8dcd08bb84bcccc30a99afbbf4b3f Mon Sep 17 00:00:00 2001 From: Zhijie Yang Date: Fri, 21 Aug 2026 17:21:31 +0200 Subject: [PATCH 2/4] doc: remove pebble and adjust rootfs wording --- ubuntu/content.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/ubuntu/content.md b/ubuntu/content.md index 6f4300cb931e..8a0896ce8f8e 100644 --- a/ubuntu/content.md +++ b/ubuntu/content.md @@ -32,10 +32,6 @@ 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 @@ -48,4 +44,4 @@ The tarballs published by Canonical, referenced by `dist-*` tags in https://git. ## 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. +Starting from Ubuntu 26.04 LTS, the rootfs is no longer built via `livefs`. Instead, the image 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), and the rootfs tarballs under the `dist-*` tags of the [ubuntu-base repo](https://git.launchpad.net/cloud-images/+oci/ubuntu-base) are exported from the Rockcraft build artifacts. From 5ec5ff0bb2f53bf99af8f681ef27449f510af7a6 Mon Sep 17 00:00:00 2001 From: Zhijie Yang Date: Fri, 21 Aug 2026 18:56:19 +0200 Subject: [PATCH 3/4] fix: rootfs branch name --- ubuntu/content.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ubuntu/content.md b/ubuntu/content.md index 8a0896ce8f8e..e65154c7c80c 100644 --- a/ubuntu/content.md +++ b/ubuntu/content.md @@ -44,4 +44,4 @@ The tarballs published by Canonical, referenced by `dist-*` tags in https://git. ## Ubuntu 26.04 LTS "Resolute Raccoon" and later -Starting from Ubuntu 26.04 LTS, the rootfs is no longer built via `livefs`. Instead, the image 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), and the rootfs tarballs under the `dist-*` tags of the [ubuntu-base repo](https://git.launchpad.net/cloud-images/+oci/ubuntu-base) are exported from the Rockcraft build artifacts. +Starting from Ubuntu 26.04 LTS, the rootfs is no longer built via `livefs`. Instead, the image 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), and the rootfs tarballs under the `-` tags of the [ubuntu-base repo](https://git.launchpad.net/cloud-images/+oci/ubuntu-base) are exported from the Rockcraft build artifacts. From 0b8a52cb01ec428a743d4965edf985b7c2261d55 Mon Sep 17 00:00:00 2001 From: Zhijie Yang Date: Fri, 21 Aug 2026 18:56:52 +0200 Subject: [PATCH 4/4] doc: remove Questing --- ubuntu/content.md | 1 - 1 file changed, 1 deletion(-) diff --git a/ubuntu/content.md b/ubuntu/content.md index e65154c7c80c..0dd2913e20c8 100644 --- a/ubuntu/content.md +++ b/ubuntu/content.md @@ -40,7 +40,6 @@ The tarballs published by Canonical, referenced by `dist-*` tags in https://git. - [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) ## Ubuntu 26.04 LTS "Resolute Raccoon" and later