NOTE: This repository is deprecated. Instead see https://dev.folio.org/tutorials/curriculum/
This is an outline of a tutorial that can be given to a group in a workshop or followed by an individual developer in a self-paced fashion.
- Set up a running instance of the Stripes Development UI Server
- Set up a running instance of Okapi Gateway
- Demonstrate how to deploy an Okapi Module to a tenant in Okapi Gateway and the Stripes UI Server
- Understand how Okapi Gateway routes requests to modules
There are two choices: either running the Stripes Development UI Server and the Okapi Gateway directly on a developer’s machine (“on-machine”) or running Stripes and Okapi in a VirtualBox guest. An Ansible playbook with appropriate roles is used to create the VirtualBox guest, and can also be used to automatically build a developer’s environment (making the playbook target localhost).
- macOS 10.? or higher (On-machine or VirtualBox)
- Windows 10 or higher (VirtualBox required)
- Linux (On-machine or VirtualBox)
Before attending the workshop, participants must meet these requirements. When in doubt, using the VirtualBox guest machine is recommended.
- Java 8 JDK 1.8.0-101 or higher
- Maven 3.3.9 or higher
- Node.js 6.x or higher
- Yarn package manager v0.20.3 or higher
- curl
- VirtualBox 5.1 or higher
- Vagrant 1.9.1 or higher, for Windows 7 use 1.9.6 .msi (learn why)
To download the VirtualBox guest:
- Make a clean directory and change into it:
mkdir folio-curriculum && cd folio-curriculum
- Set up the Vagrantfile:
vagrant init --minimal folio/curriculum
- Launch the VirtualBox guest:
vagrant up
- Connect to the VirtualBox guest:
vagrant ssh
Note: Do this download prior to attending a workshop. If also doing Lesson 6 then get it ready beforehand too.
Other instructions and commands that are specific to the VirtualBox guest mode of using the tutorial are noted using this style of information box.
There are some FOLIO-related Vagrant tips, known issues, and troubleshooting notes available.
Each lesson assumes the existence of a $FOLIO_ROOT
shell variable.
This variable holds the path to a directory where the components of the Okapi Server and the Stripes Development UI Server are located.
The first command below connects from the VirtualBox host to the VirtualBox guest.
The second command changes the working directory to the shared vagrant
directory.
$ vagrant ssh
$ cd /vagrant
Create the directory, enter the directory, and save the directory location using these commands:
$ mkdir folio-tutorial-working-files
$ cd folio-tutorial-working-files
$ export FOLIO_ROOT=`pwd`
Each time that you open a new shell terminal window, do those latter two steps to set $FOLIO_ROOT
.
- Clone, build and explore Okapi
- Initialize Okapi Gateway from the command line
- Enable Okapi Authentication
- Deploy test Stripes package
- Real-world application: set up the FOLIO Users app
- Interact with the FOLIO Stable VM
To view the documentation locally:
- (once)
git clone [email protected]/folio-org/curriculum.git folio-curriculum && cd folio-curriculum && bundle install
bundle exec jekyll serve
- View the site locally at http://localhost:4000/curriculum/
See project FOLIO at the FOLIO issue tracker.
Other FOLIO Developer documentation is at dev.folio.org