This repo includes a simplified version of PeBL stack for deploying just the Marine Corps Doctrinal Publication in Epub format.
Want to view MCDP7 without all of the installation hassle? We have a live instance of PeBL with guest login available in one of the ADL sandboxes.
Deploying your own PeBL stack with this repository will have a few steps:
- Choose an LRS or deploy your own
- Stand up the
pebl-authserver - Stand up the
pebl-servicesserver and configure it to use thepebl-authserver and your desired LRS - Stand up the
pebl-readerserver and point it at thepebl-servicesserver
Each of these steps is performed with Docker and the corresponding folders all include a simple tl;dr instruction set.
For something this simple, you may be asking "Why so many steps?" The PeBL system depends on a few systems for deployment.
This is where users actually visit to use PeBL. The server itself is fairly lightweight, as the PeBL reader is built into a simple HTML page that calls on the PeBL Services machine for other functionality.
This machine handles xAPI communication and informs the PeBL Web Reader about where to send the user for Sign-On. As web-sockets are used, manual deployment typically requires that the
While PeBL can also work with Google as an auth provider, most deployments use an instance of Keycloak. In this repo, the pebl-auth folder contains instructions for standing up your own instance of Keycloak to use.
Lastly, PeBL will send xAPI statements about its usage to an LRS.
Guest users do not have statements sent about them.
While PeBL receives periodic updates for its dependencies, the codebase overall is not expected to see many feature updates or improvements in the near future. ADL maintains a slightly modified version of the original open-source PeBL project (used here), but there may still be a few quirks given the project's size and our limited resources for supporting it.
If you have any issues, feel free to reach out to [email protected] or [email protected] directly. ☕