快速搭建指南 - oc cluster up

☞ 提示：此安装方式适合本地开发环境的搭建，生产环境请使用基于 Ansible 的高级安装方法。

概述

本地开发环境通常使用 OpenShift 官方推荐的 All-in-one 集群部署的方式。此种方式部署的环境中仅有一个本地节点 localhost ，相当于单节点集群。启动单节点集群的最简单的方式就是使用 oc cluster up 的方法。

更多信息请访问：
https://github.com/openshift/origin/blob/master/docs/cluster_up_down.md

先决条件

操作系统要求

无特别要求。所有的软件依赖在当下主流的的操作系统平台均可用。

软件依赖

• Docker v1.12.6 或更高版本
  
  下载地址：https://www.docker.com/community-edition#/download

• OpenShift CLI (oc) 客户端 v3.6.0 或更高版本
  
  下载地址：https://github.com/openshift/origin/releases

启动 OpenShift Origin

请确保 Docker 引擎处于正常运行中并且 oc 客户端所在的目录已在 PATH 系统环境变量中定义。

[root@gzhap ~] docker version
Client:
 Version:      17.09.1-ce
 API version:  1.32
 Go version:   go1.8.3
 Git commit:   19e2cf6
 Built:        Thu Dec  7 22:23:40 2017
 OS/Arch:      linux/amd64

Server:
 Version:      17.09.1-ce
 API version:  1.32 (minimum version 1.12)
 Go version:   go1.8.3
 Git commit:   19e2cf6
 Built:        Thu Dec  7 22:25:03 2017
 OS/Arch:      linux/amd64
 Experimental: false
[root@gzhap ~] oc version
oc v3.6.0+c4dd4cf
kubernetes v1.6.1+5115d708d7
features: Basic-Auth GSSAPI Kerberos SPNEGO

Server https://127.0.0.1:8443
openshift v3.6.0+c4dd4cf
kubernetes v1.6.1+5115d708d7

一切就绪之后，运行一下命令启动 OpenShift Origin:

[root@gzhap ~] oc cluster up
Starting OpenShift using openshift/origin:v3.6.0 ...
OpenShift server started.

The server is accessible via web console at:
    https://127.0.0.1:8443

[root@gzhap ~]

在浏览器打开 https://127.0.0.1:8443/console/ 若一切正常，您将会看到以下登陆界面：

openshift-origin-console.png

配置文件目录

OpenShift Origin 的数据集配置文件目录所在目录为 /var/lib/origin，里面包含若干子目录，具体含义如下：

目录名称	含义	备注
openshift.local.config	配置文件主目录	主配置文件在 master/master-config.yaml
openshift.local.pv	持久化数据卷所在目录	默认情况下，系统将会默认创建100个pv供本地开发使用
openshift.local.volumes	本地卷目录

保存本地配置

oc cluster up 命令每次启动默认会重置所有配置目录的信息，如果你之前对配置做过修改，那么下一次启动时需要指定 --use-existing-config=true

以下命令将 Origin 容器所产生的持久化数据全部映射到主机目录下：

$ oc cluster up \
    --use-existing-config=true \
    --host-config-dir='/u01/openshift/local/config' \
    --host-data-dir='/u01/openshift/local/data' \
    --host-pv-dir='/u01/openshift/local/pv' \
    --host-volumes-dir='/u01/openshift/local/volumes'