NAME¶

bootstrap-vz - program is creating Debian images to be run in cloud environments like Amazons EC2, OpenStack, Google Cloud Compute and other which are sharing API with those

SYNOPSIS¶

bootstrap-vz [options] MANIFEST

DESCRIPTION¶

bootstrap-vz is written in python which can be fairly easily customised if needed. Whole configuration for the final image is provided by json manifest [MANIFEST]. Manifest available options are explained below in MANIFEST section, if there is information which is lacking please file a bug against bootstrap-vz package (patches always welcome). bootstrap-vz must be run from within AWS instance to create Debian image. Default user to log into created image is: root

[OPTIONS]¶

--log path

Log to given directory [default: /var/log/bootstrap-vz].

 

If <path> is " - " file logging will be disabled.

 

--pause-on-error

Pause on error, before rollback

 

--dry-run

Don't actually run the tasks

 

--debug

Print debugging information

 

-h, --help

show this help

[MANIFEST]¶

Manifest is a json file providing final image specification, standard json rules apply to it and the following fields should or may be used (depending on final image type). Below are describe specific fields and fields within sections, all should be in strict json format put into manifest file. provider - [kvm|ec2|gce|virtualbox|azure] targeted platform where final image produced by bootstrap-vz is going to be used virtualization - [pvm|virtio|ide] ]type of vitalization which is going to be used to run final image bootstrapper image system (OS details) volume (virtual HDD setup) plugins (plugins available, for specific options for each plugin please look into individual plugin documentation) credentials (AWS specific entries)

MANIFEST - example¶

{
"provider": "ec2",
"virtualization": "pvm",
"credentials": {
"access-key" : null,
"secret-key" : null,
"certificate": null,
"private-key": null,
"user-id" : null
},
"bootstrapper": {
"mount_dir": "/target",
"mirror" : "http://http.debian.net/debian"
},
"image": {
"name" : "debian-{release}-{architecture}-{virtualization}-{%Y}{%m}{%d}",
"description": "Debian {release} {architecture} AMI ({virtualization})"
"bucket" : ""
},
"system": {
"release" : "wheezy",
"architecture": "amd64",
"timezone" : "UTC",
"locale" : "en_US",
"charmap" : "UTF-8"
},
"volume": {
"backing" : "s3",
"filesystem": "ext4",
"size" : 1024
},
"plugins": {
"admin_user": {
"enabled" : true,
"username": "admin"
},
"prebootstrapped": {
"enabled": false,
"image" : null
}
} } Example manifests can be found in /usr/share/doc/bootstrap-vz/examples/manifests more manifests specific information can be found in bootstrap-vz(3) or online docs at http://bootstrap-vz.readthedocs.org/en/master/

AUTHOR¶

Marcin Kulisz <debian@kulisz.net>

SEE ALSO¶

debootstrap(1), bootstrap-vz(3),