diff --git a/doc/cloud-init.md b/doc/cloud-init.md index 61fa906b4ce4..ef3bd521256f 100644 --- a/doc/cloud-init.md +++ b/doc/cloud-init.md @@ -28,10 +28,15 @@ The `cloud-init` actions are run only once on the first start of the instance. Rebooting the instance does not re-trigger the actions. ``` +(cloud-init-support)= ## `cloud-init` support in images -To use `cloud-init`, you must base your instance on an image that has `cloud-init` installed, which is the case for all images from the `ubuntu` and `ubuntu-daily` {ref}`image servers `. -However, images for Ubuntu releases prior to `20.04` require special handling to integrate properly with `cloud-init`, so that `lxc exec` works correctly with virtual machines that use those images. Refer to {ref}`vm-cloud-init-config`. +To use `cloud-init`, you must base your instance on an image that has `cloud-init` installed: + +* All images from the `ubuntu` and `ubuntu-daily` {ref}`image servers ` have `cloud-init` support. + However, images for Ubuntu releases prior to `20.04` require special handling to integrate properly with `cloud-init`, so that `lxc exec` works correctly with virtual machines that use those images. Refer to [VM `cloud-init`](vm-cloud-init-config). +* Images from the [`images` remote](https://images.lxd.canonical.com/) have `cloud-init`-enabled variants, which are usually bigger in size than the default variant. + The cloud variants use the `/cloud` suffix, for example, `images:alpine/edge/cloud`. ## Configuration options diff --git a/doc/external_resources.md b/doc/external_resources.md index 60e4131a0439..335355f110bb 100644 --- a/doc/external_resources.md +++ b/doc/external_resources.md @@ -18,4 +18,5 @@ :maxdepth: 1 Project repository +Image server ``` diff --git a/doc/howto/images_remote.md b/doc/howto/images_remote.md index 195c2b4704f3..9095bcc02dd9 100644 --- a/doc/howto/images_remote.md +++ b/doc/howto/images_remote.md @@ -68,6 +68,7 @@ For example: ubuntu:22.04 ubuntu-minimal:22.04 + images:alpine/edge local:ed7509d7e83f (images-remote-default)= diff --git a/doc/howto/instances_create.md b/doc/howto/instances_create.md index f4437a98cfd5..05f184707610 100644 --- a/doc/howto/instances_create.md +++ b/doc/howto/instances_create.md @@ -237,11 +237,7 @@ To create a container with this instance type, enter the following command: ``` ```` -The list of supported clouds and instance types can be found here: - -- [Amazon Web Services](https://raw.githubusercontent.com/canonical/lxd/main/meta/instance-types/aws.yaml) -- [Google Compute Engine](https://raw.githubusercontent.com/canonical/lxd/main/meta/instance-types/gce.yaml) -- [Microsoft Azure](https://raw.githubusercontent.com/canonical/lxd/main/meta/instance-types/azure.yaml) +The list of supported clouds and instance types can be found at [`images.lxd.canonical.com/meta/instance-types/`](https://images.lxd.canonical.com/meta/instance-types/). ### Create a VM that boots from an ISO diff --git a/doc/reference/index.md b/doc/reference/index.md index f2708941bc36..6aabc35c3221 100644 --- a/doc/reference/index.md +++ b/doc/reference/index.md @@ -97,4 +97,5 @@ However, advanced users might be interested in knowing what happens internally. :hidden: Project repository +Image server ``` diff --git a/doc/reference/remote_image_servers.md b/doc/reference/remote_image_servers.md index 3552ac0cc600..c53cb283f9bc 100644 --- a/doc/reference/remote_image_servers.md +++ b/doc/reference/remote_image_servers.md @@ -1,5 +1,5 @@ --- -discourse: 16647 +discourse: ubuntu:43824,16647 relatedlinks: https://www.youtube.com/watch?v=pM0EgUqj2a0 --- @@ -8,6 +8,17 @@ relatedlinks: https://www.youtube.com/watch?v=pM0EgUqj2a0 The [`lxc`](lxc.md) CLI command comes pre-configured with the following default remote image servers: +`images:` +: This server provides unofficial images for a variety of Linux distributions. + The images are built to be compact and minimal, and therefore the default image variants do not include `cloud-init`. + Where possible, `/cloud` variants that include `cloud-init` are provided. + See [`cloud-init` support in images](cloud-init-support). + + This server does not provide official Ubuntu images (for those, use the `ubuntu:` server). + It does, however, provide desktop variants of current Ubuntu releases. + + See [`images.lxd.canonical.com`](https://images.lxd.canonical.com) for an overview of available images. + `ubuntu:` : This server provides official stable Ubuntu images. All images are cloud images, which means that they include both `cloud-init` and the `lxd-agent`.