一 部署简述
cas server官方推荐采用overlay方式进行部署,通过替换自定义文件,减少项目文件改动,以简化开发和部署,这个有点类似于项目上直接替换java的class文件,由于和git的搭配使用,降低了版本不一致的问题;
二 部署
- clone项目:
git clone --depth=1 --single-branch --branch=5.3 https://github.com/liulei3/cas-overlay-template.git
--depth:clone深度,1代表只clone最近一次提交;
--single-branch:只获取单个分支,分支由--branch或主分支远程的HEAD指定;
--branch:指定clone分支;
由于不同版本存在差异,这里选取5.3版本演示;
- 项目要求:
JDK 1.8+;
配置ssl证书;
配置ssl证书如果采用官方启动方式是必须的,因为默认开发端口是8443;
- 项目目录
etc.cas.config 定义cas服务器默认配置文件和日志信息
maven maven统一版本包,因为不同版本的maven存在差异,为了避免脚本执行环境错误,这里引入了统一的maven版本,感觉可以删除,有意者可以自行尝试
build.* 项目构建脚本,sh是linux环境运行;cmd是windows环境运行;
mvnw.* maven执行脚本,没有后缀是linux环境运行;bat是windows环境运行;
tip:
pom.xml文件中定义了外部依赖库,它会覆盖本地的maven依赖库设置,你下载可以直接注释;
cas server是一个web项目,它依赖一个外部服务器,这个服务器可以是jetty,undertow,tomcat或者自定义web服务器,这里选取tomcat,它依赖cas-server-webapp-tomcat-5.3.4.war,
这个包有115M,推荐你单独下载,然后直接放入你maven本地仓库即可(位置:maven仓库地址\org\apereo\cas\cas-server-webapp-tomcat\5.3.4\);
- 配置ssl证书
1 生成keystore
keytool -genkey -alias cas -keyalg RSA -validity 999 -keystore D:\cas\thekeystore.keystore
-alias:指定别名
-keyalg指定RSA算法
-validity指定有效天数;
-keystore指定文件路径及名称;
另外提示输入您的名字与姓氏:是CAS服务器使用的域名(不能是IP,也不能是localhost)
2 导出证书
keytool -export -alias cas -file D:\cas\cas.crt -keystore D:\cas\thekeystore.keystore
-alias指定别名;
-file指定导出证书的文件名;
-keystore指定之前生成的密钥文件的文件名。
3 替换jdk证书
keytool -import -alias cas -file D:\cas\cas.crt -keystore $JAVA_HOME\jre\lib\security\cacerts
-file:指定导入证书的文件名
-keystore:jdk证书位置
4 查看证书:
keytool -list -v -alias cas -keystore D:\cas\thekeystore.keystore
需要你自己替换文件目录
- 项目启动
1 脚本启动
window
运行war包方式
./build.cmd run
spring boot方式
./build.cmd bootrun
linux:命令一样,但是执行脚本为build.sh
2 tomcat启动(这种方式不用配置ssl证书)
打包获取cas.war
mvn clean package
将cas.war放入tomcat的webapps目录,启动tomcat的startup.bat运行
spring boot方式启动如果你修改了目录结构或者脚本,需要你指定启动主类
- 访问
http://cas.server.name:8080/cas
https://cas.server.name:8443/cas
未配置ssl证书登录页:
配置ssl证书登录页:
- 登录:
输入默认用户名密码:casuser::Mellon 跳转登录成功页:
参考资料:
cas-overlay-template: https://github.com/liulei3/cas-overlay-template/tree/5.3
cas build process: https://apereo.github.io/cas/developer/Build-Process-5X.html