.\" Man page generated from reStructuredText.
.
.TH "CH-BUILD2DIR" "1" "2020-12-20 14:44 Coordinated Universal Time" "0.21" "Charliecloud"
.SH NAME
ch-build2dir \- Build a Charliecloud image from Dockerfile and unpack it into a directory
.
.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
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-build2dir \-t TAG [ARGS ...] CONTEXT OUTDIR
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Build a Docker image named \fBTAG\fP described by a Dockerfile (default
\fB$CONTEXT/Dockerfile\fP) and unpack it into \fBOUTDIR/TAG\fP\&. This is a
wrapper for \fBch\-build\fP, \fBch\-builder2tar\fP, and \fBch\-tar2dir\fP;
see also those man pages.
.sp
Arguments:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBARGS\fP
additional arguments passed to \fBch\-build\fP
.TP
.B \fBCONTEXT\fP
Docker context directory
.TP
.B \fBOUTDIR\fP
directory in which to place image directory (named \fBTAG\fP) and
temporary tarball
.TP
.B \fB\-t TAG\fP
name (tag) of Docker image to build
.TP
.B \fB\-\-help\fP
print help and exit
.TP
.B \fB\-\-version\fP
print version and exit
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLES
.sp
To build using \fB\&./Dockerfile\fP and create image directory
\fB/var/tmp/foo\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-build2dir \-t foo . /var/tmp
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Same as above, but build with a different Dockerfile:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ch\-build2dir \-t foo \-f ./Dockerfile.foo . /var/tmp
.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–2020, Triad National Security, LLC
.\" Generated by docutils manpage writer.
.