CH-BUILD2DIR(1)

📦 version 0.26, in ubuntu jammy

💖 CH-BUILD2DIR(1) — the Charliecloud girlies' guide 💖

okay bestie, so this is ch-build2dir, part of the Charliecloud manual set, and it's giving "build me a Docker image and then dump it in a folder" energy. let's get into it 💅

✨ NAME ✨

ch-build2dir — builds a Charliecloud image from a Dockerfile and unpacks it into a directory. yes, both. it's an overachiever 🎀

✨ SYNOPSIS ✨

$ ch-build2dir -t TAG [ARGS ...] CONTEXT OUTDIR

✨ DESCRIPTION ✨

WARNING: This script is deprecated in favor of ch-convert. It will be removed in the next release. fr fr, start migrating bestie, this one's on its way out 😭

So what does it actually do? It builds a Docker image named TAG described by a Dockerfile (which defaults to $CONTEXT/Dockerfile) and then unpacks that image into OUTDIR/TAG. It's basically a little wrapper that runs ch-build, ch-builder2tar, and ch-tar2dir for you, so go peek at those man pages too, iykyk 🦋

The arguments, babes:

  • ARGS — extra arguments that get passed straight along to ch-build. little handoff, no notes 👑
  • CONTEXT — the Docker context directory 🍓
  • OUTDIR — the directory where the image directory (named TAG) and the temporary tarball get placed 📁

And the flags:

  • -t TAG — the name (tag) of the Docker image you wanna build 🏷️
  • --help — prints help and dips out ✌️
  • --version — prints version and dips out ✌️

✨ EXAMPLES ✨

Wanna build using ./Dockerfile and create the image directory /var/tmp/foo? say less:

$ ch-build2dir -t foo . /var/tmp

Same vibe as above, but with a different Dockerfile. she's customizing 💅:

$ ch-build2dir -t foo -f ./Dockerfile.foo . /var/tmp

✨ REPORTING BUGS ✨

If you got Charliecloud from your Linux distribution, use your distribution's bug reporting procedures, periodt.

Otherwise, report bugs to: https://github.com/hpc/charliecloud/issues — the devs will literally thank you 🫶

✨ SEE ALSO ✨

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

2014–2021, Triad National Security, LLC 🌈

and that's a wrap bestie ✨ this was version 0.26, dated 2022-01-30 10:06 UTC — go forth, build, and slay 💖

📦 where this page comes from