The simp-core acceptance tests provide a method for building the SIMP ISOs directly from online resources and is the method that the SIMP team uses to ensure clean ISO builds.
Note
This method is slow but requires the least amount of modification to your build system.
Warning
This method will only work on simp-core
repositories that respond to rake build:auto
.
Warning
Please have your environment prepared as specified by gsg-environment_preparation
before continuing.
Note
You do not need mock
on your system if you are using this method.
Important
You must have Internet accessibility for this method to work!
This build method relies on Beaker
from Puppet, Inc. and can use either Docker
or VirtualBox
as the build back-end. The Docker method is faster but the VirtualBox method is far easier to debug if issues arise.
You must have a working Vagrant
installation to use this method.
Note
Make sure that you use the Vagrant installation directly from the Vagrant Homepage.
You will need to download the correct EL
ISO for the version of SIMP that you are trying to build. If you have doubts, check the build/release_mappings.yaml
file.
The ISOs should be downloaded into the spec/fixtures/ISO
directory (that you create).
If you simply run the rake
commands, the system will attempt to build all versions of SIMP that are coded into the tests.
If you want to build a specific version of SIMP, you must use the following environment variables.
- SIMP_BEAKER_build_version
The git branch or tag that you want to build
- SIMP_BEAKER_build_map
The
release_mapper.yaml
key that you want to use. Defaults toSIMP_BEAKER_build_version
if not specified.
The Docker
method is the faster of the two methods but can make debugging quite difficult if something goes wrong.
To build the suite via Docker run the following command:
$ rake beaker:suites[default]
If you wish to build using VirtualBox
simply run the following command:
$ rake beaker:suites[iso_vbox]
The ISOs from the rake
commands will be placed under a SIMP_ISO/rake_generated/<branch>/<timestamp>
directory structure.