Skip to content

Indexer APIs for ingesting Geonetwork 4 metadata records into Elasticsearch index that queried by the new AODN Portal

License

Notifications You must be signed in to change notification settings

aodn/es-indexer

Repository files navigation

es-indexer - Elasticsearch Indexer

ESGN_Indexer

This es-indexer for ingesting GeoNetwork4 metadata records into an Elasticsearch index. The index schema adheres to the STAC schema but includes some customisations.

Although GeoNetwork4 itself comes with a default Elasticsearch index (gn_records), the OGC APIs will use the es-indexer-created index to retrieve data for the new AODN portal.

Development

This application is built with Spring Boot 3 and Java 17.

There are required environment variables to run the es-indexer:

# Client calling the Indexer API must provide this token in the Authorization header, these value is set
# in [appdeply](https://github.com/aodn/appdeploy/blob/main/tg/edge/es-indexer/ecs/variables.yaml) for edge env
# under environment_variables:

APP_HTTP_AUTH_TOKEN=sampletoken

SERVER_PORT=8080

ELASTICSEARCH_INDEX_NAME=sampleindex
ELASTICSEARCH_SERVERURL=http://localhost:9200
ELASTICSEARCH_APIKEY=sampleapikey

GEONETWORK_HOST=http://localhost:8080

Maven build

$ mvn clean install # [-DskipTests]

If you do not use -DskipTests, then autotest will run where it will create a docker geonetwork instance, inject the sample data and then run the indexer. You can treat this as kind of integration testing.

This project container 3 submodules:

  • geonetwork - This is used to compile JAXB lib to handle XML return from GEONetowrk, it is iso19115 standard
  • stacmodel - A group of java class that create the STAC json which store in elastic search, so if app needs to read STAC from elastic, use this lib
  • indexer - The main app that do the transformation.

Docker

Start a local instance of indexer

$ docker-compose -f docker-compose-dev.yaml up # [-d: in daemon mode | --build: to see the console logs]

Notes on calculation - Centroid

We pre-calculate the centroid point of each spatial extents using the following method

  1. Use the shape file contains the land only area, adjust it to reduce the line complexity
  2. Remove the land from the spatial extents
  3. Then cut the spatial extents into grid and may result in multiple polygon
  4. In each grid, calculate the centroid, if it is outside of the polygon (aka a U shape), use internal point.
  5. Store the point in the centroid attribute.

Endpoints:

Description Endpoints Environment
Logfile /manage/logfile Edge
Beans info /manage/beans Edge
Env info /manage/env Edge
Info (Show version) /manage/info Edge
Health check /manage/health Edge
POST/GET/DELETE against specific record /api/v1/indexer/index/{records-uuid} All
Bulk index /api/v1/indexer/index/all All
Bulk index Async `/api/v1/indexer/index//async/all All
Swagger UI: /swagger-ui/index.html All

The 'async/all' endpoints use SSE (Server Side Events) to avoid gateway timeout, you should use postman version 10.2 or above (there is a bug with SSE for previous version), or use the web based postman (pref), once you issue the call, you should see event come back in the body at regular time.

The call header should contains

  • X-API-Key (Check with dev)
  • Accept = text/event-stream
  • Content-Type = text/event-stream;charset=utf-8
  • Method = POST

About

Indexer APIs for ingesting Geonetwork 4 metadata records into Elasticsearch index that queried by the new AODN Portal

Resources

License

Stars

Watchers

Forks

Packages

No packages published