OpenShift
OpenShift的client工具oc功能非常强大，几乎能实现所有的操作，它的每一个子命令都能实现非常多的功能。其中有个容易被忽视却很强大的子命令oc set可以实现对资源很多额外的配置，包括有环境变量、资源限制、持久化卷挂载、健康检查等等。
下面是oc set的帮助详情。
[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
- 列出sample dc设置的环境变量
$ oc set env dc/sample --list # 列出sample dc设置的环境变量
- 为sample dc设置环境变量NAME=value
$ oc set env dc/sample NAME=value # 为sample dc设置环境变量NAME=value
- 从secret mysecret中向sample dc导入环境变量
$ oc set env --from=secret/mysecret dc/sample #从secret mysecret中向sample dc导入环境变量
- 从configmap myconfigmap中筛选出前缀为MYSQL_的变量向sample dc中导入为环境变量
$ oc set env --from=configmap/myconfigmap --prefix=MYSQL_ dc/sample #从configmap myconfigmap中筛选出前缀为MYSQL_的变量向sample dc中导入为环境变量
- 删除sample dc中的名为NAME的环境变量
$ oc set env dc/sample NAME- #删除sample dc中的名为NAME的环境变量
资源限制 oc set resources
- 为dc/sample中的容器设置内存限制
$ oc set resources dc/sample --limits=memory=2Gi --requests=memory=1Gi
- 给sample dc中的所有容器设置资源cpu和memory限制
$ oc set resources dc/sample --limits=cpu=200m,memory=2Gi --requests=cpu=100m,memory=1Gi #给sample dc中的所有容器设置资源cpu和memory限制
- 给sample dc中的nginx容器设置资源cpu和memory限制
$ oc set resources dc/sample -c=nginx --limits=cpu=200m,memory=2Gi --requests=cpu=100m,memory=1Gi #给sample dc中的nginx容器设置资源cpu和memory限制
- 删除sample dc资源限制配置
$ oc set resources dc/sample --limits=cpu=0,memory=0 --requests=cpu=0,memory=0 #删除资源限制配置
- 不执行更新，只显示修改的配置
$ oc set resources dc/sample --limits=cpu=200m,memory=512Mi -o yaml #不执行更新，只显示修改的配置
挂载点 oc set volumes
- 查看sample dc的挂载点
$ oc set volumes dc/sample
- 查看当前项目下的所有dc的挂载点
$ oc set volumes dc --all
- 给sample dc创建一个挂载点/data，挂载emptyDir
$ oc set volumes dc/sample --add --mount-path=/data
- 使用一个现有的名为pvc1的pvc挂载到名为v1的挂载点
$ oc set volumes dc/sample --add --name=v1 -t pvc --claim-name=pvc1 --overwrite
- 删除sample dc中名为v1的挂载点
$ oc set volumes dc/sample --remove --name=v1
- 新建一个pvc挂载到sample dc中名为v1的挂载点
$ oc set volumes dc/sample --add --name=v1 -t pvc --claim-size=1G --overwrite
- 更改名为v1的挂载点对应在sample dc中的目录为/data2
$ oc set volumes dc/sample --add --name=v1 -m /data2 --overwrite
- 删除sample dc中的nginx容器中名为v1的挂载点
$ oc set volumes dc/sample --remove --name=v1 --containers=nginx
- 将configmap中的nginx.conf配置挂载到/data/nginx.config文件中
$ 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
- 给sample dc添加liveness检查
shell
$ oc set probe dc/sample --liveness --failure-threshold 3 --initial-delay-seconds 40 -- echo ok
- 给sample dc添加readiness检查
HTTP
$ oc set probe dc/sample --readiness --failure-threshold 3 --initial-delay-seconds 20 --get-url=http://:9000/about
- 给sample dc添加readiness检查
TCP
$ oc set probe dc/sample --readiness --open-tcp=3306
- 设置readiness的初始检查延时时间30s，超时时间为3s
$ oc set probe dc/sample --readiness --initial-delay-seconds=30 --timeout=3
- 删除rediness和liveness检查
$ 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
- 为sample dc中的strategy设置pre钩子
$ oc set deployment-hook dc/sample --container=sample --pre -v data -- /var/lib/migrate-db.sh
- 为sample dc中的strategy设置mid钩子
$ oc set deployment-hook dc/sample --mid -v data -e VAR1=value1 -e VAR2=value2 -- /var/lib/prepare-deploy.sh
- 删除sample dc的pre、mid及post的钩子
$ oc set deployment-hook dc/sample --remove --pre --mid --post
更新镜像 oc set image
- 为sample dc中的容器sample1设置镜像sample1:v2，为容器sampel2设置镜像sample2:v2
$ oc set image dc/sample sample1=sample1:v2 sample2=sample2:v2
- 为sample dc中的容器app设置镜像为imagestream tag sample/ruby:2.3
$ oc set image dc/sample app=sample/ruby:2.3 --source=imagestreamtag
- 为所有dc中的容器sample设置镜像为sample:v2
$ oc set image dc sample=sample:v2 --all
设置BuildConfig的拉取/推送镜像、拉取代码的密钥 oc set build-secret
- 设置samplebuild bc的拉取镜像的密钥dockerhubsecret
$ oc set build-secret --pull bc/samplebuild dockerhubsecret
- 设置samplebuild bc的推送镜像的密钥dockerhubsecret
$ oc set build-secret --push --pull bc/samplebuild dockerhubsecret
- 设置samplebuild bc的拉取代码的密钥githubsecret
$ oc set build-secret --source bc/samplebuild githubsecret
- 删除sample bc设置的推送镜像密钥
$ oc set build-secret --push --remove bc/sample
设置触发器 oc set triggers
- 列出sample dc当前的触发器
$ oc set triggers dc/sample
- 关闭sample dc所有的自动触发器
$ oc set triggers dc/sample --manual
- 开启sample dc所有的自动触发器
$ oc set triggers dc/sample --auto
- 更新sample bc的github触发器的密钥值
$ oc set triggers bc/sample --from-github
- 删除sample bc的所有触发器
$ oc set triggers bc/sample --remove-all
- 删除sample dc的ConfigChange触发器
$ oc set triggers dc/sample --from-config --remove
- 更新sample bc的ImageStreamTag触发器的镜像Tag为test/sample:latest
$ oc set triggers bc/sample --from-image=test/sample:latest
- 更新sample dc容器sample的ImageStreamTag触发器的镜像Tag为test/sample:latest
$ oc set triggers dc/sample --from-image=test/sample:latest -c sample
设置BuildConfig的postcommit钩子 oc set build-hook
- 设置samplebuild bc的command类型的post-commit
$ oc set build-hook bc/samplebuild --post-commit --command -- /bin/bash -c /var/lib/test-image.sh
- 设置samplebuild bc的script类型的post-commit
$ oc set build-hook bc/samplebuild --post-commit --script="/var/lib/test-image.sh param1 param2 && /var/lib/done.sh"
- 设置samplebuild bc的args类型的post-commit
$ oc set build-hook bc/samplebuild --post-commit -- arg1 arg2
command类型、script类型与args类型的区别：
- script：执行时使用/bin/sh -ic替换掉默认的entrypoint来执行代码
- command：不指定解析器，也不使用entrypoint，而是直接执行代码
- args：使用默认的entrypoint执行代码
- 删除samplebuild bc的post-commit
$ oc set build-hook bc/samplebuild --post-commit --remove
设置Route的后端服务oc set route-backends
- 列出sample route的后端服务
$ oc set route-backends sample
- 设置sample route的后端服务为两个并且流量比为1：9，samplev1（10%），samplev2（90%）
$ oc set route-backends sample samplev1=1 samplev2=9
- 为sample route后端服务samplev1添加10%的流量
$ oc set route-backends sample --adjust samplev1=+10%
- 将sample route所有后端服务流量设为0，该route将无法对外提供服务
$ oc set route-backends sample --zero
