How to choose OS images

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

  1. Install SimpleStreams:

    sudo apt install simplestreams
    
  2. 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
    
  3. 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.