Errors or typos? Topics missing? Hard to read? Let us know.
Switch image streams
- Candidate stream (UI): Go to Images > Change source > Custom, set URL to
http://images.maas.io/ephemeral-v3/candidate
, and Connect. - Stable stream (UI): Set URL to
http://images.maas.io/ephemeral-v3/stable
and Connect. - CLI:
BOOT_SOURCE_ID=$(maas $PROFILE boot-sources read | jq '.[] | select(.url | contains("images.maas.io/ephemeral-v3")) | .id')
maas $PROFILE boot-source update $BOOT_SOURCE_ID url=$STREAM_URL
Import standard images
- Default: MAAS auto-downloads Ubuntu LTS (amd64). To remove an image, uncheck and save.
- Host mirrors: Images > Change source > Custom, enter mirror URL, and Connect.
Import non-Ubuntu images
- Import non-Ubuntu images via Images > Other Images.
Sync images
- Sync hourly at region level, every 5 min at rack level.
List boot sources (CLI)
maas $PROFILE boot-sources read
Select boot sources (CLI)
maas $PROFILE boot-source-selections create $SOURCE_ID os="ubuntu" release="$SERIES" arches="$ARCH" subarches="$KERNEL" labels="*"
Get HWE kernels (CLI)
maas $PROFILE boot-source-selections create $SOURCE_ID os="ubuntu" release="xenial" arches="amd64" subarches="hwe-16.04" labels="*"
Import or list available images
- Import:
maas $PROFILE boot-resources import
- List available:
maas $PROFILE boot-resources read
Delete or edit boot sources
- Delete:
maas $PROFILE boot-source delete $SOURCE_ID
- Edit:
maas $PROFILE boot-source update $SOURCE_ID url=$URL keyring_filename=$KEYRING_FILE
Add a boot source
maas $PROFILE boot-sources create url=$URL keyring_filename=$KEYRING_FILE
Use a local image mirror
- Use the default keyring:
KEYRING_FILE=/usr/share/keyrings/ubuntu-cloudimage-keyring.gpg
Re-create default boot source
- Use these values:
URL=https://images.maas.io/ephemeral-v3/stable
KEYRING_FILE=/usr/share/keyrings/ubuntu-cloudimage-keyring.gpg
Create a local MAAS image mirror
-
Install SimpleStreams:
sudo apt install simplestreams
-
Set variables:
KEYRING_FILE=/usr/share/keyrings/ubuntu-cloudimage-keyring.gpg IMAGE_SRC=https://images.maas.io/ephemeral-v3/stable IMAGE_DIR=/var/www/html/maas/images/ephemeral-v3/stable
-
Mirror kernels:
sudo sstream-mirror --keyring=$KEYRING_FILE $IMAGE_SRC $IMAGE_DIR 'arch=amd64' 'release~(bionic|focal)' --max=1 --progress sudo sstream-mirror --keyring=$KEYRING_FILE $IMAGE_SRC $IMAGE_DIR 'os~(grub*|pxelinux)' --max=1 --progress
Notes
- Use
--dry-run
to preview before downloading. - Verify image availability at:
http://<myserver>/maas/images/ephemeral-v3/stable/
- Schedule regular updates using
cron
.
Last updated 25 days ago.