Skip to content

eliu/openshift-vagrant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8696a1a · Aug 5, 2019

History

29 Commits
Dec 27, 2017
Dec 15, 2017
Dec 15, 2017
Jul 28, 2019
Jun 27, 2019
Jul 28, 2019
Mar 4, 2019
Jun 27, 2019
Apr 17, 2019
Jul 28, 2019
Aug 5, 2019

Repository files navigation

OpenShift Vagrant | 中文

Licensed under Apache License version 2.0

☞ Notice

This project will be at maintainance stage and the OKD version support remains on RELEASE-3.11. It's been a while that openshift isn't a part of my work life and I have no time to maintain compatibility with the next openshift releases.

Any contributions are warmly welcomed at any time! I hope the project can make your life easy for a cup of coffee.

Overview

The OpenShift Vagrant project aims to make it easy to bring up a real OKD cluster by provisioning pre-configured Vagrantfile of several major releases of OKD on your local machine.

Prerequisites

  • Host machine must have at least 8GB memory (16GB for OKD 3.11)
  • Oracle VirtualBox installed on your host machine
  • Vagrant (2.0 or above) installed on your host machine
  • Vagrant plugin vagrant-hostmanager must be installed

OKD Version Support

Currently this project pre-configured and support the following major versions of the OKD:

But, it's very easy to customize the respected ansible hosts file in order to support other incoming major versions.

The Vagrantfile uses Origin 3.11 and openshift-ansible release-3.11 branch by default. Feel free to adjust your versions by updating the following 2 variables in Vagrantfile:

  1. OPENSHIFT_RELEASE
  2. OPENSHIFT_ANSIBLE_BRANCH

The following table lists the corresponding version relationships between Origin and openshift-ansible:

OKD version openshift-ansible branch
3.11.x release-3.11
3.10.x release-3.10
3.9.x release-3.9
3.7.x release-3.7
3.6.x release-3.6

Getting Started

After adjusting your expected version information, now it's time to bring your cluster up and running.

This Vagrantfile will create 3 VMs in VirtualBox and the network base will be specified by variable NETWORK_BASE.

Checkout the table below for more details:

VM Node Private IP Roles
master #{NETWORK_BASE}.101 node, master, etcd
node01 #{NETWORK_BASE}.102 node
node02 #{NETWORK_BASE}.103 node

Bring Vagrant Up

$ vagrant up

Provisioning Private Keys

$ vagrant provision --provision-with master-key,node01-key,node02-key

Install Origin Cluster Using Ansible

Run the following command if you would like to install origin previous to release-3.8:

$ vagrant ssh master -c 'ansible-playbook /home/vagrant/openshift-ansible/playbooks/byo/config.yml'

Run the following command for origin 3.8 or above:

vagrant ssh master \
        -c 'ansible-playbook /home/vagrant/openshift-ansible/playbooks/prerequisites.yml &&
            ansible-playbook /home/vagrant/openshift-ansible/playbooks/deploy_cluster.yml'

oc-up.sh

The above 3 steps have been grouped together as one script for you. To bring your cluster up, just use the following command:

$ ./oc-up.sh

Open Web Console

In browser of your host, open the following page: https://master.example.com:8443/ and you should see OpenShift Web Console login page. The default login account is admin/handhand

Have fun with OKD and Vagrant :p

About

Bring up a real OKD cluster on your local machine using Vagrant and VirtualBox

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages