ISLE 8 - Recast image

Designed to used with:

• The isle-recast container and docker-compose service
• The Drupal 8 site
• The isle-fcrepo container
• The isle-mariadb container
• The isle-gemini container

Based on:

• Official PHP Apache image: php:7.4.3-apache

Contains and includes:

• Composer
• Recast

MVP 3 sprint

Building

There are two build arguments that you must provide in order to build this container:

• RECAST_JWT_ADMIN_TOKEN - An easy to remember token to replace an actual JWT when testing (usually "islandora")
• RECAST_LOG_LEVEL - Logging level for the Recast microservice (DEBUG, INFO, WARN, ERROR, etc...)

In order to build, run this command

• docker build -t isle-recast --build-arg RECAST_JWT_ADMIN_TOKEN=islandora --build-arg RECAST_LOG_LEVEL=DEBUG .

Or if you've defined the build args as environment variables already, simply

• docker build -t isle-recast --build-arg RECAST_JWT_ADMIN_TOKEN --build-arg RECAST_LOG_LEVEL .

Running

To run the container, you'll need to bind mount two things:

• A public key from the key pair used to sign and verify JWT tokens at /opt/keys/public.key

• A php.ini file with output buffering enabled at /usr/local/etc/php/php.ini

• docker run -d -p 8000:8000 -v /path/to/public.key:/opt/keys/public.key -v /path/to/php.ini:/usr/local/etc/php/php.ini isle-recast

Testing

To test Recast, you can issue a curl command against it to verify its endpoints are working. For example, to run identify on the Islandora logo:

• curl -H "Authorization: Bearer islandora" -H "Apix-Ldp-Resource: https://islandora.ca/sites/default/files/Islandora.png" idcp.localhost:8000/Recast

Note the the Authorization header contains the RECAST_JWT_ADMIN_TOKEN value after Bearer.