Skip to content

Latest commit

 

History

History
43 lines (32 loc) · 1.41 KB

QUICKSTART.md

File metadata and controls

43 lines (32 loc) · 1.41 KB

Quickstart

We provide docker-compose.yml file to quickly try temBoard with a few PostgreSQL clusters. Requires docker-compose 1.10+ and docker engine 1.10+.

wget https://raw.githubusercontent.com/dalibo/temboard/master/docker/docker-compose.yml
docker-compose up

docker-compose will launch:

  • a PG 9.4 cluster (exposed at 5433)
  • a PG 9.5 cluster (exposed at 5434)
  • a PG 9.6 cluster (exposed at 5435)
  • a temBoard agent for each PG cluster
  • a standard PG 9.6 cluster for the UI (not exposed)
  • a container for temBoard UI

temBoard UI is available on https://0.0.0.0:8888/ with admin / admin credentials. The agents can be accessed with alice / alice or bob / bob.

You can access clusters with user and password postgres. For example with pgbench:

$ export PGHOST=0.0.0.0 PGPORT=5433 PGUSER=postgres PGPASSWORD=postgres
$ pgbench -i
$ pgbench -c 8 -T 60

/!\ DO NOT USE THIS IN PRODUCTION /!\

temBoard docker images are designed for testing and demo. The SSL certificate is self-signed and the default passwords are dumb and public.

temBoard agent is designed to run on same host as PostgreSQL which is incompatible with Docker service-minded architecture. temBoard agent images require access to docker socket to restart PostgreSQL, which you do not want in production.

To deploy temBoard in a production environment, take some time to read http://temboard.rtfd.io.