單點登錄CAS-02:如何得到一個cas.war?
1、前言
根據官方的文檔介紹，官方建議使用war覆蓋部署的方式進行cas服務器的部署，並且提供了相關的工程模板，只需要簡單幾步就可以完成構建。官方給出的建議是：1、減少重複的源代碼開發；2、儘量避免對CAS進行侵入式的源碼修改。
以下就根據官方文檔的指導下載CAS WAR工程並進行構建
2、步驟
2.1 學習教程
在github上打開cas的教程頁面
https://apereo.github.io/cas/5.3.x/installation/Maven-Overlay-Installation.html
如圖所示有幾個要點：
CAS WAR Overlays：大意是使用cas的war進行部署。
Review Branch：這一塊文字的大意是“下方的Project提供的鏈接指向工程的最新穩定版，如果要獲取你想要的相應版本，可以執行git branch -a命令查看有哪些分支可以拉取，然後執行git checkout [分支名稱] 拉取對應版本的源碼”
下方提供有兩個版本的工程，請選擇合適自己的版本，我這裏選擇的是Maven版本
| 版本名 | 工程名 | 工程鏈接 |
|---|---|---|
| Maven版本 | CAS Maven WAR overlay | https://github.com/apereo/cas-overlay-template |
| Gradle版本 | CAS Gradle WAR overlay | https://github.com/apereo/cas-gradle-overlay-template |
2.2 下載並構建
掌控了以上信息之後，就可以下載源碼了。
注：以下操作需要本機安裝git和maven。其中git程序需要配置github網站的帳號。如果還沒有準備好環境，請先安裝配置妥當。不會的請百度。
在本機創建一個工作目錄如D:\gitspace
打開cmd窗口執行以下命令：
| 序號 | CMD命令 |
|---|---|
| 1.切換到D盤 | D: (回車) |
| 2.進入工作目錄 | cd D:\gitspace |
| 3.克隆github工程到本機 | git clone https://github.com/apereo/cas-overlay-template |
| 4.下載完成後進入工程目錄 | cd D:\gitspace\cas-overlay-template |
| 5.查看可用的分支 | git branch -a |
| master remotes/origin/4.1 remotes/origin/4.2 remotes/origin/5.0.x remotes/origin/5.1 remotes/origin/5.2 remotes/origin/5.3 remotes/origin/6.0 remotes/origin/6.1 remotes/origin/HEAD -> origin/master remotes/origin/alljarsinwar remotes/origin/master |
|
| 6.簽出指定分支的源碼 | git checkout remotes/origin/5.3 注：此處我使用的是5.3版本 |
| 7.執行maven構建 | mvn clean package |
| [INFO] Layout: WAR [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 02:54 min [INFO] Finished at: 2020-05-12T15:11:43+08:00 [INFO] Final Memory: 20M/207M [INFO] ------------------------------------------------------------------------ |
執行完以上步驟之後，進入到目錄cd D:\gitspace\cas-overlay-template\target即可看到有一個cas.war文件了。
2.3 CAS應用部署
以下步驟需要JDK以及tomcat程序，並配置好JAVA_HOME。此處使用的版本是
| 軟件 | 版本 | 下載網址 |
|---|---|---|
| tomcat | apache-tomcat-8.5.41-windows-x64 | https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.41/bin/apache-tomcat-8.5.41-windows-x64.zip |
| jdk | jdk1.8.0_181 | https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html 此頁面可下載JDK1.8的各種版本 |
tomcat解壓安裝目錄爲：
D:\application\apache-tomcat-8.5.41-windows-x64-CasServer
將上面構建得到的cas.war複製到D:\application\apache-tomcat-8.5.41-windows-x64-CasServer\webapps\cas.war
2.4 CAS登錄驗證
雙擊startup.bat運行tomcat：
D:\application\apache-tomcat-8.5.41-windows-x64-CasServer\bin\startup.bat
注：tomcat啓動需要一點時間，請耐心等待
打開瀏覽器輸入：http://localhost:8080/cas
輸入帳號/密碼：casuser/Mellon
注：帳號密碼在cas.war\WEB-INF\classes\application.properties中配置，如下：
##
# CAS Authentication Credentials
#
cas.authn.accept.users=casuser::Mellon
輸入帳號密碼並登錄：
