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.
- Host machine must have at least 4GB memory
- Oracle VirtualBox installed on your host machine
- Vagrant (2.0 or above) installed on your host machine
- Vagrant plugin
vagrant-hostmanagermust be installed
Currently this project pre-configured and support 3 major versions of the OKD, which are
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:
OPENSHIFT_RELEASEOPENSHIFT_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 |
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 |
$ vagrant plugin install vagrant-hostmanager
$ vagrant up$ vagrant provision --provision-with master-key,node01-key,node02-key,fix-keysRun 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'Reconfigure the master node:
$ vagrant reload master --provision-with ansible-hostsThe above 3 steps have been grouped together as one script for you. To bring your cluster up, just use the following command:
$ ./oc-up.shIn browser of your host, open the following page: https://openshift.okd.lab:8443/ and you should see OpenShift Web Console login page. The default login account is admin/admin
Have fun with OKD and Vagrant :p