OpenShift应用上线手册
1、账户基本信息
应用名称 | 访问地址 |
---|---|
测试环境(样例) | https://www.baidu.com |
2、将后台服务端项目部署到Tomcat上
2.1将项目打成war包
2.2新建project
2.3将war包上传到自己的gitlab上,并复制其git地址
3、War包应用上线流程
3.1上传war包至gitlab
3.2部署
搜索tomcat选择JBoss Web Server 3.1 Apache Tomcat 8
点击Next
Context Directory如果是根目录则留空,其他路径自行填写
点击Create
3.3Build添加认证信息
如果gitlab项目为私有则构建会提示认证失败错误如下:
解决方案如下:
点击Resources-Secrets-Create Secret
填入git的用户名和密码
然后回到build点击某个build -Actions - Edit YAML
按下图编辑其中git部分,添加了sourceSecret部分,其中name是上一步创建的secret的名称
编辑完成后点击save点击Start Build即可。
3.4应用访问
3.4.1集群内应用调用(应用a和应用b都部署在Openshift内,应用a调用b的地址)
点击Applications-Services-点击某一个记录,使用Hostname地址加端口号
例如:notify.ali.svc:9002
3.4.2集群外访问(浏览器访问,或者非Openshift集群内的应用调用)
点击Applications-Routes
4Jar包应用上线流程
4.1上传Jar包至gitlab
参考3.1
4.2部署
搜索jdk选择OpenJDK
点击Next
点击Create
4.3Build添加认证信息
Build添加认证信息(详情步骤在3.3)
4.4启动命令
默认执行java -jar xxx.jar
如果需要自定义启动命令,则在gitlab根目录新建bin目录添加run.sh文件写入启动命令即可。
4.5应用访问
应用访问(详细在3.4)
5将前端页面部署到nginx上
5.1将打包的前端文件夹上传到gitlab上
(因为是个文件夹,得用git命令方式上传)
(ps: gitlab新建一个项目来存放前端页面,地址如上。)
提交文件夹时会出现上面的问题,解决方案为:进行代码合并 git pull --rebase origin master 再提交。
5.2上传成功复制git地址
6、nginx上线流程
6.1上传静态文件至gitlab
参考3.1
6.2部署
搜索nginx选择Nginx HTTP server and a reverse proxy(nginx)
点击Next
输入相关信息点击Create
6.3Build添加认证信息
Build添加认证信息(详情步骤在3.3)
6.4修改配置文件
默认配置文件内容如下:
可以修改文件内容创建configmap挂载到/etc/opt/rh/rh-nginx112/nginx/nginx.conf下
Configmap使用请参考:ConfigMap使用 (请看下面的8)注意:请使用subPath模式挂载
6.5应用访问
应用访问(详细在3.4)
7、Mysql部署
7.1存储创建
项目资源申请后请联系平台运维人员创建pvc,可以Storage内查看已经存在的pvc
7.2mysql创建
搜索mysql 选择MySQL。
注意:MySQL(Ephemeral)为临时测试使用,该模板创建的MySQL没有要后端存储,pod重启后数据会丢失
填写相关信息
点击Create创建完成
7.3mysql连接
7.3.1集群内应用连接
Applications-Services-找到mysql的service
程序内配置mysql.lisw.svc:XXX
7.3.2集群外部机器连接(数据库管理,数据录入等操作)
使用oc客户端执行:oc port-forward mysql_pod_name 3309:3309
此命令会将本机的3309端口映射为集群msyql的3306端口,使用mysql客户端连接本机3309端口即为连接集群内的3309端口。连接后即可进行管理。
注意:请替换mysql_pod_name为你的mysql的pod名称具体名称在Applications-Pods里查找
7.3.3用户名密码
如果忘记mysql用户名密码可以通过如下方式获取
Resources-Secrets-mysql
8、ConfigMap使用
8.1新建configmap
Resource-Config Maps-Create Config Map
填入相关信息
8.2挂载configmap
点击某一个configmap 点击Add to Application
填入相关信息点击save,完成后pod会自动删除创建一个新的pod新的pod里面会存在挂载的文件
8.3subPath
直接挂载会导致覆盖整个目录,如果想要不覆盖原目录则在挂载完成后修改dc的yaml
Applications-Deployments-找到相应的dc-Actions-Edit YAML
找到volumeMounts字段进行如下修改
修改前:
修改后:
9、存储使用
存储申请后联系paas平台运维人员创建pvc,pvc创建后可以在Storage里面查看
Pvc创建完成后可以挂载给应用挂载方式如下:
Applications-Deployments-选择需要挂载的应用
10、OC客户端
用户可以访问根据自己操作系统下载相应客户端
10.1登录
使用OC客户端执行oc login ocp地址然后输入用户名和密码即可
10.2本机与容器复制文件
首先确定相关pod的名称
10.2.1本机复制到容器
oc cp local_path pod_name:/path
10.2.2容器复制到本机
oc cp pod_name:/path local_path
11、调试
11.1查看标准输出日志
Applications-Pods-点击相应pod-Logs
此处为程序输出到控制台的日志信息,如果应用将日志写入了文件请查看相关文件
11.2Terminal
Applications-Pods-点击相应pod-Terminal
可以进入容器访问相应文件或目录
11.3环境变量
Applications-Deployments-相应的dc-Environment可以对容器内的环境变量进行管理
11.3.1调整容器时区
添加环境变量TZ Asia/Shanghai
11.3.2中文乱码
添加环境变量LC_ALL en_US.UTF-8