5a961c52f8
* added updated example codes * updated example code StringToCharStream * deleted StringToCharStream.java locally * removed redundant file * added code for apache commons collection SetUtils * refactored example code * added example code for bytebuddy * added example code for PCollections * update pom * refactored tests for PCollections * spring security xml config * spring security xml config * remove redundant comment * example code for apache-shiro * updated example code for Vavr Collections * updated Vavr's Collection example * updated Vavr Collection file * updated example code for Apache Shiro * updated Vavr Collections example * added example code for N1QL * update example code for N1QL * added integration test for N1QL * update N1QL Example code * update the N1QL example Code * rename module to couchbase * rename module to couchbase * change module name in parent module and pom * added cas-server module * added cas secured app for Spring SSO with CAS * refactor cas modules into cas folder
89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
CAS Overlay Template
|
|
============================
|
|
|
|
Generic CAS WAR overlay to exercise the latest versions of CAS. This overlay could be freely used as a starting template for local CAS war overlays. The CAS services management overlay is available [here](https://github.com/apereo/cas-services-management-overlay).
|
|
|
|
# Versions
|
|
|
|
```xml
|
|
<cas.version>5.1.x</cas.version>
|
|
```
|
|
|
|
# Requirements
|
|
* JDK 1.8+
|
|
|
|
# Configuration
|
|
|
|
The `etc` directory contains the configuration files and directories that need to be copied to `/etc/cas/config`.
|
|
|
|
# Build
|
|
|
|
To see what commands are available to the build script, run:
|
|
|
|
```bash
|
|
./build.sh help
|
|
```
|
|
|
|
To package the final web application, run:
|
|
|
|
```bash
|
|
./build.sh package
|
|
```
|
|
|
|
To update `SNAPSHOT` versions run:
|
|
|
|
```bash
|
|
./build.sh package -U
|
|
```
|
|
|
|
# Deployment
|
|
|
|
- Create a keystore file `thekeystore` under `/etc/cas`. 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.
|
|
|
|
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.
|
|
|
|
```bash
|
|
./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.
|
|
|
|
```bash
|
|
./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](https://github.com/apereo/cas/issues/2334) and [this issue](https://github.com/spring-projects/spring-boot/issues/8320) for more info.
|
|
|
|
|
|
## Spring Boot App Server Selection
|
|
There is an app.server property in the pom.xml that can be used to select a spring boot application server.
|
|
It defaults to "-tomcat" but "-jetty" and "-undertow" are supported.
|
|
It can also be set to an empty value (nothing) if you want to deploy CAS to an external application server of your choice and you don't want the spring boot libraries included.
|
|
|
|
```xml
|
|
<app.server>-tomcat<app.server>
|
|
```
|
|
|
|
## Windows Build
|
|
If you are building on windows, try build.cmd instead of build.sh. Arguments are similar but for usage, run:
|
|
|
|
```
|
|
build.cmd help
|
|
```
|
|
|
|
## External
|
|
|
|
Deploy resultant `target/cas.war` to a servlet container of choice.
|