Minishift Fedora ISO

This repository contains all the instructions and code to build a Live ISO based on Fedora which can be used by minishift as an alternative to the CentOS ISO.

• Building the Fedora ISO
  • On Fedora
    • Prerequisites
    • Building the ISO
  • On hosts other than Fedora (OS X, Windows, CentOS ...)
    • Prerequisites
    • Building the ISO
  • Manual release
• Further reading
• Community

Building the Fedora ISO

The following contains instructions on how to build the Fedora based ISO. If you are able to install livecd-tools directly on your machine, you can use the Fedora instructions.

If you don't have livecd-tools or using different linux distro other than Fedora, follow the hosts other than Fedora instructions.

On Fedora

Prerequisites

• Update your system before start and if there is kernel update then reboot your system to activate latest kernel.

  $ dnf update -y

• Install livecd-tools

  Note: We use to have docker installed on system to get selinux context, check bugzilla

  $ dnf install -y livecd-tools docker

Building the ISO

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

On hosts other than Fedora (macOS, Windows, CentOS ...)

Prerequisites

• Vagrant

• vagrant-sshfs

  $ vagrant plugin install vagrant-sshfs

Building the ISO

$ git clone https://github.com/minishift/minishift-fedora-iso.git
$ cd minishift-fedora-iso
$ vagrant up
$ vagrant ssh
$ cd <path to minishift-fedora-iso directory on the VM>/minishift-fedora-iso
$ make

Manual release

The manual release includes following steps:

• Assemble all the meaningful changes since the last release to create release notes.
• Bump the VERSION variable in the Makefile.
• Before you execute below command be sure to have a Github personal access token defined in your environment as GITHUB_ACCESS_TOKEN.

• Run following command to perform release:

  $ make release

Build ISO

Setup your build environment by following the instructions provided in Building the Fedora ISO section as per your preferred OS.

Note: Building ISO might require you to have Vagrant environment if you are not using host other than Fedora.

Run the tests

Once the ISO is built from above step, use following command to run tests:

$ make test

Note: If you are using the Vagrant environment, you need to exit from it and come back to host to run the above command.

This command will fetch the latest minishift binary and run the tests.

Further reading

Once you are able to build the ISO, you are most likely interested to modify the image itself. To do so you have to get familiar with pykickstart.

Community

You can reach the Minishift community by:

• Signing up to our mailing list

• Joining the #minishift channel on Freenode IRC