From ed982681fb173879c5d93c518a7fb6b4bde72b9f Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Thu, 17 Jul 2025 09:21:05 +0100 Subject: [PATCH 01/10] moved files for restructure --- .../deploy-an-image}/index.md | 4 +--- .../deploy-an-image}/install-on-mediatek.md | 0 .../deploy-an-image}/install-on-renesas.md | 0 docs/how-to-guides/index.md | 5 +++-- docs/tutorials/build-your-first-image/index.md | 2 ++ docs/tutorials/try-pre-built-images/index.md | 10 ++-------- .../use-raspberry-pi-imager.md | 0 .../{install-on-a-device => }/use-the-dd-command.md | 0 8 files changed, 8 insertions(+), 13 deletions(-) rename docs/{tutorials/try-pre-built-images/install-on-a-device => how-to-guides/deploy-an-image}/index.md (92%) rename docs/{tutorials/try-pre-built-images/install-on-a-device => how-to-guides/deploy-an-image}/install-on-mediatek.md (100%) rename docs/{tutorials/try-pre-built-images/install-on-a-device => how-to-guides/deploy-an-image}/install-on-renesas.md (100%) rename docs/tutorials/try-pre-built-images/{install-on-a-device => }/use-raspberry-pi-imager.md (100%) rename docs/tutorials/try-pre-built-images/{install-on-a-device => }/use-the-dd-command.md (100%) diff --git a/docs/tutorials/try-pre-built-images/install-on-a-device/index.md b/docs/how-to-guides/deploy-an-image/index.md similarity index 92% rename from docs/tutorials/try-pre-built-images/install-on-a-device/index.md rename to docs/how-to-guides/deploy-an-image/index.md index 3e54af84..35883b46 100644 --- a/docs/tutorials/try-pre-built-images/install-on-a-device/index.md +++ b/docs/how-to-guides/deploy-an-image/index.md @@ -1,4 +1,4 @@ -# Install on a device +# Deploy an image We create pre-built Ubuntu Core images for several testing platforms. These images are a way to explore Ubuntu Core. Canonical produces official images for the [following platforms](https://ubuntu.com/core/docs/supported-platforms). @@ -23,7 +23,5 @@ We also provide instructions for building and installing an Ubuntu Core image on :maxdepth: 2 :glob: -Use Raspberry Pi imager -Use the dd command Install on a Renesas RZ/G2L Install on a MediaTek Genio diff --git a/docs/tutorials/try-pre-built-images/install-on-a-device/install-on-mediatek.md b/docs/how-to-guides/deploy-an-image/install-on-mediatek.md similarity index 100% rename from docs/tutorials/try-pre-built-images/install-on-a-device/install-on-mediatek.md rename to docs/how-to-guides/deploy-an-image/install-on-mediatek.md diff --git a/docs/tutorials/try-pre-built-images/install-on-a-device/install-on-renesas.md b/docs/how-to-guides/deploy-an-image/install-on-renesas.md similarity index 100% rename from docs/tutorials/try-pre-built-images/install-on-a-device/install-on-renesas.md rename to docs/how-to-guides/deploy-an-image/install-on-renesas.md diff --git a/docs/how-to-guides/index.md b/docs/how-to-guides/index.md index 9aaa5fed..aab821dd 100644 --- a/docs/how-to-guides/index.md +++ b/docs/how-to-guides/index.md @@ -35,6 +35,7 @@ Ubuntu Core has been developed specifically to leverage the power of snap packag :glob: Using Ubuntu Core -Create images +Create an image +Deploy an image Manage Ubuntu Core -Deploy containers +Work with containers diff --git a/docs/tutorials/build-your-first-image/index.md b/docs/tutorials/build-your-first-image/index.md index 8cdb59ed..81621e47 100644 --- a/docs/tutorials/build-your-first-image/index.md +++ b/docs/tutorials/build-your-first-image/index.md @@ -6,6 +6,8 @@ This same process can be used to build Ubuntu Core images for various hardware a ## Step-by-step guide + + 1. [Requirements](requirements) 1. [Create an Ubuntu One account](access-ubuntu-one) 1. [Create the account online](access-ubuntu-one.md#create-an-ubuntu-one-account) diff --git a/docs/tutorials/try-pre-built-images/index.md b/docs/tutorials/try-pre-built-images/index.md index 517a4979..2037b071 100644 --- a/docs/tutorials/try-pre-built-images/index.md +++ b/docs/tutorials/try-pre-built-images/index.md @@ -21,13 +21,6 @@ Ubuntu Core runs on a large range of hardware, and pre-built images are availabl - [Use Raspberry Pi imager](install-on-a-device/use-raspberry-pi-imager): install a pre-built Ubuntu Core image on a Raspberry Pi - [Use the dd command](install-on-a-device/use-the-dd-command): write an Ubuntu Core reference image to internal storage -## Install on a specific device - -Pre-built test images are also available for Renesas GZ/G2L and MediaTek Genio devices. - -- [Install on a Renesas RZ/G2L](install-on-a-device/install-on-renesas): Install a pre-built image on a Renesas RZ/G2L device -- [Install on a MediaTek Genio](install-on-a-device/install-on-mediatek): Install a pre-built image on a MediaTek Genio device - ```{toctree} :hidden: @@ -36,4 +29,5 @@ Pre-built test images are also available for Renesas GZ/G2L and MediaTek Genio d :glob: Install on a VM -Install on a device +Use Raspberry Pi Imager +Use the dd command diff --git a/docs/tutorials/try-pre-built-images/install-on-a-device/use-raspberry-pi-imager.md b/docs/tutorials/try-pre-built-images/use-raspberry-pi-imager.md similarity index 100% rename from docs/tutorials/try-pre-built-images/install-on-a-device/use-raspberry-pi-imager.md rename to docs/tutorials/try-pre-built-images/use-raspberry-pi-imager.md diff --git a/docs/tutorials/try-pre-built-images/install-on-a-device/use-the-dd-command.md b/docs/tutorials/try-pre-built-images/use-the-dd-command.md similarity index 100% rename from docs/tutorials/try-pre-built-images/install-on-a-device/use-the-dd-command.md rename to docs/tutorials/try-pre-built-images/use-the-dd-command.md From 1d74c35d3232cb4ea813f74671269faa11cfed98 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Thu, 17 Jul 2025 09:52:43 +0100 Subject: [PATCH 02/10] added redirects for restructure --- docs/redirects.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/redirects.txt b/docs/redirects.txt index 244c244d..2c4bd754 100644 --- a/docs/redirects.txt +++ b/docs/redirects.txt @@ -12,6 +12,13 @@ # Example: # redirect/from/file/ redirect/to/file/ +# RTD reconfiguration + +tutorials/try-pre-built-images/install-on-a-device/use-raspberry-pi-imager/ tutorials/try-pre-built-images/use-raspberry-pi-imager/ +tutorials/try-pre-built-images/install-on-a-device/use-the-dd-command/ tutorials/try-pre-built-images/use-the-dd-command/ +tutorials/try-pre-built-images/install-on-a-device/ how-to-guides/deploy-an-image/ +tutorials/try-pre-built-images/install-on-a-device/install-on-renesas/ how-to-guides/deploy-an-image/install-on-renesas/ +tutorials/try-pre-built-images/install-on-a-device/install-on-mediatek/ how-to-guides/deploy-an-image/install-on-mediatek/ # Old top level uc24 reference/release-notes/ From 7c16fa81abc0b149df08defb2b2519a5a66c2390 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Thu, 17 Jul 2025 09:59:11 +0100 Subject: [PATCH 03/10] added deploy how-tos to guides. --- docs/how-to-guides/index.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/how-to-guides/index.md b/docs/how-to-guides/index.md index aab821dd..ccdcc15c 100644 --- a/docs/how-to-guides/index.md +++ b/docs/how-to-guides/index.md @@ -14,6 +14,13 @@ Any device running Ubuntu Core is instantiated from an image. This image contain - [Create images](image-creation/index) +## Deploy an image + +Pre-built image install guides for testing specific platforms, including devices from MediaTek and Renesas. + +- [Install on a Renesas RZ/G2L](deploy-an-image/install-on-renesas/): Install a pre-built image on a Renesas RZ/G2L device +- [Install on a MediaTek Genio](deploy-an-image/install-on-mediatek/): Install a pre-built image on a MediaTek Genio device + ## Manage Ubuntu Core Maintain and manage your Ubuntu Core systems, including recovery modes, system users, configuration options and kernel options. From 806914ecf89a27ab4531880b7e4200308e369a35 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Thu, 17 Jul 2025 10:10:27 +0100 Subject: [PATCH 04/10] updated deploy landing page --- docs/how-to-guides/deploy-an-image/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/how-to-guides/deploy-an-image/index.md b/docs/how-to-guides/deploy-an-image/index.md index 35883b46..4c6991d8 100644 --- a/docs/how-to-guides/deploy-an-image/index.md +++ b/docs/how-to-guides/deploy-an-image/index.md @@ -2,13 +2,6 @@ We create pre-built Ubuntu Core images for several testing platforms. These images are a way to explore Ubuntu Core. Canonical produces official images for the [following platforms](https://ubuntu.com/core/docs/supported-platforms). -## Image writing - -We recommend first users try pre-built Ubuntu Core images on a Raspberry Pi or Intel NUC, as these range of devices are easy to use and widely accessible. - -- [Use Raspberry Pi imager](use-raspberry-pi-imager): install a pre-built Ubuntu Core image on a Raspberry Pi -- [Use the dd command](use-the-dd-command): write an Ubuntu Core reference image to internal storage - ## Install on a specific device We also provide instructions for building and installing an Ubuntu Core image on a specific device. @@ -16,6 +9,13 @@ We also provide instructions for building and installing an Ubuntu Core image on - [Install on a Renesas RZ/G2L](install-on-renesas): Install a pre-built testing image on a [Renesas RZ/G2L](https://www.renesas.com/en/products/microcontrollers-microprocessors/rz-mpus/rzg2l-general-purpose-mpu-dual-core-arm-cortex-a55-cpus-and-single-core-cortex-m33-cpu-3d-graphics-and) - [Install on a MediaTek Genio](install-on-mediatek): Install a pre-built testing image on a [MediaTek Genio](https://www.mediatek.com/products/iot/genio-iot) +## Image writing + +For generic devices, we recommend users try pre-built Ubuntu Core images on a Raspberry Pi or Intel NUC, as these range of devices are easy to use and widely accessible. + +- [Use Raspberry Pi imager](/tutorials/try-pre-built-images/use-raspberry-pi-imager): install a pre-built Ubuntu Core image on a Raspberry Pi +- [Use the dd command](/tutorials/try-pre-built-images/use-the-dd-command): write an Ubuntu Core reference image to internal storage + ```{toctree} :hidden: From 54b56350424d8b21bb658c9ab86f2389ae1b1a4b Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Thu, 17 Jul 2025 14:17:51 +0100 Subject: [PATCH 05/10] fixed new broken Ubuntu Core link. --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 0face926..87197ade 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -107,7 +107,7 @@ # TODO: If there's no such website, # remove the {{ product_page }} link from the page header template # (usually .sphinx/_templates/header.html; also, see README.rst). - "product_page": "https://ubuntu.com/core", + "product_page": "ubuntu.com/core", # Product tag image; the orange part of your logo, shown in the page header # # TODO: To add a tag image, uncomment and update as needed. From 0e02027aa01022304d89dd020615d0bde5d30368 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Fri, 18 Jul 2025 09:25:20 +0100 Subject: [PATCH 06/10] updated links --- docs/tutorials/index.md | 7 ++----- docs/tutorials/try-pre-built-images/index.md | 4 ++-- 2 files changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md index 5992efe3..442e1930 100644 --- a/docs/tutorials/index.md +++ b/docs/tutorials/index.md @@ -14,12 +14,9 @@ Ubuntu Core has been designed to facilitate the creation, deployment, and manag A step-by-step guide to building and testing your own image with your own selection of applications. -## Install Ubuntu Core +## Try Ubuntu Core -Pre-built test images are also available for Renesas GZ/G2l and MediaTek Genio devices, alongside x86-based PC-style hardware and ARM-based platforms. - - -. These testing images are ideal for exploration and experimentation but they're not intended for deployment or for use at scale. +These testing images are ideal for exploration and experimentation but they're not intended for deployment or for use at scale. * [Install and try a pre-built image](/tutorials/try-pre-built-images/index) diff --git a/docs/tutorials/try-pre-built-images/index.md b/docs/tutorials/try-pre-built-images/index.md index 2037b071..76db108a 100644 --- a/docs/tutorials/try-pre-built-images/index.md +++ b/docs/tutorials/try-pre-built-images/index.md @@ -18,8 +18,8 @@ You can try Ubuntu Core without any specific hardware from within a virtual mach Ubuntu Core runs on a large range of hardware, and pre-built images are available for amd64 and Raspberry Pi reference platforms. -- [Use Raspberry Pi imager](install-on-a-device/use-raspberry-pi-imager): install a pre-built Ubuntu Core image on a Raspberry Pi -- [Use the dd command](install-on-a-device/use-the-dd-command): write an Ubuntu Core reference image to internal storage +- [Use Raspberry Pi imager](use-raspberry-pi-imager): install a pre-built Ubuntu Core image on a Raspberry Pi +- [Use the dd command](use-the-dd-command): write an Ubuntu Core reference image to internal storage ```{toctree} From dd5eed9c6fc94b7a55eba8fe58efdb241da41693 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Fri, 18 Jul 2025 09:30:58 +0100 Subject: [PATCH 07/10] demark link --- .../container-deployment/deploy-docker-from-a-snap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/how-to-guides/container-deployment/deploy-docker-from-a-snap.md b/docs/how-to-guides/container-deployment/deploy-docker-from-a-snap.md index 9307ae91..0f9fd105 100644 --- a/docs/how-to-guides/container-deployment/deploy-docker-from-a-snap.md +++ b/docs/how-to-guides/container-deployment/deploy-docker-from-a-snap.md @@ -183,7 +183,7 @@ Verify that everything is working and setup correctly by looking into the follow - Docker containers: `docker ps` You should be able to access the RabbitMQ's management dashboard via a web browser. -By default, it is available at http://localhost:15672 (username/password: `guest`). +By default, it is available at `http://localhost:15672` (username/password: `guest`). ![RabbitMQ Management Dashboard|800x397](https://assets.ubuntu.com/v1/616d2ae4-deploy-docker-from-a-snap.png) From b31c1a6e7d811a80308f8e4f917835d879cd8016 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Fri, 18 Jul 2025 10:52:29 +0100 Subject: [PATCH 08/10] removed old discourse link --- docs/explanation/community-engagement.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/explanation/community-engagement.md b/docs/explanation/community-engagement.md index 45b7a41b..214488cd 100644 --- a/docs/explanation/community-engagement.md +++ b/docs/explanation/community-engagement.md @@ -47,8 +47,7 @@ Both documentation and engineering teams agree to shoulder responsibilities impl ## Get in touch -You can find the Ubuntu Core team on both the Ubuntu Discourse forum and the Snapcraft forum: -- https://discourse.ubuntu.com/c/ubuntu-core-docs +You can find the Ubuntu Core team on the Snapcraft forum: - https://forum.snapcraft.io/c/snapd For interactive discussions, the team can also be found on Matrix.org: From a5ffbbddff1953b8ace9490ef907bb4716354fdb Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Fri, 18 Jul 2025 11:02:47 +0100 Subject: [PATCH 09/10] links --- .../system-snaps/modem-manager/install-modem-manager.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/explanation/system-snaps/modem-manager/install-modem-manager.md b/docs/explanation/system-snaps/modem-manager/install-modem-manager.md index 1deb79e9..af026cad 100644 --- a/docs/explanation/system-snaps/modem-manager/install-modem-manager.md +++ b/docs/explanation/system-snaps/modem-manager/install-modem-manager.md @@ -22,7 +22,7 @@ Active: active (running) since Fri 2020-07-10 08:34:43 UTC; 2min 20s ago Main PI Tasks: 3 (limit: 569) CGroup: /system.slice/snap.modem-manager.modemmanager.service └─2047 /snap/modem-manager/414/usr/sbin/ModemManager --filter-policy=STRICT --log-level=INFO ``` -Now you have ModemManager successfully installed. In the next sections we will briefly explain how to use part of ModemManager's features, using *mmcli* command line interface to interact with the service. For a complete reference on what can be done with ModemManager, take a look at [ *mmcli* man page](https://www.freedesktop.org/software/ModemManager/man/latest/mmcli.8.html) and to [ModemManager's D-Bus interface](https://www.freedesktop.org/software/ModemManager/api/latest/). It is also possible to use *dbus-send* to directly access the D-Bus interface if desired. +Now you have ModemManager successfully installed. In the next sections we will briefly explain how to use part of ModemManager's features, using *mmcli* command line interface to interact with the service. For a complete reference on what can be done with ModemManager, take a look at [ *mmcli* man page](https://www.freedesktop.org/software/ModemManager/man/latest/mmcli.1.html) and to [ModemManager's D-Bus interface](https://www.freedesktop.org/software/ModemManager/api/latest/). It is also possible to use *dbus-send* to directly access the D-Bus interface if desired. Finally, note that to run both *mmcli* and *dbus-send* we need root permissions, so we use *sudo* with them. From a176e12d91f7c22d3aed60ada55861bee18a4ea4 Mon Sep 17 00:00:00 2001 From: Graham Morrison Date: Fri, 18 Jul 2025 11:03:42 +0100 Subject: [PATCH 10/10] fixed community link --- docs/explanation/community-engagement.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/explanation/community-engagement.md b/docs/explanation/community-engagement.md index 214488cd..58bacfd5 100644 --- a/docs/explanation/community-engagement.md +++ b/docs/explanation/community-engagement.md @@ -48,7 +48,7 @@ Both documentation and engineering teams agree to shoulder responsibilities impl ## Get in touch You can find the Ubuntu Core team on the Snapcraft forum: -- https://forum.snapcraft.io/c/snapd +- [https://forum.snapcraft.io/c/snapd/5](https://forum.snapcraft.io/c/snapd/5) For interactive discussions, the team can also be found on Matrix.org: - https://matrix.to/#/#documentation:ubuntu.com