Crux S3 — juxt/crux-core 20.09-1.11.1-beta-SNAPSHOT

Crux S3

You can use AWS’s Simple Storage Service (S3) as Crux’s 'document store'.

Project Dependency

In order to use S3 within Crux, you must first add S3 as a project dependency:

deps.edn

juxt/crux-s3 {:mvn/version "20.09-1.11.0-beta"}

pom.xml

<dependency>
    <groupId>juxt</groupId>
    <artifactId>crux-s3</artifactId>
    <version>20.09-1.11.0-beta</version>
</dependency>

Using S3

Replace the implementation of the document store with crux.s3/->document-store

{:crux.document-store {:crux/module 'crux.s3/->document-store
                       :bucket "your-bucket"
                       ...}}

Parameters

configurator (S3Configurator)
bucket (string, required)
prefix (string): S3 key prefix
doc-cache-size (int): size of in-memory document cache

Configuring S3 requests

This is unfortunately currently only accessible from Clojure - we plan to expose it outside of Clojure soon.

While the above is sufficient to get crux-s3 working out of the box, there are a plethora of configuration options in S3 - how to get credentials, object properties, serialisation of the documents, etc. We expose these via the crux.s3.S3Configurator interface - you can supply an instance using the following in your node configuration.

Through this interface, you can supply an S3AsyncClient for crux-s3 to use, adapt the PutObjectRequest/GetObjectRequest as required, and choose the serialisation format. By default, we get credentials through the usual AWS credentials provider, and store documents using Nippy.

Clojure

{:crux.document-store {:crux/module 'crux.s3/->document-store
                       :configurator (fn [_]
                                       (reify S3Configurator
                                         ...)
                       ...}}