CH-PULL2DIR(1)

📦 version 0.26, in ubuntu jammy

💖 ch-pull2dir(1) — the Charliecloud girlie's guide 💖

okay bestie, sit down, we're talking about ch-pull2dir, a manual page from the Charliecloud universe. she pulls images off Docker Hub and unpacks them into a directory. iconic behaviour, honestly. 🎀

✨ NAME ✨

ch-pull2dir — pull an image from Docker Hub and unpack it into a directory. that's it, that's the whole job. 💅

🌸 SYNOPSIS 🌸

$ ch-pull2dir IMAGE[:TAG] DIR

🦋 DESCRIPTION 🦋

WARNING: this script is deprecated in favor of ch-convert. it will be removed in the next release. no cap. 😭

so here's the vibe: you pull a Docker image named IMAGE[:TAG] from Docker Hub, and it gets extracted into a subdirectory of DIR. a temporary tarball gets stored in DIR too, like a little souvenir before it dips. 🍓

you need sudo privileges to run the docker pull command. yes, seriously, that's just how it is. 👑

under the hood it runs this exact command sequence: ch-pull2tar, ch-tar2dir. also, go read the warning in the documentation for ch-tar2dir — it's important, i'm not being dramatic, well, i'm a little dramatic but still go read it. 🌈

Additional arguments:

  • --help — print help and exit. the classic. 🫶
  • --version — print version and exit. also the classic. ⭐

🔥 EXAMPLES 🔥

okay so first one, no tag specified, she just defaults to latest:

$ ch-pull2dir alpine /var/tmp
Using default tag: latest
latest: Pulling from library/alpine
Digest: sha256:621c2f39f8133acb8e64023a94dbdf0d5ca81896102b9e57c0dc184cadaf5528
Status: Image is up to date for alpine:latest
-rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:52 /var/tmp/alpine.tar.gz
creating new image /var/tmp/alpine
/var/tmp/alpine unpacked ok
removed '/var/tmp/alpine.tar.gz'

and this one is the exact same thing except the optional TAG is specified:

$ ch-pull2dir alpine:3.6 /var/tmp
3.6: Pulling from library/alpine
Digest: sha256:cc24af836d1377e092ecb4e8f0a4324c3b1aa2b5295c2239edcc7bbc86a9cbc6
Status: Image is up to date for alpine:3.6
-rw-r--r--. 1 charlie charlie 2.1M Oct  5 19:54 /var/tmp/alpine:3.6.tar.gz
creating new image /var/tmp/alpine:3.6
/var/tmp/alpine:3.6 unpacked ok
removed '/var/tmp/alpine:3.6.tar.gz'

see how the tag rides along into the filename and the image name? slay. ✨

😭 REPORTING BUGS 😭

if you got Charliecloud from your Linux distribution, please use your distribution's bug reporting procedures. that's the polite way, bestie.

otherwise, report bugs to: https://github.com/hpc/charliecloud/issues — the devs are actually really nice, go tell them what happened. 💜

👑 SEE ALSO 👑

full documentation at: https://hpc.github.io/charliecloud 🌟

2014–2021, Triad National Security, LLC

and that's a wrap on Charliecloud 0.26, dated 2022-01-30 10:06 UTC. go forth and pull responsibly, my love. 💖✨🦋

📦 where this page comes from