Motonori Iwata
and 2 contributors

NAME

Test::Docker::Image - It's new $module, this can handle a Docker image for tests.

SYNOPSIS

    use Test::Docker::Image;

    my $mysql_image_guard = Test::Docker::Image->new(
        container_ports => [3306],
        tag             => 'iwata/centos6-mysql51-q4m-hs',
    );

    my $port = $mysql_image_guard->port(3306);
    my $host = $mysql_image_guard->host;

    `mysql -uroot -h$host -P$port -e 'show plugins'`;
    undef $mysql_image_guard; # destroy a guard object and execute docker kill and rm the container.

DESCRIPTION

Test::Docker::Image is a module to handle a Docker image.

METHODS

new

return an instance of Test::Docker::Image, this instance is used as a guard object.

tag

This is a required parameter. This specify a tag of Docker image for docker run.

container_ports

This is a required parameter. This specify some port numbers that publish a container's port to the host.

boot

This is an optional parameter. You set a boot module name. Boot module must extend Test::Docker::Image::Boot.

sleep_sec

This is a optional parameter. Wait seconds after docker run, because you can't access container immediately.

port

Return a port number, this Docker image use number for port forwarding.

host

Return an IP address of Docker host.

LICENSE

Copyright (C) iwata-motonori.

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

AUTHOR

Motonori Iwata <gootonroi+github@gmail.com>