Skip to content
This repository has been archived by the owner. It is now read-only.
CAS Gradle Overlay: Generic CAS gradle war overlay to exercise the latest versions of CAS
Branch: master
Clone or download
Latest commit bc15d2a Jul 27, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cas switch to 5.3 May 21, 2018
etc/cas/config
gradle/wrapper updated Jun 29, 2018
.gitignore update to 5.1 Jun 8, 2017
LICENSE Updated config Aug 2, 2016
README.md switch to 5.3 May 21, 2018
build.gradle upgrade gradle overlay for shell access Oct 22, 2017
build.sh switch to 5.3 May 21, 2018
gradle.properties
gradlew clean up gradle overlay Aug 28, 2017
gradlew.bat First pass at 5 Aug 24, 2016
settings.gradle

README.md

CAS Gradle Overlay

Generic CAS Gradle war overlay to exercise the latest versions of CAS. This overlay could be freely used as a starting template for local CAS Gradle war overlays.

Versions

  • CAS 5.3.x

Requirements

  • JDK 1.8+

Configuration

The etc directory contains the configuration files that are copied to /etc/cas/config automatically.

Adding Modules

CAS modules may be specified under the dependencies block of the CAS subproject:

dependencies {
    compile "org.apereo.cas:cas-server-webapp-tomcat:${project.'cas.version'}@war"
    compile "org.apereo.cas:cas-server-some-module:${project.'cas.version'}"
    ...
}

Study material:

Build

To see what commands are available to the build script, run:

./build.sh help

To package the final web application, run:

./build.sh package

To update SNAPSHOT versions run:

./build.sh package --refresh-dependencies

Clear Gradle Cache

If you need to, on Linux/Unix systems, you can delete all the existing artifacts (artifacts and metadata) Gradle has downloaded using:

# Only do this when absolutely necessary!
rm -rf $HOME/.gradle/caches/

Same strategy applies to Windows too, provided you switch $HOME to its equivalent in the above command.

Build Tasks

To see what commands are available in the build, use:

 ./gradlew[.bat] tasks

Project Dependencies

To see where certain dependencies come from in the build:

# Show the surrounding 2 before/after lines once a match is found
 ./gradlew[.bat] allDependencies | grep -A 2 -B 2 xyz

Or:

./gradlew[.bat] allDependenciesInsight --configuration [compile|runtime] --dependency xyz

Deployment

  • Create a keystore file thekeystore under /etc/cas on Linux. Use c:/etc/cas on Windows.
  • Use the password changeit for both the keystore and the key/certificate entries.
  • Ensure the keystore is loaded up with keys and certificates of the server, by adding the following to ./etc/cas/config/cas.properties:
server.ssl.keyStore=file:/etc/cas/thekeystore
server.ssl.keyStorePassword=changeit
server.ssl.keyPassword=changeit

On a successful deployment via the following methods, CAS will be available at:

  • http://cas.server.name:8080/cas
  • https://cas.server.name:8443/cas

Executable WAR

Run the CAS web application as an executable WAR.

./build.sh run

Spring Boot

Run the CAS web application as an executable WAR via Spring Boot. This is most useful during development and testing.

./build.sh bootrun

Warning!

Be careful with this method of deployment. bootRun is not designed to work with already executable WAR artifacts such that CAS server web application. YMMV. Today, uses of this mode ONLY work when there is NO OTHER dependency added to the build script and the cas-server-webapp is the only present module. See this issue for more info.

External

Deploy resultant cas/build/libs/cas.war to a servlet container of choice.

Troubleshooting

You can also run the CAS server in DEBUG mode to step into the code via an IDE that is able to connect to the port 5005.

./build.sh debug

To setup a development environment for either eclipse or IDEA:

# ./gradlew[.bat] eclipse
# ./gradlew[.bat] idea

The above tasks help to setup a project for your development environment. If you find that something has gone wrong, you can always start anew by using the following:

# ./gradlew[.bat] cleanEclipse
# ./gradlew[.bat] cleanIdea

Explode WAR

You may explode/unzip the generated CAS web application if you wish to peek into the artifact to examine dependencies, configuration files and such that are merged as part of the overlay build process.

./gradlew[.bat] explodeWar

Command Line Shell

Invokes the CAS Command Line Shell. For a list of commands either use no arguments or use -h. To enter the interactive shell use -sh.

./build.sh cli
You can’t perform that action at this time.