CH-BUILDER2TAR(1)

📦 version 0.26, in ubuntu jammy

💖 CH-BUILDER2TAR(1) — the ch-builder2tar manual, bestie edition 💖

okay so. this is the manual page for ch-builder2tar, section 1 of the Charliecloud docs. it's giving "flatten a builder image into a tarball" energy and honestly? iconic. let's get into it 🫶

✨ NAME ✨

ch-builder2tar — flatten a builder image into a Charliecloud image tarball. that's the whole job. no notes. 💅

✨ SYNOPSIS ✨

$ ch-builder2tar [-b BUILDER] [--nocompress] IMAGE OUTDIR

✨ DESCRIPTION ✨

WARNING: this script is deprecated in favor of ch-convert. it will be removed in the next release. no cap, bestie — go use ch-convert instead. this one's on its way out. 💀

so what does it actually do? it flattens the builder image tagged IMAGE into a Charliecloud tarball, and drops that tarball in the directory OUTDIR. that's the tea. ☕

the builder-specified environment (think ENV statements and friends) gets placed in a file inside the tarball at $IMAGE/ch/environment, in a form that's suitable for ch-run --set-env. cute, right? 🎀

for the deets on how to specify the builder, go peek at ch-build(1).

additional arguments:

  • -b, --builder BUILDER — use the specified builder. if you don't give one, it uses $CH_BUILDER or the default. iykyk ✨
  • --nocompress — do not compress the tarball. raw dogging the tarball, i guess. 🙈
  • --help — print help and exit. the classic. 🫶
  • --version — print version and exit. also the classic. 🌸

✨ EXAMPLE ✨

$ ch-builder2tar hello /var/tmp
57M /var/tmp/hello.tar.gz
$ ls -lh /var/tmp
-rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz

look at that. 57M. slay. 🔥

✨ REPORTING BUGS ✨

if you got Charliecloud from your Linux distribution, use your distribution's bug reporting procedures. that's the vibe — go through the right channel, bestie. 🌈

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

and that's a wrap on this little page, bestie — this version is 0.26, dated 2022-01-30 10:06 UTC, and it's been a whole journey. go forth and flatten those builder images (or, like, use ch-convert). mwah 💋

📦 where this page comes from