anchor.diff:  :toc2:
   :sectanchors:
   
  -The OpenShift architecture builds upon the flexibility and scalability of https://docker.com/[Docker] and https://github.com/kubernetes/kubernetes[Kubernetes] to deliver a powerful new https://www.youtube.com/watch?v=aZ40GobvA1c[Platform-as-a-Service] system. This article explains how to set up a development environment and get involved with this latest version of OpenShift.  Kubernetes is included in this repo for ease of development, and the version we include is periodically updated.
  +The OpenShift architecture builds upon the flexibility and scalability of
  +https://docker.com/[Docker] and https://github.com/kubernetes/kubernetes[Kubernetes]
  +to deliver a powerful new https://www.youtube.com/watch?v=aZ40GobvA1c[Platform-as-a-Service]
  +system. This article explains how to set up a development environment and get
  +involved with this latest version of OpenShift.  Kubernetes is included in this
  +repo for ease of development, and the version we include is periodically updated.
   
   To get started you can either:
   
  
positive.code: +
  NOTE: Replace "linux/amd64" with the appropriate value for your platform/architecture.
  
  10.  Launch another terminal, change into the same directory you started OpenShift, and deploy the private docker registry within OpenShift with the following commands:
  
          $ sudo chmod +r openshift.local.config/master/admin.kubeconfig
          $ ./oadm registry -n default --config=openshift.local.config/master/admin.kubeconfig
  
  11.  If it is not there already, add the current directory to the $PATH, so you can leverage the OpenShift commands elsewhere.
  
  12.  You are now ready to edit the source, rebuild and restart OpenShift to test your changes.
  
  13.  NOTE:  to properly stop OpenShift and clean up, so that you can start fresh instance of OpenShift, execute:
  
          $ sudo pkill -x openshift
          $ docker ps | awk 'index($NF,"k8s_")==1 { print $1 }' | xargs -l -r docker stop
  
negative.code: 
  == Download from GitHub
  
  The OpenShift team periodically publishes binaries to GitHub on
  https://github.com/openshift/origin/releases[the Releases page].  These are
  Linux, Windows, or Mac OS X 64bit binaries (note that Mac and Windows are
  client only). You'll need Docker installed on your local system
  (see https://docs.docker.com/installation/[the installation page] if you've
  never installed Docker before).
  
  The tar file for each platform contains a single binary `openshift` which is
  the all-in-one OpenShift installation.
  
  * Use `sudo openshift start` to launch the server.  Root access is required to
    create services due to the need to modify IPTables.
    See issue: https://github.com/kubernetes/kubernetes/issues/1859.
  * Use `oc login <server> ...` to connect to an OpenShift server
  * Use `openshift help` to see more about the commands in the binary
  
  
  == OpenShift Development
  
  To get started, https://help.github.com/articles/fork-a-repo[fork] the
  https://github.com/openshift/origin[origin repo].
  
  === Develop locally on your host
  
  You can develop OpenShift 3 on Windows, Mac, or Linux, but you'll need Docker
  installed on Linux to actually launch containers.
  
  * For OpenShift 3 development, install the http://golang.org/[Go] programming
    language
  * To launch containers, install the https://docker.com/[Docker] platform
  
  Here's how to get set up:
  
  1. For Go, Git and optionally also Docker, follow the links below to get to
     installation information for these tools: +
  ** http://golang.org/doc/install[Installing Go]. Currently, OpenShift supports
     building using Go 1.7.x. Do NOT use $HOME/go for Go installation, save that
     for the Go workspace below.
  ** http://git-scm.com/book/en/v2/Getting-Started-Installing-Git[Installing Git]
  ** https://docs.docker.com/installation/[Installing Docker]
  +
  