PlaceOS Models

The database models for PlaceOS in crystal.

PlaceOS is a distributed application, with many concurrent event sources that require persistence. We use RethinkDB to unify our database and event bus, giving us a consistent interface to state and events across the system.

Configuration

Environment

Key	Description	Default
PLACE_MAX_VERSIONS	Number of versions to keep of versioned models	20
PG_HOST	Postgresql host	"localhost"
PG_PORT	Postgresql port	5432
PG_DB	Database name or PG_DATABASE	"test"
PG_USER	Database user	"postgres"
PG_PASSWORD	Database password	""
PG_QUERY	Query string, that can be used to configure pooling	""
PG_LOCK_TIMEOUT	Timeout on retrying Advisory lock in seconds	5
PG_DATABASE_URL	Or provide a Database DSN

Testing

# prune docker images if you have new migrations that need to run
# since the last time migrations image was built
docker system prune --all

# builds migrations and runs tests in a containerised env
./test

Contributing

See CONTRIBUTING.md.