Minishift Boot2Docker ISO

This repository contains all required instructions and code to build an ISO based on Boot2Docker to use with minishift.

• Building the minishift-b2d ISO
  • Prerequisites
  • Building the ISO
  • Using the ISO
• Tests
• Releasing the minishift-b2d ISO
  • Prerequisites
  • Releasing the ISO
• CI Setup
• History
• Community

Building the minishift-b2d ISO

The minishift-b2d.iso is built via a Dockerfile.

Prerequisites

• A running docker daemon.

Building the ISO

$ git clone https://github.com/minishift/minishift-b2d-iso.git
$ cd minishift-b2d-iso
$ make

• The ISO should be present in minishift-b2d-iso/build directory after the successful run of make.

Using the ISO

• The ISO can be used with minishift with the help of --iso-url i.e. --iso-url=file:///$PATHTOISO.

Tests

Tests are written as Python scripts under tests directory and run through Avocado framework. Ensure you have Avocado installed by following Avocado instllation guide before running any tests.

Build ISO:

$ make

Run the tests:

$ make test

If you want to see the logs generated by test, run the test as:

$ SHOW_LOG=--show-job-log make test

Releasing the minishift-b2d ISO

Prerequisites

• Working installation of Go with GOPATH properly set.
• A running docker daemon.

Releasing the ISO

• Assemble all the meaningful changes since the last release to create release notes.
• Bump the VERSION variable in the Makefile.
• Make sure to have a Github personal access token defined in your environment as GITHUB_ACCESS_TOKEN.
• Run following command to release the ISO:

$ make release

CI Setup

minishift-b2d-iso uses CentOS CI as CI build server. It builds incoming pull requests and any push to master along with archiving the build artifacts. You can find the CentOS CI jenkins master job here and the pull request job here.

On a successful pull request build, the build artifacts can be found at artifacts.ci.centos.org/minishift/minishift-b2d-iso/pr/\<PR ID>.

On a successful master build, the build artifacts can be found at artifacts.ci.centos.org/minishift/minishift-b2d-iso/master/\<BUILD ID>.

For more information about CentOS CI, check out its Wiki to know more about CentOS CI.

History

• This repository is created by exracting the iso directory of Minishift project.

Community

You can reach the Minishift community by:

• Signing up to our mailing list

• Joining the #minishift channel on Freenode IRC