Skip to content

Fork of API middleware to support LTS workflows in FOLIO -- push to github package for setup in kubernetes

Notifications You must be signed in to change notification settings

sul-dlss/folio-setae-api

 
 

Repository files navigation

Setae API

API middleware to support LTS workflows in FOLIO.

Prerequisites

Dev Quickstart

  1. Clone this repo

    git clone [email protected]:cul-it/setae-api.git
    cd setae-api
  2. Setup environment variables

    cp .env.example .env

    Replace CHANGEME placeholders in .env with appropriate values

  3. Build the Docker Image

    docker-compose build
  4. Start the Dev Environment

    docker-compose up

Once the dev environment has started, the API should be running at http://localhost.

You can visit the generated API documentation at http://localhost/docs.

Stopping the Dev Environment

docker-compose down

If running in the foreground, simply press CTRL + C

Running arbitrary commands

  • Get a shell into your running application container
    docker-compose exec api bash
    

/items/{barcode} endpoint for SpineOMatic spine labeler

Submit a GET request to the http://localhost/items/{barcode} using the barcode of a known item in your FOLIO tenant. This will return XML ready to be consumed by SpineOMatic.

Review the SpineOMatic wiki for installation and settings documentation. More specific details on configuring SpineOMatic to use this FOLIO API middleware will be provided here in the near future.

You can request the original, unmodified JSON from FOLIO using the format parameter:

http://localhost/items/{barcode}?format=json

Refer to the generated API documentation for the /items endpoint for all available parameters

Deploying to Kubernetes

After merging a branch into main, a Github action should generate a new image for deployment in a FOLIO Kubernetes cluster. To deploy the pod, run the following commands from the FOLIO Helm repository:

  • Uninstall the pod helm -n $namespace uninstall setae-api
  • Re-install the pod helm -n $namespace upgrade -f {path-to-folio-k8s}/setae-api/setae-api-folio-test.yaml setae-api setae-api/

About

Fork of API middleware to support LTS workflows in FOLIO -- push to github package for setup in kubernetes

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Python 60.0%
  • XSLT 37.7%
  • Dockerfile 2.3%