Docker

Docker is a virtualization software used to run pre-built software images. Docker image contains a fully-operable OS, which you can modify without affecting your host OS.

Running Pinba in Docker container

In order to fetch latest version of Pinba Docker container, run the following command:

 docker pull tony2001/pinba

When docker finishes pulling the image from the Docker Hub, run it this way:

 docker run -d --net=host --name=pinba tony2001/pinba

The command above starts new container from the image 'tony2001/pinba' in detached mode and maps all the container ports (TCP 3306 for MySQL and UDP 30002 for Pinba data) to the same ports on the host machine.

Accessing the data

the MySQL database can be accessed as user `root`, without password. The data gathered by Pinba are accessible in the `pinba` database.

You might want to create a dedicated MySQL user to access it instead of always using root, as well as set a password for the root user.

Note that the MySQL client is not installed by default in the container, but it can be installed by running

  docker exec ${container_id} apt-get update
  docker exec ${container_id} apt-get -y install mysql-client

Once you have done that, it is possible to connect to the database from the host with:

  docker exec -ti ${container_id} mysql -h 127.0.0.1 -u root