You need to create a Linux OS machine to install OpenShift. The minimum
|x86_64 1 core||2 GB||20 GB||IPv4|
First you need to install CentOS 7.3, by select minimum setup. After you finish
the installation, check your IP address to make sure you have available IP to
use. The following example shows the IP address at eth0 is “192.168.122.45”
[root@openshift ~]# ip a
OpenShift need a hostname to provide the service. Use “hostnamectl set-hostname”
to set a hostname. And use “hostname” to confirm your setting. The following
example show the hostname is “openshift.example.com”
[root@openshift ~]# hostnamectl set-hostname openshift.example.com
Openshift use docker as a container engine. Install docker by following
[root@openshift ~]# yum install -y docker
After the installation is done, start the docker service and enable it.
[root@openshift ~]# systemctl start docker
Test under command to check if docker can fetch data from internet. The
following example show how to create a “hello-openshift” container. This
little app was a go program and will listen 8080 and 8888 port.
(Run command for the first time will take some time because no image is existed
locally, docker need to pull it from the internet.)
[root@openshift ~]# docker run -it openshift/hello-openshift
After the test, push “Ctrl+c” to stop this image.
There are several methods to install OpenShift. For better understand we will
download the binaries of OpenShift server and deploy it manually.
You can find the download link at Download OpenShift Origin. For now the latest version is v1.5.1-7b451fc-linux-64bit.tar.gz.
Download the file and untar it to /opt/
[root@openshift ~]# wget https://github.com/openshift/origin/releases/download/v1.5.1/openshift-origin-server-v1.5.1-7b451fc-linux-64bit.tar.gz
Add Openshift path to $PATH by add following text to the end of /etc/profile.
Run source command to make the configuration enable,
[root@openshift ~]# source /etc/profile
After this we can check if the shell can find the command of openshift. Try
following command to check the version. From the output we can see the version
of Openshift is 1.5.1, Kubernetes is 1.5.2, and etcd is 3.1.0.
[root@openshift ~]# openshift version
Just type “openshift start” to start openshift. There will be a lot of logs
output in the terminal. OpenShift will started when the logs output is stopped.
[root@openshift ~]# openshift start
warning message of security and you will see the login page. Input username
and password by “dev” to login.
Click “New Project”
For the first test project, input the Name, Display Name and Description and click “Create”.
At the next screen, click “Deploy Image” and select “Image Name”. Input the
image name as “openshift/hello-openshift” and click the “find” icon at right to
After a while(depends on your network speed), the image will be downloaded,
click “Create” at the end of the page to create a pod.
OpenShift will start to deploy the pod, at first you will see a gray circle with a
number “1” in it. When the deployment is done, the circle will turn to blue,
it mean the pod is ready to use.
Click the circle to see the detail information of your pods. You can find an “IP”
is attached to the pod. Following example shows the IP address of the pod is “172.17.0.3”.
Back to the OpenShift server and run under command to check the hello-openshift container.
The hello-openshift service will return a string “Hello OpenShift!” to each
request from the 8080 or 8888 port.
[root@openshift ~]# curl 172.17.0.3:8080
Above is a simple test of how to install Openshift and create a project/pod.
The IP will not be accessible outside the OpenShift server because it’s only a
local IP address. To deploy a real useful pod and provide it, you need to do
more settings. I will update it in the further. #TODO