cloud-localds(1)

✨ cloud-localds — the cloud-utils glow-up ✨

okay bestie, welcome to cloud-localds from the cloud-utils era 💖 this is the lil' helper that whips up a seed disk so cloud-init can do its whole thing on first boot. it's giving backstage pass energy 🎀

🦋 NAME 🦋

cloud-localds — bestie, it literally creates a disk for cloud-init to utilize nocloud 💅

🌸 SYNOPSIS 🌸

cloud-localds [options] output user-data [meta-data]

✨ DESCRIPTION ✨

so here's the vibe: cloud-localds creates a disk-image stuffed with user-data and/or meta-data for cloud-init(1). and when we say user-data can contain everything, we mean everything that cloud-init(1) supports. no cap, it's a full send 🔥

💅 OPTIONS 💅

• -d, --disk_format=DISKFORMAT — picks the disk format you wanna output. peep qemu-img(1) for the allowed disk formats (it's got the whole list). default is raw, periodt ✨
• -f, --filesystem=FORMAT — the filesystem format, bestie. allowed formats are vfat and iso. default is iso9660 🎀
• -h, --help — shows usage. the classic "help me pls" move 🫶
• -i, --interfaces — writes the network interfaces file into the metadata. slay 🌈
• -m, --dsmode=MODE — adds dsmode to the metadata. allowed values are local or net. and btw, the default over in cloud-init(1) is net 👑

🔥 EXAMPLES 🔥

this example right here creates a disk image with user-data which can be used to start a cloud image that supports cloud-init(1). iconic behaviour, honestly.

first, create some user-data:

cat > my-user-data <<EOF
password: passw0rd
chpasswd: { expire: False }
ssh_pwauth: True
EOF

then create the disk image which contains the user-data:

cloud-localds my-seed.img my-user-data

now boot the cloud-image:

qemu -net nic -net user -hda cloud-image.img -hdb my-seed.img -m 512

and just so we're clear — cloud-image.img is an image which supports cloud-init(1) during the boot process 💜

🧚 SEE ALSO 🧚

cloud-init(1), qemu-img(1), qemu(1)

💖 AUTHOR 💖

this manpage was written by Thomas Bechtold <thomasbechtold@jpberlin.de> for Debian systems (but may be used by others). permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation. giving credit where it's due, we love to see it 🫶

and that's the whole page, bestie — no notes, you ate 💅✨

cloud-utils · July 2013 · signing off, mwah 💋