
Each release of CAS provides a curated list of dependencies it supports. Including third-party source is trivial simply include the relevant dependency in the overlay pom.Īlso, note that for any custom Java component to compile and be included in the final cas. CAS can be deployed to a number of servlet containers. To learn more about the configuration server, please review this guide. See this Maven WAR overlay for more details. The changesets will be cleaned out and set back to defaults every time you do a build. Note: Do NOT ever make changes in the above-noted build directory. The Gradle overlay also provides additional tasks to explode the binary artifact first before re-assembling it again. To construct the overlay project, you need to copy directories and files that you need to customize in the build directory over to the source directory. The master branch typically points to the latest stable release of the CAS server.Ĭheck the build configuration and if inappropriate, use git branch -a to see available branches, and then git checkout to switch if necessary. You should always make sure the branch you are on matches the version of CAS you wish to configure and deploy. The below repositories point you towards their master branch. Make sure the deployment environment is kept clean and precise, or you incur the risk of terrible upgrade issues and painful headaches. Do NOT copy everything produced by the build.Īttempt to keep changes and customizations to a minimum and only grab what you actually need.

The process of working with an overlay, whether Maven or Gradle, can be summarized in the following steps. It goes without saying that while up-front ramp-up time could be slightly complicated, there are significant advantages to this approach. In order for the merge process is successfully execute, the location and names of the overridden artifacts locally must EXACTLY match that of those provided by the project inside the originally downloaded archive. Overridden artifacts may include resources, java classes, images, CSS and javascript files. Then the tool will locate your configuration files and settings made available inside the same project directory and will merge those into the downloaded artifact in order to produce one wholesome archive i. The output of a WAR overlay build is a cas.

