1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
'\" t
.\" Title: container-create-debootstrap
.\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 20170701
.\" Manual: Open Infrastructure
.\" Source: container-tools
.\" Language: English
.\"
.TH "CONTAINER\-CREATE\-D" "1" "20170701" "container\-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] \fBcontainer create \-s debian\fR [\fIOPTIONS\fR] \fBcontainer create \-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\&. (FIXME)
.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 "INTERACTIVE/NONINTERACTIVE"
.sp
FIXME
.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 stretch\&.example\&.net
.RE
.PP
\fBCreate a Progress Linux container:\fR
.RS 4
sudo container create \-s progress\-linux \-n cairon\-backports\&.example\&.net
.RE
.SH "FILES"
.sp
The following files are used:
.PP
\fB/etc/container\-tools/config\fR
.RS 4
Container configuration files\&.
.RE
.PP
\fB/usr/share/container\-tools/scripts\fR
.RS 4
Container creation scripts\&.
.RE
.PP
\fB/usr/share/doc/container\-tools\fR
.RS 4
Container documentation\&.
.RE
.PP
\fB/var/lib/machines\fR
.RS 4
Container directory\&.
.RE
.PP
\fB/var/cache/container\-tools\fR
.RS 4
Container cache directory\&.
.RE
.PP
\fB/tmp/container\-tools\fR
.RS 4
Container temporary directory\&.
.RE
.SH "SEE ALSO"
.sp
container\-tools(7), container(1)\&.
.SH "HOMEPAGE"
.sp
More information about container\-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
container\-tools was written by Daniel Baumann <daniel\&.baumann@open\-infrastructure\&.net>\&.
|
