PAGE UNDER CONSTRUCTION
OpenShift Origin Quickstart
This Quickstart is geared toward System Adminitrators, or those who are setting up their own OpenShift Origin cluster. It will go over steps that are CentOS specific. For steps that are generic, we will be referencing the original OpenShift Origin documentation.
NOTE: THESE STEPS ARE A WORK IN PROGRESS. ANY HELP IN MAKING STEPS BETTER, AND/OR WORK IS APPRECIATED
1. Pre-Setup
Generic OpenShift Origin Prerequisites
Note1: This is setup for any of the quickstarts
Note2: Separate repos for each major release.
In addition to our main OpenShift Origin repository, that always has the latest version, we now maintain a seperate repo for each major release.
- Although not officially supported, if you can get upstream to fix a problem in one of the older releases, we can put that fix in these repos.
To use those releases, just replace centos-release-openshift-origin with centos-release-openshift-origin<release>
- Example: yum install centos-release-openshift-origin15
Install needed packages
- yum install centos-release-openshift-origin
- yum install wget git net-tools bind-utils iptables-services bridge-utils bash-completion origin-clients
Install and setup docker
- yum install docker
- #edit /etc/sysconfig/docker file and add --insecure-registry 172.30.0.0/16 to the OPTIONS parameter.
- sed -i '/OPTIONS=.*/c\OPTIONS="--selinux-enabled --insecure-registry 172.30.0.0/16"' \
- /etc/sysconfig/docker
- systemctl is-active docker
- systemctl enable docker
- systemctl start docker
2. Setup
Pick One, don't do all four
2.1. OC CLUSTER
Note1: This section is still being worked on.
- yum install centos-release-openshift-origin
- yum install origin-clients
- oc cluster up
2.2. Running in a Docker Container
Generic OpenShift Origin Instructions
- docker run -d --name "origin" \
- --privileged --pid=host --net=host \ -v /:/rootfs:ro -v /var/run:/var/run:rw -v /sys:/sys -v /var/lib/docker:/var/lib/docker:rw \ -v /var/lib/origin/openshift.local.volumes:/var/lib/origin/openshift.local.volumes \ registry.centos.org/openshift/origin start
2.3. Running from a rpm
Generic OpenShift Origin Instructions
- yum install origin
- openshift start
- export KUBECONFIG="$(pwd)"/openshift.local.config/master/admin.kubeconfig
- export CURL_CA_BUNDLE="$(pwd)"/openshift.local.config/master/ca.crt
- sudo chmod +r "$(pwd)"/openshift.local.config/master/admin.kubeconfig
2.4. Installer Installation Steps (Quickstart Deprecated: Origin 36 is the last release this will work)
Note: atomic-openshift-installer, which is a wrapper around openshift-ansible, sometimes called the quick installer, is being depricated. Openshift Ansible will still be around.
- yum install centos-release-openshift-origin
- yum --enablerepo=centos-openshift-origin-testing clean all
- yum --enablerepo=centos-openshift-origin-testing install atomic-openshift-utils
- atomic-openshift-installer install
answer questions as it steps you through an installation
prerequisites - https://docs.openshift.com/enterprise/3.2/install_config/install/prerequisites.html
3. Testing
Generic OpenShift Origin Documentation
3.1. Quick Test 1
- oc login
- Username: test
- Password: test
- oc new-project test
- oc new-app openshift/deployment-example
- oc status
- curl 172.30.126.164:8080 # (example v1) (Use URL that it gives you for svc/deployment-example)
- oc tag deployment-example:v2 deployment-example:latest
- curl 172.30.126.164:8080 # (example2 v2)
3.2. Quick Test 2
- oc login -u system:admin
- oc project default
- oadm registry --credentials=./openshift.local.config/master/openshift-registry.kubeconfig
- oc login -u test
- oc project test
oc new-app openshift/nodejs-010-centos7~https://github.com/openshift/nodejs-ex.git
- oc status
- curl 172.30.126.164:8080 # (RIGHT PLACE??)