Etre

Etre is an entity API for managing primitive entities with labels.

This project is still under development and should not be used for anything in production yet. We are not seeking external contributors at this time

License

Apache 2.0

Local

Build and Run

To run a local instance, first compile the binary:

cd bin/etre
go build

If you don't have MongoDB running already, start the Docker container:

cd test/docker
docker compose up

This is a single-node replica set, so currently the default Etre config won't connect properly with the Docker container. Instead, put this config in bin/etre/config.yaml:

datasource:
  url: "mongodb://127.0.0.1:27017/?replicaSet=rs0&directConnection=true"
cdc:
  datasource:
    url: "mongodb://127.0.0.1:27017/?replicaSet=rs0&directConnection=true"
entity:
  types:
    - host

You can modify the entity list if you want; this is just an example.

Then start Etre:

./etre -config config.yaml

If successful, Etre log output should end with:

2025/02/13 14:01:45.046796 server.go:152: Connected to main database
2025/02/13 14:01:45.046880 server.go:158: Connected to CDC database
2025/02/13 14:01:45.046908 api_gomux.go:169: Listening on 127.0.0.1:32084

Testing

Start MongoDB in Docker if not already started:

cd test/docker
docker compose up

Note: this Docker container uses the default MonogDB port: 27017. If your machine is already running MongoDB, be sure to stop it (or modify the port mappings in test/docker/docker-compose.yml).

Then run go test ./... from the repo root directory.