COmanage Match Docker

These instructions detail how to build and deploy a Dockerized version of COmanage Match, as well as other infrastructure commonly deployed with COmanage Match.

Since COmanage Match is a web application that requires a relational database and an authentication mechanism such as Shibboleth, mod_auth_openidc, or just simple Basic Authentication, this repository includes multiple Dockerfiles to build images that use various combinations of tools.

Evaluate COmanage Match

If you are new to COmanage Match follow these instructions to build and run a simple deployment suitable for evaluating COmanage Match.

Building Images

The following link to detailed instructions for building each individual image. See the next section for links to documentation on how to deploy the images as services.

• COmanage Match base image
• COmanage Match with Basic Authentication
• COmanage Shibboleth SP base image
• COmanage Match with Shibboleth SP
• COmanage Match for Internet2 TAP base
• COmanage Match for Internet2 TAP
• PostgreSQL for COmanage Match

Deploying Images and Running Services

Since COmanage Match requires a relational database it is commont that multiple images need to be simultanesouly instantiated as containers. Orchestrating multiple containers to create services is easiest using tools such as Docker Compose, Docker Swarm, or Kubernetes.

The images built from Dockerfiles in this repository may be used with any container orchestration platform but the documentation demonstrates how to deploy with Docker Swarm (the simple evaluation scenario above uses Docker Compose).

The following link to detailed instructions for a number of deployment scenarios.

• COmanage Match using the Shibboleth SP and PostgreSQL database

All Documentation

Building Images

• COmanage Match base image
• COmanage Match with Basic Authentication
• COmanage Shibboleth SP base image
• COmanage Match with Shibboleth SP
• COmanage Match for Internet2 TAP base
• COmanage Match for Internet2 TAP
• PostgreSQL for COmanage Match

Deploying Services

• COmanage Match using the Shibboleth SP and PostgreSQL database

Other

• COmanage Match Volumes and Data Persistence
• Evaluating COmanage Match using Docker
• Environment Variables Common to All Images
• Environment Variables Common to Images using Shibboleth SP for Authentication