Generic CAS Spring Cloud Configuration Server WAR overlay
WAR Overlay Type: cas-config-server-overlay
7.1.0-SNAPSHOT
21
To build the project, use:
# Use --refresh-dependencies to force-update SNAPSHOT versions
./gradlew[.bat] clean build
To see what commands/tasks are available to the build script, run:
./gradlew[.bat] tasks
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.
For the server to run successfully, you might need to create a keystore file.
This can either be done using the JDK's keytool
utility or via the following command:
./gradlew[.bat] createKeystore
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.
Extension modules may be specified under the dependencies
block of the Gradle build script:
dependencies {
implementation "org.apereo.cas:cas-server-some-module"
...
}
To collect the list of all project modules and dependencies in the overlay:
./gradlew[.bat] dependencies
On a successful deployment via the following methods, the server will be available at:
https:/localhost:8888/casconfigserver
Run the server web application as an executable WAR. Note that running an executable WAR requires CAS to use an embedded container such as Apache Tomcat, Jetty, etc.
No servlet container is specified for the current build. Examine your gradle.properties
file
and modify the appServer
property to point to the appropriate container of choice.
java -jar build/libs/casconfigserver.war
Or via:
./gradlew[.bat] run
It is often an advantage to explode the generated web application and run it in unpacked mode. One way to run an unpacked archive is by starting the appropriate launcher, as follows:
jar -xf build/libs/casconfigserver.war
cd build/libs
java org.springframework.boot.loader.launch.JarLauncher
This is slightly faster on startup (depending on the size of the WAR file) than running from an unexploded archive. After startup, you should not expect any differences.
Debug the CAS web application as an executable WAR:
./gradlew[.bat] debug
Or via:
java -Xdebug -Xrunjdwp:transport=dt_socket,address=5000,server=y,suspend=y -jar build/libs/casconfigserver.war
Run the CAS web application as a standalone executable WAR:
./gradlew[.bat] clean executable
Deploy the binary web application file in build/libs
after a successful build to a servlet container of choice.
The following strategies outline how to build and deploy CAS Docker images.
The overlay embraces the Jib Gradle Plugin to provide easy-to-use out-of-the-box tooling for building CAS docker images. Jib is an open-source Java containerizer from Google that lets Java developers build containers using the tools they know. It is a container image builder that handles all the steps of packaging your application into a container image. It does not require you to write a Dockerfile or have Docker installed, and it is directly integrated into the overlay.
# Running this task requires that you have Docker installed and running.
./gradlew build jibDockerBuild
You can also use the Docker tooling and the provided Dockerfile
to build and run.
There are dedicated Gradle tasks available to build and push Docker images using the supplied DockerFile
:
./gradlew build casBuildDockerImage
Once ready, you may also push the images:
./gradlew casPushDockerImage
If credentials (username+password) are required for pull and push operations, they may be specified
using system properties via -DdockerUsername=...
and -DdockerPassword=...
.
A docker-compose.yml
is also provided to orchestrate the build:
docker-compose build