Page Comparison

(this is a draft)

...

1. Install Java JDK 11

2. Install IDEA as IDE : https://www.jetbrains.com/idea/

3. Install last version of Vagrant : https://www.vagrantup.com/
4. Install VirtualBox : https://www.virtualbox.org/
5. Install Postman: https://www.postman.com/
6. Clone from git modules and add all of them in one IDEA project
   
   • ThunderJet back-end modules : mod-orders, mod-orders-storage, mod-invoice, mod-invoice-storage, mod-finance, mod-finance-storage, mod-organizations, mod-organizations-storage, mod-gobi, edge-orders, edge-common, mod-ebsconet, acq-models
   • Modules with integration tests: folio-integration-tests(Karate), folio-api-tests(Postman)
7. Up FOLIO platform by using one of the box  :
   • Back-end + UI : https://app.vagrantup.com/folio/boxes/testingOnly Back-End : https://app.vagrantup.com/folio/boxes/testing-backendsnapshot
   • See build times at https://dev.folio.org/guides/automation/#reference-environments
8. Configure VitualBox and IDEA for running FOLIO microservice from IDEA : How to run folio backend modules with IntelliJ Idea and interact with Vagrant box environment

...

Here is a zip with all the Postman collections to deploy modules.

• "FOLIO VAGRANT local.postman_environment.json" → All request in the Postman collections use variables from Environment configuration.

Please import this environment configuration with predefined values of variables : {{protocol}}, {url}}, {{okapiport}}

• "Add okapi permission to diku_admin.postman_collection.json" →  After you started VagrantBox, then you should add "okapi.all" permission to give ability to deploy modules by "diku_admin" user. 

• "Redeploy-invoice-storage-module.postman_collection.json" → Please use this collection to deploy mod-invoice-storage

Deployment Steps

1. On Linux, use this first:
   sudo ifconfig lo:1 10.0.2.15 up
sudo ifconfig lo:0 10.0.2.2 up

2. Assign “okapi.all” permission for diku_admin
   

3. Login
   

4. Build mod-invoice-storage module : mvn clean install. As a result target/ModuleDescriptor.json is created, which will be used as deployment descriptor for your microservice.

5. Copy ModuleDescriptor.json into body of “POST Module Descriptor” and run request
   

6. Run module from IDEA
   

7. Let OKAPI (Api Getway and discovery server) know were is your microservice by send request
   
   Important:

   • “srvcId” and “id” from deployment descriptor must be the same

   • Port in “url” must be the same with port from IDEA configuration “-Dhttp.port=8097”

8. Make the microservice accessible from the outside and allow access to it
   

9. If everythigs fine – start using APIs

...