ATTENTION: This is the last Vagrant image in the "thesteve0" namespace. Moving forward all images will be in openshift/origin-all-in-one. BE READY, there is a new release coming soon!

 

Welcome to the all-in-one VM for OpenShift Origin , the FOSS PaaS from Red Hat. On this page you will find links to download:

 

  • A Vagrant VirtualBox VM
  • OpenShift client tools (oc) that match the release
  • A document to help you run through some of the basic steps to exercise this image

 

This image is based off of OpenShift Origin and is a fully functioning OpenShift instance with an integrated Docker registry. The intent of this project is to allow Web developers and other interested parties to run OpenShift V3 on their own computer. Given the way it is configured, the VM will appear to your local machine as if it was running somewhere off the machine.

 

The OpenShift Master, Node, Docker Registry, Metrics, Logging, Cockpit, and other pieces are running in one VM. Given it's focus on application developers, it should NOT be used in production. While the Vagrantfile only specifies 4 gigs of RAM, you can edit the file to increase or decrease this setting depending on how many containers you want to run in your instance.

 

WARNING: We wanted to allow developers to use any Docker image they want, which required us turning off some security in OpenShift. By default, OpenShift will not allow a container to run as root or even a non-random container assigned userid. Most Docker images in the Dockerhub do not follow this best practice and instead run as root. As a double negative, a large majority of Dockerhub images are not patched for well known vulnerabilities. Therefore, please use images from Dockerhub with caution. We think some of the risk is mitigated because you are running OpenShift in a VM, but still - be careful which Docker images you run.

 

NOTE: As this is based off the Origin project and not the commercial OpenShift Enterprise product, support is limited to community effort.

 

Install instructions
After you have installed Vagrant and VirtualBox, please:
Easiest instructions

  1. Go to an empty directory
  2. In the directory, at the command line, run
    $ vagrant init thesteve0/openshift-origin
  3. Optional You can edit the generated Vagrantfile to give your machine more resources
  4. Then run
    $ vagrant up
A bit more involved
  1. Download the Vagrantfile linked below and place it where you want Vagrant to "run"
  2. In the directory, at the command line, run
    $ vagrant up
The Vagrantfile has the address in Atlas for the Origin box and will download the box for you.

 

Updating previous versions

  1. Go to the directory where you previously ran
    $ vagrant up
  2. Run the following command
    $ vagrant box update --box thesteve0/openshift-origin
  3. You need to destroy and create the environment again
  4. $ vagrant destroy --force 
  5. $ vagrant up --provider=virtualbox 

 

Uninstall
To remove a previous installation please do the following commands:

  1. Change to the directory with your Vagrantfile
  2. $ vagrant halt
  3. $ vagrant destroy --force
  4. $ vagrant box remove --force openshift3 {or openshift3-bootstrap}
  5. Fire up VirtualBox to make sure the VM is really deleted. If not then delete it and all the files
  6. Follow the normal installation instructions

Downloads

Required files:

  • Vagrant (may also be offered in your distro) - We have tested with 1.7.2, 1.7.4
  • VirtualBox (again, may be offered in your distro) - We have tested with 4.3.30, 5.0.4. We would love to get feedback on newer versions.

If you want to download the Vagrantfile separately here is a link for it.

  • Vagrantfile right click and save but be sure to remove the .txt ending. You will do 'vagrant up' in the same directory as this file
  •  

    Client tools:

    Docs:

    Feedback

    Please send any and all feedback to TheSteve0, but please note this is not an "officially supported" product.

     

    You can also come chat about it in IRC at FreeNode, #openshift channel with thesteve0