islandora/fcrepo repository overview

⁠Fcrepo

Docker image for fcrepo⁠ version 7.0.0.

Built from Islandora-DevOps/isle-buildkit fcrepo⁠

Please refer to the Fcrepo Documentation⁠ for more in-depth information.

As a quick example this will bring up an instance of fcrepo⁠, and allow you to view on http://localhost:80/fcrepo/⁠.

docker run --rm -ti -p 80:80 islandora/fcrepo

⁠Dependencies

Requires islandora/tomcat Docker image to build. Please refer to the Tomcat Image README⁠ for additional information including additional settings, volumes, ports, etc.

⁠Volumes

⁠Settings

⁠Confd Settings

To allow external content⁠ provide sites as key pairs. Wherein multiple values is the url and the 'name' is a key that replaces the '*' symbol below.

⁠Database Settings

fcrepo⁠ can optionally make use of a database for object storage. Please see the documentation in the base image⁠ for more information about the default database connection configuration.

The following settings are only used if FCREPO_PERSISTENCE_TYPE is set to mysql or postgresql.

Additionally the DB_DRIVER variable is derived from the FCREPO_PERSISTENCE_TYPE so users do not need to specify it separately.

⁠JWT Settings

fcrepo⁠ makes use of JWT for authentication. Please see the documentation in the base image⁠ for more information about the default JWT configuration.

⁠Tomcat Settings

Fcrepo is deployed in as a servlet in Tomcat. Please see the documentation in the tomcat image⁠ for more information.

⁠Updating

You can change the version used for fcrepo⁠ by modifying the build argument FCREPO_VERSION and FCREPO_SHA256 in the Dockerfile.

Change FCREPO_VERSION and then generate the FCREPO_SHA256 with the following commands:

FCREPO_VERSION=$(cat fcrepo/Dockerfile | grep -o 'FCREPO_VERSION=.*' | cut -f2 -d=)
FCREPO_FILE=$(cat fcrepo/Dockerfile | grep -o 'FCREPO_FILE=.*' | cut -f2 -d=)
FCREPO_URL=$(cat fcrepo/Dockerfile | grep -o 'FCREPO_URL=.*' | cut -f2 -d=)
FCREPO_FILE=$(eval "echo $FCREPO_FILE")
FCREPO_URL=$(eval "echo $FCREPO_URL")
wget --quiet "${FCREPO_URL}"
shasum -a 256 "${FCREPO_FILE}" | cut -f1 -d' '
rm "${FCREPO_FILE}"

You can change the version used for Syn⁠ by modifying the build arguments SYN_VERSION and SYN_REF in the Dockerfile.

By default, the image fetches refs/heads/${SYN_VERSION} from the Syn repository and builds it with ./gradlew. To build a tagged Syn release artifact instead, set SYN_VERSION, SYN_REF=refs/tags/v${SYN_VERSION}, and SYN_SHA256 for that tag's release artifact.

You can change the version used for fcrepo-import-export⁠ by modifying the build argument IMPORT_EXPORT_VERSION and IMPORT_EXPORT_SHA256 in the Dockerfile.

Change IMPORT_EXPORT_VERSION and then generate the IMPORT_EXPORT_SHA256 with the following commands:

IMPORT_EXPORT_VERSION=$(cat fcrepo/Dockerfile | grep -o 'IMPORT_EXPORT_VERSION=.*' | cut -f2 -d=)
IMPORT_EXPORT_FILE=$(cat fcrepo/Dockerfile | grep -o 'IMPORT_EXPORT_FILE=.*' | cut -f2 -d=)
IMPORT_EXPORT_URL=$(cat fcrepo/Dockerfile | grep -o 'IMPORT_EXPORT_URL=.*' | cut -f2 -d=)
IMPORT_EXPORT_FILE=$(eval "echo $IMPORT_EXPORT_FILE")
IMPORT_EXPORT_URL=$(eval "echo $IMPORT_EXPORT_URL")
wget --quiet "${IMPORT_EXPORT_URL}"
shasum -a 256 "${IMPORT_EXPORT_FILE}" | cut -f1 -d' '
rm "${IMPORT_EXPORT_FILE}"

You can change the version used for fcrepo-upgrade-utils⁠ by modifying the build argument UPGRADE_UTILS_VERSION and UPGRADE_UTILS_SHA256 in the Dockerfile.

Change UPGRADE_UTILS_VERSION and then generate the UPGRADE_UTILS_SHA256 with the following commands:

UPGRADE_UTILS_VERSION=$(cat fcrepo/Dockerfile | grep -o 'UPGRADE_UTILS_VERSION=.*' | cut -f2 -d=)
UPGRADE_UTILS_FILE=$(cat fcrepo/Dockerfile | grep -o 'UPGRADE_UTILS_FILE=.*' | cut -f2 -d=)
UPGRADE_UTILS_URL=$(cat fcrepo/Dockerfile | grep -o 'UPGRADE_UTILS_URL=.*' | cut -f2 -d=)
UPGRADE_UTILS_FILE=$(eval "echo $UPGRADE_UTILS_FILE")
UPGRADE_UTILS_URL=$(eval "echo $UPGRADE_UTILS_URL")
wget --quiet "${UPGRADE_UTILS_URL}"
shasum -a 256 "${UPGRADE_UTILS_FILE}" | cut -f1 -d' '
rm "${UPGRADE_UTILS_FILE}"