You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Introduction

 

Welcome to the first milestone of the Fedora API Extensions (API-X) framework.   This milestone is the first concrete implementation of API-X, and is accompanied by a set of evaluation tasks comprising a demo that showcases its current capabilities and serves as a basis for soliciting feedback from the community.


The API-X framework positions itself as HTTP middleware in a repository ecosystem.  It serves as a transparent mechanism to expose services that act on repository resources, and/or to mediate the interaction between a client and a repository resources vis à vis services.  Existing ad hoc services may be seamlessly discovered and interacted with by clients; likewise, novel services may be authored and incorporated into the ecosystem.  See The demo includes services provided by Amherst College, and will demonstrate the capability of API-X to incorporate these services into the repository layer.
The API-X codebase has matured to the point of producing this milestone, but should not be mistaken as production ready just yet. In particular, very little importance has been paid to optimization.  We would appreciate if you let us know of any issues or suggestions encountered performing the tasks, especially if they would prevent you deploying API-X in production.  Furthermore, the topology of the services distributed in the milestone shouldn't be taken as an endorsement of any particular deployment strategy.  

Demo Environment

The API-X milestone demo uses the docker environment to package pre-configured instances of Fedora, API-X, and services into lightweight "containers" that behave much as if they were deployed in separate virtual machines.    docker-compose is used to run the demo on an evaluator's local machine.  Using docker-compose, the demo environment can be created, paused/resumed, or wiped clean at any point.  


Please read the docker setup guide for information on how to install and verify Docker on your own machine

Providing feedback

Please provide general feedback or questions on the demo in the form of comments on this page.  

Bugs and/or feature requests can be submitted on github.  We will try to fix any bugs affecting the demo as soon as possible, and incorporate fixes into the docker images so that they can be pulled into your demo environment as soon as they are available.   Feature or improvement requests on github are especially welcome.

Evaluation Tasks

We have created a number of evaluation tasks to guide evaluators through the API-X demo.  Most (but not all) current API-X features are encountered in one form or another in the demo tasks.  The tasks do not have to be done linearly, and they do not have to be done all at once.  The tasks are described in detail by following the links in the below outline 

  1. Resources, URIs, and Proxies
    1. Look at a Fedora object via direct and proxy URIs in order to compare and contrast representations
    2. Look at proxied binary resources
  2. Service Documents
    1. Retrieve and analyze a service document
    2. Look for a specific service
  3. Interacting with exposed services
    1. A passive resource-scoped service (i.e. just use a GET on a service endpoint to get FITS-extracted metadata)
    2. Links within exposed services
    3. Query parameters (explore a fascinating image manipulation extension based on ImageMagick)
  4. Loading and deploying extensions
    1. A tour of the service registry
    2. The loader extension
    3. Loading an extension manually
    4. Auto-loading extensions (see how services can self-register themselves and the extensions they implement)
  5. Ontologies and Binding
    1. Simple binding by rdf:type
    2. Binding by inference
    3. Extensions as ontologies
    4. The ontology registry

Participation

We need participants!

If anyone is interested in evaluating the demo when it is released in order to provide valuable feedback, please place your name as an participant on this page, and/or stay tuned for further communication.  We are asking participants to 1) provide feedback on the content of the evaluation tasks and guide (e.g. are there tasks we are missing?) and 2) download the demo and execute the tasks, and provide feedback on the experience.

Please sign up by listing your information below, and help us understand a little bit about yourself.  For example, your institution (if not already linked from your wiki profile), what you do, and the role you are playing within the context of API-X evaluation (e.g. stakeholder, developer, user experience, systems operations, etc.).

 

Elliot Metsger - Johns Hopkins, Software Engineer, API-X stakeholder and developer

Ruth Duerr - Ronin Institute for Independent Scholarship, API-X stakeholder, Data Manager/Informaticist, ex-operations manager, ex-archive manager, ex-systems engineer, ex-software engineer & developer

Joshua Westgard - University of Maryland Libraries, API-X stakeholder, repository application manager

  • No labels

All content on the LYRASIS Wiki is licensed under the CC BY (Attribution) license, unless otherwise noted.