【莹伙丛】（前方多图！介意绕行！）如何搭建 CAS overlay 项目的 IDEA 开发环境 ?

如何搭建 CAS overlay 项目的 IDEA 开发环境 ?

部署CAS 服务器的方式有很多。CAS 官方推荐使用 CAS overlay 打包

cas.war

来部署 CAS 服务端。

作为码农，上战场怎么能不带刀枪？！今天咱们就来说说使用 IDEA 该怎么搭建 CAS overlay 开发环境。

1. 首先找到 Github 上 CAS overlay 的官方源码，这里我选择使用 SSH 协议的 URL ：

   [email protected]:apereo/cas-overlay-template.git

2. 启动 IDEA 。之后从入口

   File ---> New Project from Version Control ...

   进入。

   

3. 这里我使用仓库地址下载代码。

   

4. 点击“Clone” 之后，开始自动下载源代码。源码下载完成之后，会提示你选择当前窗口打开，还是新窗口打开。（与设置有关，可能你直接自动打开了。）首次打开需要花点时间，因为会自动build，并需要下载各种依赖包。从源代码看出，使用的gradle来管理项目。为了依赖包的快速下载，我们可以配置 gradle初始化脚本，在其中设置仓库走阿里云代理，详见手把手教你：Gradle 安装及配置 。如果只是单个项目使用，也可以在项目中配置。另外，Gradle 最好使用源码中自带的兼容版本，使用其他自己安装的版本可能会存在build 失败的风险。
5. CAS 目前的最新版本是

   6.2.0-SNAPSHOT

   ，最新稳定版本是

   6.1.6

   。我们切换分支到

   6.1

   。打开项目根目录下的

   gradle.properties

   文件：

   # Versions
   	cas.version=6.1.6
   	springBootVersion=2.2.0.RELEASE
   	
   	# Use -jetty, -undertow to other containers
   	# Or blank if you want to deploy to an external container
   	appServer=-tomcat
   	executable=false
   	
   	gradleVersion=5.6.3
   	tomcatVersion=9.0.34
   	
   	group=org.apereo.cas
   	sourceCompatibility=11
   	targetCompatibility=11
   	......
              

   我们看到，当前的

   cas

   版本是

   6.1.6

   。需要

   JDK

   版本是

   11

   ，

   tomcat

   版本

   9.0.34

   ，gradle 版本

   5.6.3

   。相应工具版本最好一致，否则可能会出错。
6. 添加一个 Tomcat server 配置。

   

   

   

   

   

7. 启动服务。

   

   发现Tomcat 起来了，但是CAS 服务没起来。查看日志：cas.war 找不到！！！我们去IDEA 里的相应目录去看，果然没有。
8. 查看源码中的

   README.md

   ，发现如下命令用来构建：

   # Use --refresh-dependencies to force-update SNAPSHOT versions
   ./gradlew[.bat] clean build
              

9. 我们查看了 Tomcat server 的配置中，其实是有

   Build

   前置任务的，但是默认的构建任务不能输出我们想要的

   cas.war

   。我们在终端手动执行命令：

   ./gradlew clean build

   。命令顺利执行完成，并且输出了想要的 war 包。

   

10. 但是，每次都要手动构建war包，还是嫌麻烦，（本来我们就为了偷懒，没有选择直接把war包拷贝到 Tomcat 的 webapps 目录来运行的方式。）没关系，前方高能！！！
11. 既然默认的构建任务没法达成目的，必须要使用官方提供的方式构建war包，那我们就加一个前置任务，（当然，无用的前置任务可以删掉了。）

    

12. 保存后，可以把之前生成的文件，特别是 cas.war 删除，以验证我们的配置是否生效。现在，只需我们点以下

    Tomcat server

    的

    Run

    按钮，就可以完美运行了！！！

    

【此处应有掌声！！！】