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 https://github.com/ukwa/ukwa-pywb/issues/74 is complete.

• [x] Confirm required network location. Do we need to be on the Access VLAN?
• [x] Ensure staff access can be separated out. May require separate IP address.
• [x] 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.
• [x] 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).
• [x] @anjackson Add NGINX rules to map expected URLs to PyWB URLs.
• [x] @anjackson Add LOCKS_AUTH=admin:password
• [ ] @anjackson Add in known test cases for manual testing below.
• [x] @anjackson Allow access to the multi-cluster WARC Server as warc-server.api.wa.bl.uk
• [ ] @anjackson https://github.com/ukwa/ukwa-pywb/issues/77
• [ ] @anjackson https://github.com/ukwa/ukwa-pywb/issues/78
• [ ] https://github.com/ukwa/docker-robot-framework/issues/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.