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.