.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CH-PULL2TAR" "1" "2022-01-30 10:06 UTC" "0.26" "Charliecloud"
.SH NAME
ch-pull2tar \- Pull image from a Docker Hub and flatten into tarball
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-pull2tar IMAGE[:TAG] OUTDIR
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBWARNING:\fP
.INDENT 0.0
.INDENT 3.5
This script is deprecated in favor of \fBch\-convert\fP\&. It will
be removed in the next release.
.UNINDENT
.UNINDENT
.sp
Pull a Docker image named \fBIMAGE[:TAG]\fP from Docker Hub and flatten it
into a Charliecloud tarball in directory \fBOUTDIR\fP\&.
.sp
This runs the following command sequence: \fBdocker pull\fP,
\fBch\-builder2tar\fP but provides less flexibility than the individual
commands.
.sp
Sudo privileges are required for \fBdocker pull\fP\&.
.sp
Additional arguments:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fB\-\-help\fP
print help and exit
.TP
.B \fB\-\-version\fP
print version and exit
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ 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
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Same as above, except optional \fBTAG\fP is specified:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ 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
.ft P
.fi
.UNINDENT
.UNINDENT
.SH REPORTING BUGS
.sp
If Charliecloud was obtained from your Linux distribution, use your
distribution’s bug reporting procedures.
.sp
Otherwise, report bugs to: \fI\%https://github.com/hpc/charliecloud/issues\fP
.SH SEE ALSO
.sp
charliecloud(7)
.sp
Full documentation at: <\fI\%https://hpc.github.io/charliecloud\fP>
.SH COPYRIGHT
2014–2021, Triad National Security, LLC
.\" Generated by docutils manpage writer.
.