summaryrefslogtreecommitdiff
path: root/vmdb/plugins/debootstrap.mdwn
blob: adef40cd39f7a8296ee1beb41a012d127fc7b1a8 (plain)
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
Step: debootstrap
-----------------------------------------------------------------------------

Create a directory tree with a basic Debian installation. This does
not include a boot loader.

Step keys:

* `debootstrap` — REQUIRED; value is the codename of the Debian
  release to install: `stretch`, `buster`, etc.

* `target` — REQUIRED; value is the tag for the root filesystem.

* `mirror` — REQUIRED; which Debian mirror to use

* `keyring` — OPTIONAL; which gpg keyring to use to verify the
  packages. This is useful when using a non-official Debian repository
  (e.g. Raspbian) as by default debootstrap will use the keys provided
  by the "debian-archive-keyring" package.

* `install_keyring` — OPTIONAL; if set to `yes`, the gpg keyring
  specified by the `keyring` key will be installed in the image for use when
  installing packages from non-official Debian repositories.

* `arch` — OPTIONAL; the foreign architecture to use.

* `variant` — OPTIONAL; the variant for debootstrap.

* `include` — OPTIONAL; a list of additional packages for
  debootstrap to install.

* `tls_ca_certs` — OPTIONAL; a list of paths to TLS Certificate
  Authority (CA) cert files to install in the image after the debootstrap
  process has completed. This allows the use of package repositories with
  HTTPS transports that use TLS certificates issued by private CAs.
  Note that the CA cert files being installed must have a `.crt` suffix
  in order to be used.

Example (in the .vmdb file):

    - debootstrap: buster
      target: root
      mirror: http://mirror.example.com/debian
      keyring: /etc/apt/trusted.gpg