Differences between revisions 70 and 71
Revision 70 as of 2018-03-11 19:01:28
Size: 4593
Comment:
Revision 71 as of 2018-06-24 12:23:53
Size: 4307
Comment: Mention that boxes checksum are committed in salsa
Deletions are marked like this. Additions are marked like this.
Line 64: Line 64:
==== GPG verification ==== ==== Checksums verification ====
Line 66: Line 66:
Signed checksums of the latest boxes are available at https://cloud.alioth.debian.org/vagrantboxes/ For VirtualBox, Checksums of the latest boxes are available inside the git repository at https://salsa.debian.org/cloud-team/vagrant-boxes/tree/master/packer-virtualbox-vagrant.

{{{#!wiki comment
Line 70: Line 72:
|| lxc || SHA256SUMS-lxc || SHA256SUMS-lxc.sig || Antonio Terceiro <terceiro - debian - org> ||
Line 72: Line 73:
After downloading the checksum and the signature files, you can verify the box authenticity by running `gpg --verify` against the signature file: }}}
Line 74: Line 75:
{{{
gpg --verify virtualbox-stretch.SHA256SUM.gpg
gpg: Signature made Sun Mar 11 18:34:56 2018 CET
gpg: using RSA key F6258DF2BFF9A73F5B1E15C306456DD791E95791
gpg: Good signature from "Emmanuel "Kasper" Kasprzyk <manu - debian - org>" [ultimate]
}}}
After downloading the checksums, you can verify the box authenticity by running vagrant with the `--checksum` option:

Introduction

This is a Work in Progress to build official Debian base boxes for Vagrant available in Vagrant Cloud

Report bugs

see https://app.vagrantup.com/debian/

Base Box details

Content

Standard Debian system, as created by the Debian Installer (all packages with priority required, important, standard), with the following Vagrant specific enhancements

  • vagrant unix user, setup according to Upstream recommendations

  • Speed improvements
    • disable DNS resolution in sshd (speed up logins)
    • use a 0s grub timeout to speed up booting
  • Disk size improvements:
    • fill the unused blocks of the file systems with zeroes to reduce disksize

Note that we don't install the Virtualbox guest additions as it would mean pulling package outside the main debian archive. Contrary to what the scary vagrant up message says, Vagrant and Virtualbox don't need the Virtualbox guest additions for shared folders and port forwarding.

Provisioners

The box does not include provisioners. You can install them at startup by adding in the Vagrant.configure block in your Vagrantfile

# puppet
config.vm.provision "shell", inline: "apt-get install --yes puppet"
# ansible does not need a client, but needs python-apt to install packages
config.vm.provision "shell", inline: "apt-get install --yes python-apt"

Shared folders

These boxes use vagrant rsync to share the current directory to the /vagrant directory inside the box. Syncing happens once when you fire vagrant up, if you want this to happen continuously in the background, start vagrant rsync-auto afterwards.

On Windows, we recommend to start Vagrant from a Cygwin or Msys environment, in which you have installed ssh and rsync.

Alternatively on all platforms, you can use the vagrant-vbguest plugin to build the Virtualbox guest extensions.

Build process

The boxes are currently built with Packer from the following git repository https://salsa.debian.org/cloud-team/vagrant-boxes and uploaded to Hashicorps's Vagrant cloud.

See Teams/Cloud/RebuildVagrantBaseBoxes to build the boxes yourself or extend them.

Versioning schema

We use the following versioning scheme: DEBIAN VERSION NUMBER + BOX VERSION Ex: 8.0.4 means we use the box uses the Debian release 8.0, the .4 means it is the fourth version based on this release that we uploaded to Vagrant Cloud

DFSG

The build process requires the contrib virtualbox package. The reason virtualbox is in contrib is the non DFSG compiler required for compiling the BIOS.

Checksums verification

For VirtualBox, Checksums of the latest boxes are available inside the git repository at https://salsa.debian.org/cloud-team/vagrant-boxes/tree/master/packer-virtualbox-vagrant.

After downloading the checksums, you can verify the box authenticity by running vagrant with the --checksum option:

 wget 
https://vagrantcloud.com/debian/boxes/stretch64/versions/9.2.0/providers/virtualbox.box

 vagrant box add --name debian/stretch64  --provider virtualbox 
--checksum 
3625435cbc6ace0a033f64e9495de65286d92d6560dfefe9239a3f9ab02f98a1 
--checksum-type sha256 virtualbox.box

Direct checksumming from app.vagrantup.com does not work, see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=878759

Debian account on app.vagrantup.com

Currently owned by EmmanuelKasper and AntonioTerceiro

Todo list

We use this trello board: https://trello.com/b/lVRI6QJt/offical-debian-vagrant-base-boxes

People Involved

EmmanuelKasper, Antonio Terceiro, Lucas Nussbaum