CH-PULL2TAR(1)

📦 version 0.26, in ubuntu jammy

💅 CH-PULL2TAR — okay bestie, let's talk

so this is the manual page for ch-pull2tar, which lives in the Charliecloud family (that's the ch- in the name, iykyk). it's a cute lil script, she's a one-trick pony, and we're gonna go through her whole vibe together. 🎀

✨ NAME ✨

ch-pull2tar — pull an image from a Docker Hub and flatten it into a tarball. that's it, that's the whole job. 🦋

🌈 SYNOPSIS 🌈

$ ch-pull2tar IMAGE[:TAG] OUTDIR

💖 DESCRIPTION 💖

WARNING: this script is deprecated in favor of ch-convert. it will be removed in the next release. bestie. i am so serious. she is on her way out, use ch-convert instead. 😭

okay so what does she do? she pulls a Docker image named IMAGE[:TAG] from Docker Hub and flattens it into a Charliecloud tarball, and she drops that tarball into the directory OUTDIR. no cap.

under the hood she's just running this command sequence for you: docker pull, then ch-builder2tar. but — and this is the important part — she gives you less flexibility than running those individual commands yourself. she's convenient, not powerful. 💅

Sudo privileges are required for docker pull. yes really. bring your password. 👑

Additional arguments, and there are exactly two:

  • --help — print help and exit. she explains herself and dips. ✨
  • --version — print version and exit. she tells you who she is and dips. ✨

🫶 EXAMPLES 🫶

basic girl summer, no tag specified:

$ ch-pull2tar 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

same as above, except the optional TAG is specified:

$ ch-pull2tar alpine:3.6
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

see how the tag just slides right into the filename? she's doing her best and honestly she's doing fine. 🌸

😭 REPORTING BUGS 😭

if you got Charliecloud from your Linux distribution, then please use your distribution's bug reporting procedures. that's their house, their rules. 🏠

otherwise, report bugs to: <https://github.com/hpc/charliecloud/issues> — go tell the devs, they wanna know fr fr. 💀

👑 SEE ALSO 👑

full documentation at: <https://hpc.github.io/charliecloud> — read it, it's giving academic but in a good way. ⭐

2014–2021, Triad National Security, LLC

and that's the whole page bestie!! this was Charliecloud version 0.26, dated 2022-01-30 10:06 UTC — like, she's vintage. she's iconic. she's deprecated. all three at once. go use ch-convert tho fr. mwah 💋💜

📦 where this page comes from