dserver plugin for receiving s3 notifications on updated objects.
Project description
GitHub: https://github.com/livMatS/dserver-notification-plugin
PyPI: https://pypi.python.org/pypi/dserver-notification-plugin
Free software: MIT License
Features
Listen to S3 event notifications from an S3-compatible storage backend
Introduction
dtool is a command line tool for packaging data and metadata into a dataset. A dtool dataset manages data and metadata without the need for a central database.
However, if one has to manage more than a hundred datasets it can be helpful to have the datasets’ metadata stored in a central server to enable one to quickly find datasets of interest.
dservercore provides a web API for registering datasets’ metadata and provides functionality to lookup, list and search for datasets.
This plugin enables the dserver to listen to notifications for the registration and deregistration of datasets.
Installation
Install the dtool lookup server dependency graph plugin
$ pip install dserver-notification-plugin
Setup and configuration
Configure plugin behavior
The plugin needs to know how to convert a bucket name into a base URI. The environment variable DSERVER_NOTIFY_BUCKET_TO_BASE_URI is used to specify that conversion, e.g.:
DSERVER_NOTIFY_BUCKET_TO_BASE_URI={"bucket": "ecs://bucket"}
It is also advisable to limit access to the notification listener to a certain IP range. Use:
DSERVER_NOTIFY_ALLOW_ACCESS_FROM=192.168.0.0/16
to specify the allowed remote network. To specify a single IP, use:
DSERVER_NOTIFY_ALLOW_ACCESS_FROM=192.168.1.1/32
Configure elastic search integration in NetApp StorageGRID
Create a new endpoint with URI https://myserver:myport/elastic-search and URN arn:<mysite>:es:::<domain-name>/notify/all
Note that <mysite> and <domain-name> can be chose arbitrarily. notify/all is appended to the URI and must point to the route of the notify function.
The bucket needs to be configured to support search integration. Use the following XML template
<MetadataNotificationConfiguration>
<Rule>
<ID>dtool</ID>
<Status>Enabled</Status>
<Prefix></Prefix>
<Destination>
<Urn>urn:mysite:es:::domain-name/notify/all</Urn>
</Destination>
</Rule>
</MetadataNotificationConfiguration>
Configure webhook in minio
The Publish Events to Webhook minio docs walks through the configuration for sending S3 event notifications to a webhook. Assuming a dserver with this plugin activated running at http://dserver:5000, and your minio instance with a bucket test-bucket at https://s3server:9000, use
# mc: minio client
mc config host add s3server http://s3server:9000 {admin_user} {admin_password}
# Note that the endpoint must be reachable when configuring, otherwise minio will reject
mc admin config set s3server/ notify_webhook:dtool endpoint="http://dserver:5000/webhook/notify"
mc admin service restart s3server # restart is necessary
# Activate the actual notifications
mc event add s3server/test-bucket arn:minio:sqs::testbucket:dtool --event "put,delete"
to configure a webhook endpoint identified by dtool and activate put and delete event notification. Choose the parameters for --event "put,delete" from minio’s Supported Bucket Evenets.
Note that minio is very strict on whom they talk to. If your dserver communicates via https, make sure that the server certificate uses SANs and that the signing authority’s root certificate is available to minio. See Install Certificates from Third-party CAs in the minio docs. Also assure all services are reachable by valid hostnames. Within a containerized environment such as launched with docker-compose , host names containing underscores _ may occur, but minio refuses to speak with such.
Configure webhook in NetApp StorageGRID
NetAPP StorageGRID is able to submit S3 event notifications when configured to communicate with an SNS endpoint, refer to the according sections of the NetApp StorageGRID docs for creating service endpoints and configuring event notifications.
In short, create an endpoint `http://dserver:5000/webhook/notify` with a suitable URN, i.e. urn:dserver:sns:region:notify:all, where you may pick all fields freely except urn and sns.
Next, enable event notifications for the desired bucket, i.e. for object creation events with a policy snippet like this:
<NotificationConfiguration>
<TopicConfiguration>
<Id>Object created</Id>
<Topic>urn:dserver:sns:region:notify:all</Topic>
<Event>s3:ObjectCreated:*</Event>
</TopicConfiguration>
</NotificationConfiguration>
Testing
Launch a minimal mongodb instance with
$ cd tests/container && docker-compose up -d
and run tests from within repository root using
pytest --log-cli-level=DEBUG
Refer to .github/workflows/test.yml for the recommended testing environment.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dserver_notification_plugin-0.4.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 22606381e6747d41188f84ba65551b2c3eb691c65e9a8c977e7bf9391aafcfe1 |
|
MD5 | 28ab901e8ec7d938a57bbbe3d19b220d |
|
BLAKE2b-256 | 0d3618f4c57fb7214bb34bcdc1a7e23edf3c3cb83a0629f3861c7d9a0fc1d26a |
Hashes for dserver_notification_plugin-0.4.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ce442ba2074326130b96b64e7423b621bf913ec3ca0ba36fa33f3f5d084e973b |
|
MD5 | 57e58a7af6d6ab76fd62ed15f4cc603d |
|
BLAKE2b-256 | 3a5fded593f7ab33ddad05c42312132ef93a2ce03a376062d9f6087f30a6a871 |