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
|
'\" 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-debootstrap \- Create a basic Debian based container with debootstrap or mmdebstrap
.SH "SYNOPSIS"
.sp
\fBcontainer create \-s debootstrap\fR [\fIOPTIONS\fR] \fBcnt cr \-s debootstrap\fR [\fIOPTIONS\fR]
.sp
\fBcontainer create \-s mmdebstrap\fR [\fIOPTIONS\fR] \fBcnt cr \-s mmdebstrap\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.sp
The debootstrap container creation script uses debootstrap(8) or mmdebstrap(1) to create a Debian based container\&.
.sp
This script 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
.\}
apt cache of packages downloaded during debootstrap is cleaned
.RE
.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
.\}
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
\fB\-a, \-\-architecture=\fR\fB\fIARCHITECTURE\fR\fR
.RS 4
Specify the Debian architecture, defaults to the host systems architecture\&.
.RE
.PP
\fB\-d, \-\-distribution=\fR\fB\fIDISTRIBUTION\fR\fR
.RS 4
Specify the Debian distribution, defaults to stretch\&.
.RE
.PP
\fB\-m, \-\-mirror=\fR\fB\fIMIRROR\fR\fR
.RS 4
Specify the Debian mirror, defaults to
https://deb\&.debian\&.org/debian\&.
.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 using debootstrap:\fR
.RS 4
sudo container create \-s debootstrap \-n stretch\&.example\&.net
.RE
.PP
\fBCreate a Debian 9 (stretch) based container with different architecture as the host system using mmdebstrap:\fR
.RS 4
sudo container create \-s mmdebstrap \-n stretch\-i386\&.example\&.net \(em \-a i386
.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\&.
|
