Skip to content

Latest commit

 

History

History
67 lines (46 loc) · 2.47 KB

README.md

File metadata and controls

67 lines (46 loc) · 2.47 KB
Raw

Zinc Operator

This repository contains the source code for a Charmed Operator that drives Zinc on Kubernetes.

Zinc is a search engine that does full text indexing. It is a lightweight alternative to elasticsearch and runs in less than 100 MB of RAM. It uses bluge as the underlying indexing library.

It is very simple and easy to operate as opposed to elasticsearch which requires a couple dozen knobs to understand and tune.

It is a drop-in replacement for elasticsearch if you are just ingesting data using APIs and searching using kibana (Kibana is not supported with zinc. Zinc provides its own UI).

Usage

Assuming you have access to a bootstrapped Juju controller on Kubernetes, you can simply:

$ juju deploy zinc-k8s

You can monitor the deployment of Zinc using juju status. Once the application displays status active, you can go ahead and browse to the IP address of Zinc. Before that, you'll need to fetch the auto-generated password to login (example output):

$ juju list-secrets
ID                    Name  Owner     Rotation  Revision  Last updated
crtsfg7mp25c77uc56r0  -     zinc-k8s  never            1  28 minutes ago

$ juju show-secret --reveal crtsfg7mp25c77uc56r0

Or in a less manual fashion...

$ secret_name="$(juju list-secrets --format json | jq -r 'map_values(select(.owner=="zinc-k8s")) | keys[0]')"
$ juju show-secret --format json --reveal "$secret_name"  | jq -r 'map(.content.Data.password) | .[0]'

You can see the application address in juju status, or get it like so:

$ juju status --format=json | jq -r '.applications."zinc-k8s".address'

You should then be able to browse to http://<address>:4080 and login with the user admin.

OCI Images

This charm relies on a Chiselled ROCK.

This image is similar to a distroless image, in that it only contains the bare minimum dependencies for Zinc to run. You can see the source here.

Contributing

Please see the Juju SDK docs for guidelines on enhancements to this charm following best practice guidelines, and the contributing doc for developer guidance.