https://github.com/minishift/minishift-b2d-iso

ISO based on Boot2Docker for Minishift
https://github.com/minishift/minishift-b2d-iso

boot2docker docker iso minishift

Last synced: 3 days ago
JSON representation

ISO based on Boot2Docker for Minishift

• Host: GitHub
• URL: https://github.com/minishift/minishift-b2d-iso
• Owner: minishift
• License: apache-2.0
• Created: 2016-12-30T05:48:12.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2018-09-21T12:38:27.000Z (about 6 years ago)
• Last Synced: 2024-10-29T17:56:27.710Z (15 days ago)
• Topics: boot2docker, docker, iso, minishift
• Language: Shell
• Homepage:
• Size: 56.6 KB
• Stars: 9
• Watchers: 7
• Forks: 13
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Minishift Boot2Docker ISO

This repository contains all required instructions and code to build an ISO based on [Boot2Docker](https://github.com/boot2docker/boot2docker) to use with [minishift](https://github.com/minishift/minishift).

----

- [Building the minishift-b2d ISO](#building-the-b2d-iso)

    - [Prerequisites](#prerequisites)

    - [Building the ISO](#building-the-iso)

    - [Using the ISO](#using-the-iso)

- [Tests](#tests)

- [Releasing the minishift-b2d ISO](#releasing-the-b2d-iso)

    - [Prerequisites](#release-prerequisites)

    - [Releasing the ISO](#releasing-the-iso)

- [CI Setup](#ci-setup)

- [History](#history)

- [Community](#community)

[![Build Status](https://ci.centos.org/buildStatus/icon?job=minishift-b2d-iso)](https://ci.centos.org/job/minishift-b2d-iso/)

----



## 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](https://github.com/minishift/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](avocado-framework.readthedocs.io) framework. Ensure you have _Avocado_ installed by following [Avocado instllation guide](http://avocado-framework.readthedocs.io/en/44.0/GetStartedGuide.html#installing-avocado) 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](https://en.wikipedia.org/wiki/Go_(programming_language)) 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](https://help.github.com/articles/creating-an-access-token-for-command-line-use) 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](https://ci.centos.org/) 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](https://ci.centos.org/job/minishift-b2d-iso/) and the pull request job [here](https://ci.centos.org/job/minishift-b2d-iso-pr/).

On a successful pull request build, the build artifacts can be found at

[artifacts.ci.centos.org/minishift/minishift-b2d-iso/pr/\](http://artifacts.ci.centos.org/minishift/minishift-b2d-iso/pr/).

On a successful master build, the build artifacts can be found at

[artifacts.ci.centos.org/minishift/minishift-b2d-iso/master/\](http://artifacts.ci.centos.org/minishift/minishift-b2d-iso/master/).

For more information about CentOS CI, check out its [Wiki](https://wiki.centos.org/QaWiki/CI) to

know more about CentOS CI.



## History

- This repository is created by exracting the `iso` directory of [Minishift](https://github.com/minishift/minishift) project.



## Community

You can reach the Minishift community by:

- Signing up to our [mailing list](https://lists.minishift.io/admin/lists/minishift.lists.minishift.io)

- Joining the `#minishift` channel on [Freenode IRC](https://freenode.net/)