CH-BUILDER2SQUASH(1)

📦 version 0.26, in ubuntu jammy

✨ NAME ✨

ch-builder2squash — bestie, this flattens a builder image into a Charliecloud SquashFS file 💅

🌸 SYNOPSIS 🌸

$ ch-builder2squash [-b BUILDER] IMAGE OUTDIR [ARGS ...]

💖 DESCRIPTION 💖

WARNING: okay so this script is deprecated in favor of ch-convert. She's getting removed in the next release. No cap. Enjoy her while she's here 🥲

She flattens the builder image tagged IMAGE into a SquashFS file in OUTDIR. It's giving very "squish it down and make it cute" energy 🫶

Lowkey she's just a wrapper for ch-builder2tar --nocompress and ch-tar2sqfs. All the intermediate files and directories? Gone. Removed. Not invited to the afterparty 💀

Heads up bestie: sudo privileges are required to run docker export. Like, actual root. Not a vibe you can skip 🚨

Any optional ARGS you pass get handed off to mksquashfs unchanged — no edits, no notes, she's a courier fr fr 🧚

Additional arguments

  • --help — prints the help and dips out. That's it, that's the whole thing 🌈
  • --version — prints the version and exits. Iconic behavior honestly ⭐

🔥 EXAMPLE 🔥

$ docker image list | fgrep debian
REPOSITORY   TAG       IMAGE ID       CREATED      SIZE
debian       stretch   2d337f242f07   3 weeks ago  101MB
$ ch-builder2squash debian /var/tmp
Parallel mksquashfs: Using 6 processors
Creating 4.0 filesystem on /var/tmp/debian.sqfs, block size 131072.
[...]
squashed /var/tmp/debian.sqfs OK
$ ls -lh /var/tmp/debian*
-rw-r--r-- 1 charlie charlie 41M Apr 23 14:37 debian.sqfs

Look at her go 🎀 from a whole docker image down to one lil debian.sqfs, 41M, and mksquashfs said "squashed ... OK" which is basically a compliment 💖

😭 REPORTING BUGS 😭

If you got Charliecloud from your Linux distribution, please use your distribution's own bug reporting procedures. They're the ones who packaged it, they know the lore 🙏

Otherwise, report bugs to: https://github.com/hpc/charliecloud/issues

🦋 SEE ALSO 🦋

Full documentation at: https://hpc.github.io/charliecloud

2014–2021, Triad National Security, LLC

That's the whole page, bestie — Charliecloud manual, version 0.26, dated 2022-01-30 10:06 UTC. Go squash something 💅✨

📦 where this page comes from