NAME
    Test::Docker::MySQL is a module to launch MySQL in docker containers.

SYNOPSIS
        # You have to setup docker manually before you use this (see SETUP section)

        $ENV{DOCKER_HOST} ||= 'tcp://192.168.59.103:2375'; # optional

        use Test::Docker::MySQL;
        my $dm_guard = Test::Docker::MySQL->new;

        my $port_1 = $guard->get_port; # get a mysql container port
        my $port_2 = $guard->get_port; # get another mysql container port

        my $dsn_1 = "dbi:mysql:database=mysql;host=127.0.0.1;port=$port_1";
        my $dbh_1 = DBI->connect($dsn , 'root', '', { RaiseError => 1 });

        my $dsn_2 = "dbi:mysql:database=mysql;host=127.0.0.1;port=$port_2";
        my $dbh_2 = DBI->connect($dsn , 'root', '', { RaiseError => 1 });

        undef $dm_guard; # dispatch `docker kill $container` command

DESCRIPTION
    Test::Docker::MySQL is a module to launch MySQL in docker containers.

METHODS
  "new"
    All parameters are optional.

    "tag"
        The tag to launch via Docker. Default value is
        "punytan/p5-test-docker-mysql".

    "ports"
        Specify port range by "ports">. Default value is "[ 55500 .. 55555
        ]",

  "get_port"
    Returns allocated port.

SETUP
  OSX
    Install boot2docker and docker
        You can find the binary at
        <https://github.com/boot2docker/osx-installer/releases>.

    Initialize boot2docker
            $ boot2docker download && boot2docker init && boot2docker up

    Configure port forwarding
            $ boot2docker down
            $ for i in {55500..55555}; do
                VBoxManage modifyvm "boot2docker-vm" --natpf1 "tcp-port$i,tcp,,$i,,$i";
                VBoxManage modifyvm "boot2docker-vm" --natpf1 "udp-port$i,udp,,$i,,$i";
            done
            $ boot2docker up

    Pull docker images for this module
            $ docker pull punytan/p5-test-docker-mysql

CHEATSHEET
  Clean up containers
        $ docker kill $(docker ps -a -q)
        $ docker rm   $(docker ps -a -q)

DEBUGGING
    Set "DEBUG_TEST_DOCKER_MYSQL" as true to get verbose log generated by
    this module.

AUTHOR
    punytan <punytan@gmail.com>

COPYRIGHT
    Copyright 2014- punytan

LICENSE
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

SEE ALSO
    Test::mysqld

