vms

Automated Oracle VM VirtualBox Ubuntu build using Packer.

Prerequisites

Note: use these or newer versions for building images.

• Packer 1.6.5
  • One of xorriso, mkisofs, hdiutil (normally found in macOS) or oscdimg (normally found in Windows as part of the Windows ADK) is required by Packer
• Oracle VM VirtualBox 6.1.14
• Oracle VM VirtualBox Guest Additions 6.1.14
• Oracle VM VirtualBox Extension Pack 6.1.14
• Vagrant 2.2.14

Install

pip install pipenv
pipenv shell

Build

• Run python -m lib.build --help for usage information
• The distro and release must be specified
• All variants are built automatically to build
• Add --vagrant to produce Vagrant boxes

python -m lib.build ubuntu 18.04 root base mininet

• Debug with python -m lib.build --debug --dry-run debian 10.6.10 root

Note: if root is specified it'll be the first thing to be built, otherwise a packer-{template}-{release}-root named VM must exist with a snapshot attached to it called Root.

Release

1. Install GitHub CLI
2. Create one or more personal access token with repo and/or admin:org scoped permissions
3. Run gh auth login and use one of the tokens
4. Run python -m lib.release after the build to output the gh command that creates the release
5. Use python -m lib.release --owner <OWNER> --repo <REPO> to specify which user/organization/repo to create the release at exactly

Vagrant

Vagrant boxes are released through Vagrant Cloud.

1. Login at https://app.vagrantup.com/ using an existing account
2. Create a token and copy/save it somewhere
3. Login with vagrant cloud auth login --username <username> --token <token>
4. Create a box if one doesn't exist yet, e.g. vagrant cloud box create <organization>/<box-name>
5. Publish an existing local box image, e.g. vagrant cloud publish <organization>/<box-name> <version> virtualbox <path-to-box>

Licenses

Copyright 2020-2021, Kohányi Róbert (<kohanyi.robert@gmail.com>)
Copyright 2012-2019, Chef Software, Inc. (<legal@chef.io>)
Copyright 2011-2012, Tim Dysinger (<tim@dysinger.net>)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.