CAS企业单点登录-安装(Maven)

CAS安装基本上是一个面向源的过程，我们推荐一个WAR overlay(1)项目来组织定制，比如组件配置和UI设计。WAR覆盖构建的输出是cas。可以部署到servlet容器(如Apache Tomcat)的war文件。

需求

参见本指南了解更多信息。

什么是WAR覆盖

覆盖是一种对抗重复代码和/或资源的策略。覆盖允许您下载由项目本身提供的预构建的普通CAS web应用服务器，并覆盖/插入特定的行为，而不是从源代码下载CAS代码库和构建。在构建时，Maven/Gradle安装过程将首先尝试下载提供的二进制工件。然后，该工具将定位您在同一项目目录中可用的配置文件和设置，并将它们合并到下载的工件中，以便生成一个完整的存档(例如，cas.war)。覆盖的工件可能包括资源、java类、图像、CSS和javascript文件。为了成功地执行合并进程，在本地被覆盖的工件的位置和名称必须与最初下载的归档文件中项目提供的位置和名称完全匹配。

毫无疑问，尽管前期准备阶段可能会稍微复杂一些，但是这种方法有显著的优势:

• 不需要从源代码下载/构建。
• 通过简单地调整构建脚本以下载更新的CAS版本，升级在大多数情况下都非常容易。
• 与托管整个软件源代码不同，作为部署人员，您只保留您自己的本地自定义，这使得更改跟踪更加容易。
• 跟踪源代码控制存储库中的更改是非常轻量级的，这同样是因为只管理相关的更改(而不是整个软件)。

管理覆盖

CAS的每个方面都可以通过叠加中添加、删除或修改文件进行控制;通过添加第三方组件(将CAS api实现为Java源文件或依赖项引用)来定制CAS的行为也是可能的，也是常见的。

使用覆盖层的过程，不管是Maven还是Gradle，可以通过以下步骤进行总结:

• 开始并构建提供的基本构建/部署。
• 从生成的构建中识别需要更改的构件。这些构件通常由目标或Maven或Gradle的构建目录中生成。
• 将上述目录中标识的构件复制到src目录中。
• 创建src目录及其所有子节点，如果它们还不存在的话。
• 复制的路径和文件名必须与构建版本完全匹配，否则更改不会生效。请参阅下面的表格，了解如何将文件夹和文件从构建映射到src。
• 更改之后，尽可能多地重新构建和重复这个过程。
• 在构建的二进制工件中再次检查您的更改，以确保覆盖过程正在工作。

是准确的
不要复制构建生成的所有内容。尝试将更改和自定义保持到最小，只获取实际需要的内容。确保部署环境保持干净和精确，否则您将面临严重升级问题和令人头痛的风险。

CAS WAR覆盖

提供CAS WAR覆盖项目供参考和研究。

审查分支!
下面的存储库指向它们的主分支。您应该始终确保您所在的分支与您希望配置和部署的CAS版本匹配。主分支通常指向CAS服务器的最新稳定版本。检查构建配置，如果不合适，使用git分支a查看可用的分支，然后git签出[branch-name]以在必要时进行切换。