summaryrefslogtreecommitdiffstats
path: root/share/man/container-create-debconf.1
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2019-08-11 08:55:37 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2019-08-11 08:55:37 +0000
commit5a663817eb466038a3be8f73d0d5cc9e25727966 (patch)
tree28408e4b99a9f86dd13924232f9a6d55d35e975f /share/man/container-create-debconf.1
parentAdding upstream version 20190413. (diff)
downloadopen-infrastructure-compute-tools-6f8366b4b860f0a2b34158390f93f6e3a33c9c69.tar.xz
open-infrastructure-compute-tools-6f8366b4b860f0a2b34158390f93f6e3a33c9c69.zip
Adding upstream version 20190811.upstream/20190811
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'share/man/container-create-debconf.1')
-rw-r--r--share/man/container-create-debconf.1180
1 files changed, 0 insertions, 180 deletions
diff --git a/share/man/container-create-debconf.1 b/share/man/container-create-debconf.1
deleted file mode 100644
index cd15d09..0000000
--- a/share/man/container-create-debconf.1
+++ /dev/null
@@ -1,180 +0,0 @@
-'\" t
-.\" Title: container-create-debootstrap
-.\" Author: [see the "AUTHORS" section]
-.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\" Date: 20190304
-.\" Manual: Open Infrastructure
-.\" Source: compute-tools
-.\" Language: English
-.\"
-.TH "CONTAINER\-CREATE\-D" "1" "20190304" "compute\-tools" "Open Infrastructure"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-container-create-debconf \- Create an advanced Debian based container with debconf
-.SH "SYNOPSIS"
-.sp
-\fBcontainer create \-s debconf\fR [\fIOPTIONS\fR] \fBcnt cr \-s debconf\fR [\fIOPTIONS\fR]
-.sp
-\fBcontainer create \-s debian\fR [\fIOPTIONS\fR] \fBcnt cr \-s debian\fR [\fIOPTIONS\fR]
-.sp
-\fBcontainer create \-s progress\-linux\fR [\fIOPTIONS\fR] \fBcnt cr \-s progress\-linux\fR [\fIOPTIONS\fR]
-.SH "DESCRIPTION"
-.sp
-The debconf container creation script uses debconf(1) to automatically create a Debian based container\&.
-.SS "SCOPE"
-.sp
-Note that this container creation script can do a few things more than just automatically debootstrap based on a preseed file\&. It also allows you to set a root password, configure the network, install certain packages and execute hooks\&.
-.sp
-But: this is \fBnot\fR a replacement for a configuration management system (like ansible, puppet, etc\&.)\&. The intenion of this script is to create the initial container to that extend that a configuration managment system can take over\&.
-.sp
-As an analogy, think of debian\-installer: d\-i sets up your system to make it ready to boot and connect to the network\&. Everything after that is out of scope\&. Same goes for this script\&.
-.SS "FUNCTIONS"
-.sp
-This script performs the following configuration on top of a Debian based system:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-network
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-root password
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-apt repositories
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-\&...
-.RE
-.SS "MODES"
-.sp
-This container creation script can be used under two different names: debian and progress\-linux\&.
-.sp
-Alternative, calling it under the debconf name is equal to the debian mode\&.
-.SS "PRESEEDING"
-.sp
-Hierarchy of Preseed Files
-.sp
-The debconf script can be fully preseeded\&. Such preseed files can include one or more preseed files themselfs (currently, only one layer of includes is supported, no nested or recursive includes)\&.
-.sp
-The general rule of \fIthe later preseed file overwrites the earlier\fR applies\&. The debconf script reads the main preseed file (specified either on command line or by debconf selection/input dialog) after any included preseed files in there\&.
-.sp
-That means that debconf values after the include statement in the main preseed file can overwrite any values specified in the included preseed files\&.
-.SH "OPTIONS"
-.sp
-The following script options are available:
-.PP
-\fB\-n, \-\-name=\fR\fB\fINAME\fR\fR
-.RS 4
-Specify container name\&.
-.RE
-.PP
-\fB\-p, \-\-preseed\-file=\fR\fB\fIFILE\fR\fR
-.RS 4
-Specify the preseed file\&.
-.RE
-.SH "EXAMPLES"
-.PP
-\fBCreate a Debian based container:\fR
-.RS 4
-sudo container create \-s debian \-n debian\&.example\&.net
-.RE
-.PP
-\fBCreate a Progress Linux container:\fR
-.RS 4
-sudo container create \-s progress\-linux \-n progress\&.example\&.net
-.RE
-.SH "FILES"
-.sp
-The following files are used:
-.PP
-\fB/etc/open\-infrastructure/container/config\fR
-.RS 4
-Container configuration files\&.
-.RE
-.PP
-\fB/usr/share/open\-infrastructure/container/scripts\fR
-.RS 4
-Container creation scripts\&.
-.RE
-.PP
-\fB/usr/share/doc/compute\-tools\fR
-.RS 4
-Container documentation\&.
-.RE
-.PP
-\fB/var/lib/machines\fR
-.RS 4
-Container directory\&.
-.RE
-.PP
-\fB/var/cache/open\-infrastructure/container\fR
-.RS 4
-Container cache directory\&.
-.RE
-.PP
-\fB/tmp/compute\-tools\fR
-.RS 4
-Container temporary directory\&.
-.RE
-.SH "SEE ALSO"
-.sp
-compute\-tools(7), container(1)\&.
-.SH "HOMEPAGE"
-.sp
-More information about compute\-tools and the Open Infrastructure project can be found on the homepage at https://open\-infrastructure\&.net\&.
-.SH "CONTACT"
-.sp
-Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List <software@lists\&.open\-infrastructure\&.net>\&.
-.sp
-Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs\&.debian\&.org\&.
-.SH "AUTHORS"
-.sp
-compute\-tools were written by Daniel Baumann <daniel\&.baumann@open\-infrastructure\&.net> and others\&.