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
|
'\" t
.\" Title: container-create-curl
.\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 20161112
.\" Manual: Open Infrastructure
.\" Source: container-tools
.\" Language: English
.\"
.TH "CONTAINER\-CREATE\-C" "1" "20161112" "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-curl \- Create a Debian based container by downloading a tarball over the network
.SH "SYNOPSIS"
.sp
\fBcontainer create \-s curl\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.sp
The curl container creation script uses curl(1) to download a tarball over the network to create a Debian based container\&.
.sp
Depending on the tarball this script otherwise creates a pure Debian system with three modificiations:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
hostname is set (container name) in /etc/hostname
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd machine\-id is generated in /etc/machine\-id
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
root password is set (user specified or 16 random characters)
.RE
.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
"\-\-clean*
.RS 4
Remove downloaded tarball after successfull container creation\&.
.RE
.PP
\fB\-\-image=\fR\fB\fIIMAGE\fR\fR
.RS 4
.RE
.PP
\fB\-\-server=\fR\fB\fISERVER\fR\fR
.RS 4
Specify the image server to download from, defaults to
https://files\&.open\-infrastructure\&.net/images/container\-tools/current\&.
.RE
.PP
\fB\-p, \-\-root\-password=\fR\fB\fIPASSWORD\fR\fR
.RS 4
Specify the root password, defaults to a random 16 character password\&.
.RE
.SH "EXAMPLES"
.PP
\fBCreate a Debian 9 (stretch) based container with same architecture as the host system:\fR
.RS 4
sudo container create \-s curl \-n stretch\&.example\&.net
.RE
.PP
\fBCreate a Debian 9 (stretch) based container with different architecture as the host system:\fR
.RS 4
sudo container create \-s curl \-n stretch\-i386\&.example\&.net \(em \-\-image debian\-stretch\-i386\&.tar\&.xz
.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
.SH "CONTAINER IMAGES"
.sp
container\-tools will download tarballs from a server expecting that the images are tarballs with either gzip, lzip, xz, or no compression\&. See container\-images\&.sh as an example on how to create your own container images\&.
.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>\&.
|
