Skip to content

Latest commit

 

History

History
131 lines (89 loc) · 4.06 KB

README.md

File metadata and controls

131 lines (89 loc) · 4.06 KB
Raw

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

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

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: