OpenShift

OpenShift的client工具oc功能非常强大，几乎能实现所有的操作，它的每一个子命令都能实现非常多的功能。其中有个容易被忽视却很强大的子命令oc set可以实现对资源很多额外的配置，包括有环境变量、资源限制、持久化卷挂载、健康检查等等。
下面是oc set的帮助详情。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[root@master ~]# oc set
Configure application resources
Usage:
  oc set COMMAND [flags]

Replication controllers, deployments, and daemon sets:
  env             Update environment variables on a pod template
  resources       Update resource requests/limits on objects with pod templates
  volumes         Update volumes on a pod template
  probe           Update a probe on a pod template
  deployment-hook Update a deployment hook on a deployment config
  image           Update image of a pod template

Manage secrets:
  build-secret    Update a build secret on a build config

Manage application flows:
  image-lookup    Change how images are resolved when deploying applications
  triggers        Update the triggers on one or more objects
  build-hook      Update a build hook on a build config

Control load balancing:
  route-backends  Update the backends for a route

Use "oc set <command> --help" for more information about a given command.
Use "oc options" for a list of global command-line options (applies to all commands).

环境变量 oc set env

  1. 列出sample dc设置的环境变量
    1
    $ oc set env dc/sample --list  # 列出sample dc设置的环境变量
  2. 为sample dc设置环境变量NAME=value
    1
    $ oc set env dc/sample NAME=value # 为sample dc设置环境变量NAME=value
  3. 从secret mysecret中向sample dc导入环境变量
    1
    $ oc set env --from=secret/mysecret dc/sample #从secret mysecret中向sample dc导入环境变量
  4. 从configmap myconfigmap中筛选出前缀为MYSQL_的变量向sample dc中导入为环境变量
    1
    $ oc set env --from=configmap/myconfigmap --prefix=MYSQL_ dc/sample #从configmap myconfigmap中筛选出前缀为MYSQL_的变量向sample dc中导入为环境变量
  5. 删除sample dc中的名为NAME的环境变量
    1
    $ oc set env dc/sample NAME- #删除sample dc中的名为NAME的环境变量

资源限制 oc set resources

  1. 为dc/sample中的容器设置内存限制
    1
    $ oc set resources dc/sample --limits=memory=2Gi --requests=memory=1Gi
  2. 给sample dc中的所有容器设置资源cpu和memory限制
    1
    $ oc set resources dc/sample --limits=cpu=200m,memory=2Gi --requests=cpu=100m,memory=1Gi #给sample dc中的所有容器设置资源cpu和memory限制
  3. 给sample dc中的nginx容器设置资源cpu和memory限制
    1
    $ oc set resources dc/sample -c=nginx --limits=cpu=200m,memory=2Gi --requests=cpu=100m,memory=1Gi #给sample dc中的nginx容器设置资源cpu和memory限制
  4. 删除sample dc资源限制配置
    1
    $ oc set resources dc/sample --limits=cpu=0,memory=0 --requests=cpu=0,memory=0 #删除资源限制配置
  5. 不执行更新，只显示修改的配置
    1
    $ oc set resources dc/sample --limits=cpu=200m,memory=512Mi -o yaml #不执行更新，只显示修改的配置

挂载点 oc set volumes

  1. 查看sample dc的挂载点
    1
    $ oc set volumes dc/sample
  2. 查看当前项目下的所有dc的挂载点
    1
    $ oc set volumes dc --all
  3. 给sample dc创建一个挂载点/data，挂载emptyDir
    1
    $ oc set volumes dc/sample --add --mount-path=/data
  4. 使用一个现有的名为pvc1的pvc挂载到名为v1的挂载点
    1
    $ oc set volumes dc/sample --add --name=v1 -t pvc --claim-name=pvc1 --overwrite
  5. 删除sample dc中名为v1的挂载点
    1
    $ oc set volumes dc/sample --remove --name=v1
  6. 新建一个pvc挂载到sample dc中名为v1的挂载点
    1
    $ oc set volumes dc/sample --add --name=v1 -t pvc --claim-size=1G --overwrite
  7. 更改名为v1的挂载点对应在sample dc中的目录为/data2
    1
    $ oc set volumes dc/sample --add --name=v1 -m /data2 --overwrite
  8. 删除sample dc中的nginx容器中名为v1的挂载点
    1
    $ oc set volumes dc/sample --remove --name=v1 --containers=nginx
  9. 将configmap中的nginx.conf配置挂载到/data/nginx.config文件中
    1
    $ oc set volumes dc/sample --add --name=v1 --mount-path=/data/nginx.conf --type=configmap --configmap-name=nginx --sub-path=nginx.conf
    另外还有一些常用的参数
    –claim-name：指定pvc的名字
    –claim-class：指定pvc使用的StorageClass名
    –claim-mode：指定pvc访问类型，默认为ReadWriteOnce(rwo)，另外还有ReadWriteMany(rwm)和ReadOnlyMany(rom)
    –default-mode：挂载目录的权限，默认为0644，必须在0000和0777之间取值
    –configmap-name：挂载到挂载点的configmap名，必须设置挂载类型为configmap
    –secret-name：挂载到挂载点的secret名，必须设置挂载类型为secret
    –sub-path：只挂载指定的子目录
    –path：本地主机路径，必须设置挂载类型为hostPath
    –type：挂载类型，emptyDir，hostPath，secret，configmap

健康检查 oc set probe

  1. 给sample dc添加liveness检查shell
    1
    $ oc set probe dc/sample --liveness --failure-threshold 3 --initial-delay-seconds 40 -- echo ok
  2. 给sample dc添加readiness检查HTTP
    1
    $ oc set probe dc/sample --readiness --failure-threshold 3 --initial-delay-seconds 20 --get-url=http://:9000/about
  3. 给sample dc添加readiness检查TCP
    1
    $ oc set probe dc/sample --readiness --open-tcp=3306
  4. 设置readiness的初始检查延时时间30s，超时时间为3s
    1
    $ oc set probe dc/sample --readiness --initial-delay-seconds=30 --timeout=3
  5. 删除rediness和liveness检查
    1
    $ oc set probe dc/sample --remove --readiness --liveness
    另外还有一些常用的参数
    –period-seconds：默认为10，两次检查间隔时长，单位为s
    –success-threshold：默认为1，检查成功次数达到1次，才会触发成功处理操作
    –failure-threshold：默认为3，检查失败次数达到3次，才会触发失败处理操作

设置Deploymentconfig钩子 oc set deployment-hook

  1. 为sample dc中的strategy设置pre钩子
    1
    $ oc set deployment-hook dc/sample --container=sample --pre -v data -- /var/lib/migrate-db.sh
  2. 为sample dc中的strategy设置mid钩子
    1
    $ oc set deployment-hook dc/sample --mid -v data -e VAR1=value1 -e VAR2=value2 -- /var/lib/prepare-deploy.sh
  3. 删除sample dc的pre、mid及post的钩子
    1
    $ oc set deployment-hook dc/sample --remove --pre --mid --post

更新镜像 oc set image

  1. 为sample dc中的容器sample1设置镜像sample1:v2，为容器sampel2设置镜像sample2:v2
    1
    $   oc set image dc/sample sample1=sample1:v2 sample2=sample2:v2
  2. 为sample dc中的容器app设置镜像为imagestream tag sample/ruby:2.3
    1
    $   oc set image dc/sample app=sample/ruby:2.3 --source=imagestreamtag
  3. 为所有dc中的容器sample设置镜像为sample:v2
    1
    $   oc set image dc sample=sample:v2 --all

设置BuildConfig的拉取/推送镜像、拉取代码的密钥 oc set build-secret

  1. 设置samplebuild bc的拉取镜像的密钥dockerhubsecret
    1
    $  oc set build-secret --pull bc/samplebuild dockerhubsecret
  2. 设置samplebuild bc的推送镜像的密钥dockerhubsecret
    1
    $  oc set build-secret --push --pull bc/samplebuild dockerhubsecret
  3. 设置samplebuild bc的拉取代码的密钥githubsecret
    1
    $  oc set build-secret --source  bc/samplebuild  githubsecret
  4. 删除sample bc设置的推送镜像密钥
    1
    $   oc set build-secret --push --remove bc/sample

设置触发器 oc set triggers

  1. 列出sample dc当前的触发器
    1
    $ oc set triggers dc/sample
  2. 关闭sample dc所有的自动触发器
    1
    $ oc set triggers dc/sample --manual
  3. 开启sample dc所有的自动触发器
    1
    $ oc set triggers dc/sample --auto
  4. 更新sample bc的github触发器的密钥值
    1
    $ oc set triggers bc/sample --from-github
  5. 删除sample bc的所有触发器
    1
    $   oc set triggers bc/sample --remove-all
  6. 删除sample dc的ConfigChange触发器
    1
    $ oc set triggers dc/sample --from-config --remove
  7. 更新sample bc的ImageStreamTag触发器的镜像Tag为test/sample:latest
    1
    $  oc set triggers bc/sample --from-image=test/sample:latest
  8. 更新sample dc容器sample的ImageStreamTag触发器的镜像Tag为test/sample:latest
    1
    $  oc set triggers dc/sample --from-image=test/sample:latest -c sample

设置BuildConfig的postcommit钩子 oc set build-hook

  1. 设置samplebuild bc的command类型的post-commit
    1
    $  oc set build-hook bc/samplebuild --post-commit --command -- /bin/bash -c /var/lib/test-image.sh
  2. 设置samplebuild bc的script类型的post-commit
    1
    $ oc set build-hook bc/samplebuild --post-commit --script="/var/lib/test-image.sh param1 param2 && /var/lib/done.sh"
  3. 设置samplebuild bc的args类型的post-commit
    1
    $  oc set build-hook bc/samplebuild --post-commit  -- arg1 arg2
    command类型、script类型与args类型的区别：
  • script：执行时使用/bin/sh -ic替换掉默认的entrypoint来执行代码
  • command：不指定解析器，也不使用entrypoint，而是直接执行代码
  • args：使用默认的entrypoint执行代码
  1. 删除samplebuild bc的post-commit
    1
    $   oc set build-hook bc/samplebuild --post-commit --remove

设置Route的后端服务oc set route-backends

  1. 列出sample route的后端服务
    1
    $ oc set route-backends sample
  2. 设置sample route的后端服务为两个并且流量比为1：9，samplev1（10%），samplev2（90%）
    1
    $ oc set route-backends sample samplev1=1 samplev2=9
  3. 为sample route后端服务samplev1添加10%的流量
    1
    $ oc set route-backends sample --adjust samplev1=+10%
  4. 将sample route所有后端服务流量设为0，该route将无法对外提供服务
    1
    $ oc set route-backends sample --zero