COmanage Registry Develop with Basic Auth and DebugKit
Intended to build a COmanage Registry image targeted at developers that uses Apache HTTP Server Basic Auth (Basic Auth) as the authentication mechanism and that includes the CakePHP DebugKit plugin.
Basic Auth is only suitable for COmanage Registry deployments not operating in a federated identity context, or for an introduction to COmanage Registry.
See other documentation in this repository for examples on how to build images that support federated identity deployments.
Build Arguments
Building the image requires the following build arguments:
--build-arg COMANAGE_REGISTRY_VERSION=<version number>
--build-arg COMANAGE_REGISTRY_BASE_IMAGE_VERSION=<base image version number>
Build Requirements
This image uses a multi-stage build and requires that the COmanage Registry basic auth image be built first.
Building
docker build \
--build-arg COMANAGE_REGISTRY_VERSION=<COmanage Registry version number> \
--build-arg COMANAGE_REGISTRY_BASE_IMAGE_VERSION=<base image version number> \
-t comanage-registry:<tag> .
Building Example
export COMANAGE_REGISTRY_VERSION=3.3.3
export COMANAGE_REGISTRY_BASE_IMAGE_VERSION=1
export COMANAGE_REGISTRY_BASIC_AUTH_DEVELOP_IMAGE_VERSION=1
TAG="${COMANAGE_REGISTRY_VERSION}-basic-auth-develop-${COMANAGE_REGISTRY_BASIC_AUTH_DEVELOP_IMAGE_VERSION}"
docker build \
--build-arg COMANAGE_REGISTRY_VERSION=${COMANAGE_REGISTRY_VERSION} \
--build-arg COMANAGE_REGISTRY_BASE_IMAGE_VERSION=${COMANAGE_REGISTRY_BASE_IMAGE_VERSION} \
-t comanage-registry:$TAG .
Volumes and Data Persistence
See COmanage Registry Volumes and Data Persistence.
Environment Variables
See the list of environment variables common to all images including this image.
Authentication
This image supports using Apache HTTP Server Basic Auth (Basic Auth) as the authentication mechanism. To aid simple deployments for evaluating and learning COmanage Registry a password file with a single user and password is included. See the section above on environment variables.
To override the default bind mount or COPY in a password file created
with the htpasswd
command line tool. For example
COPY passwords /etc/apache2/passwords
Ports
The image listens for web traffic on ports 80 and 443. All requests on port 80 are redirected to port 443.
Running
See other documentation in this repository for details on how to orchestrate running this image with other images using an orchestration tool like Docker Compose, Docker Swarm, or Kubernetes.
To run this image:
docker run -d \
--name comanage-registry \
-v /opt/comanage-registry-local:/srv/comanage-registry/local \
-p 80:80 \
-p 443:443 \
comanage-registry:3.3.3-basic-auth-develop-1
Logging
Both Apache HTTP Server and COmanage Registry log to the stdout and stderr of the container.
HTTPS Configuration
See the section on environment variables and the HTTPS_CERT_FILE
and
HTTPS_PRIVKEY_FILE
variables.
Additionally you may bind mount or COPY in an X.509 certificate file (containing the CA signing certificate(s), if any) and associated private key file. For example
COPY cert.pem /etc/apache2/cert.pem
COPY privkey.pem /etc/apache2/privkey.pem