Document how to deploy the PyWB-backed NPLD Access System

[anjackson]

This covers the deployment files and documentation for running the PyWB reading room services as a Docker Swarm service stack. The documentation starts at: https://github.com/ukwa/npld-access-stack#readme

Note that, at this time, PDF and ePubs are not handled properly. PDFs will be rendered in the browser directly, for example. This will remain the case until ukwa/ukwa-pywb#74 is complete.

• Confirm required network location. Do we need to be on the Access VLAN?
• Ensure staff access can be separated out. May require separate IP address.
• Understand various redundancies/backup services needed.
• Verify assumption that all failover redirection, SSL encryption, authentication, token validation or user identification are handled upstream.
• Understand reporting needs and whether this is all handled upstream.
• Configure logging as appropriate.
• Consider training options, e.g. this
• If offline installation needed, @anjackson to document how that can be done (following this example or this one that does multiple images).
• @anjackson Add NGINX rules to map expected URLs to PyWB URLs.
• @anjackson Add LOCKS_AUTH=admin:password
• @anjackson Add in known test cases for manual testing below.
• @anjackson Allow access to the multi-cluster WARC Server as warc-server.api.wa.bl.uk
• @anjackson Lock view page does not show current lock state correctly ukwa-pywb#77
• @anjackson Flashing text selection bug ukwa-pywb#78
• Create tests to check the Reading Room Wayback (rrwb) service is working as expected. docker-robot-framework#6

[anjackson]

The documentation has been drafted and checked by @ldbiz and @GilHoggarth. Passed to App Support for feedback.

[anjackson]

Note that this work continues in an internal repository that gets mirrored at: https://github.com/ukwa/npld-access-stack

That should be added into ukwa-services as a git submodule, replacing access/rrwb.