3.4.4. Building SIMP via Rake¶
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.
3.4.4.1. Getting Started¶
Warning
Please have your environment prepared as specified by 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!
3.4.4.2. Install Either Docker or VirtualBox¶
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.
3.4.4.3. Download the Appropriate EL ISO¶
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).
3.4.4.4. Required Environment Variables¶
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.yamlkey that you want to use. Defaults toSIMP_BEAKER_build_versionif not specified.
3.4.4.5. Build Using Docker¶
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]
3.4.4.6. Build Using VirtualBox¶
If you wish to build using VirtualBox simply run the following command:
$ rake beaker:suites[iso_vbox]