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.10.3

NOTE: Docker Native for Mac/Windows is untested.

Configuration

Image

• The image will be available on the host via ports 80 and 443
• The image may be accessed via the host browser at the container-provided IP address. You may determine the IP address via docker inspect $CONTAINER_ID
• The CAS server will be deployed inside an embedded Jetty container that is built into the CAS overlay project.
• 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.

CAS Overlay

• The build will automatically copy the contents of the src\main\webapp to the docker image.
• You can set up your own custom overlay project based on a directory structure that mimics that of the CAS web application itself.

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 Jetty is pre-configured to use that keystore for HTTPS requests.

Build

Start Docker:

docker-machine start
docker-machine env

Run the eval command next.

Make sure that both build.sh and run.sh are updated to build the appropriate tag. Docker tags MUST correspond to CAS server versions.

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.

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/
• Log into the Docker Hub via the following command:

docker-machine ssh default
docker login -u username -p password -e email
docker push apereo/cas:v$CasVersion