Central Authentication Service (CAS)
Introduction
This repository hosts the Docker build configuration necessary to build a CAS image.
See the Dockerfile
for more info.
Versions
A docker image for CAS server. Images are tagged to match CAS server releases.
Requirements
- Docker version
1.9.x
~1.13.x
Configuration
Image
- The image will be available on the host via ports
8080
and8443
- You must check the
Dockerfile
to ensure the right branch from the CAS overlay project is pulled/cloned. - Check the CAS overlay project itself to figure out the targetted CAS release.
SSL
- Update the
thekeystore
file with the server certificate and chain if you need access the CAS server via HTTPS. - The password for the keystore is
changeit
. - The build will automatically copy the keystore file to the image. The embedded container packaged in the overlay is pre-configured to use that keystore for HTTPS requests.
- The build will also auto-copy configuration files under the
etc/cas
directory to the corresponding locations inside the image.
Build
Make sure that both build.sh
and run.sh
are updated to build the appropriate tag. Docker tags MUST correspond
to CAS server versions. Also, make sure the version matches a branch name on the CAS overlay project.
NOTE: On windows, you may want to run bash
first so you can execute shell scripts.
./build.sh $CasVersion
The image will be built as apereo/cas:v$CasVersion
.
NOTE: If you are building for Demo puposes then make sure the private keys are added to keystore by running the following commands.
keytool -genkeypair -alias cas -keyalg RSA -keypass changeit -storepass changeit -keystore <PATH/TO/KEYSTORE> -ext SAN="dns:localhost,ip:127.0.0.1"
Caution: The above commands adds new key pair which is okay for demo pueposes. For production systems you might want to change the SAN and other parameters as needed.
Run
./run.sh $CasVersion
Release
- New images shall be released at the time of a new CAS server release.
- Image versions are reflected in the
build|run.sh
files and need to be updated per CAS/Image release. - Images are published to https://hub.docker.com/r/apereo/cas/
./push.sh $CasVersion