This packer template creates a basic Ubuntu 20.04 box with a predefined administrator user called vagrant, based on the bento boxes. The value of these images lies in the larger default size, a requirement given the amount of disk space consumed by our builds.
The scripts in this repository are date based. They will create and upload images with version number (current date).0. It is therefore necessary to run them on the same day.
You need the following software installed:
- Packer: install it via choco install packer on windows or via brew on MacOS
- Virtualbox: required for creating an image that runs on virtualbox
- VMWare Fusion/Workstation: required for running an image that runs on VMWare
Once these are installed, open a command line window, cd in this directory and either or both
build-virtualbox.sh build-vmware.sh
- Copy the vsphere-environment-do-not-add-sample file as vsphere-environment-do-not-add.
- Add your login details for vsphere server
- run the build-vsphere.sh script
In order to make an updated box available, you should upload it to the ccdc-vagrant-repo repository in artifactory To do that, you first need to find out your api key. Head to artifactory and log in. Sekect the ccdc-vagrant repository in the Set me up box on the main page. A dialog will pop up with a password box. Enter your password in the password box. The curl url in the Deploy section will be updated with your api key. It's the string appearing after X-JFrog-Art-Api:
Copy that key and run in a shell
export ARTIFACTORY_API_KEY='key'
After that, run one or both scripts called upload-virtualbox.sh and upload-vmware.sh
The documentation on the bento repository provides some insight on the process. This repository simply taylors what's there to our needs (larger hard drive, boxes for vmware and virtualbox).
You should have a working understanding of git submodules as they are used to pull the packer definitions from bento.
Why Packer? https://www.packer.io/intro/why.html
Packer documentation: https://www.packer.io/docs/index.html