Common Test Docker Compose Hook

A Common Test hook for starting and stopping docker-compose services.

Hooks can be declared in rebar.config with ct_opts:

{ct_opts, [{ct_hooks, [docker_compose_cth]}]}.

Or, it can be done on a per-suite basis including the suite/0 function in the suite module:

suite() ->
    [{ct_hooks, [docker_compose_cth]}].

For additional methods for installing and configuring the hook check the docs

Configuration

executable_search_paths: Path to search for the docker-compose executable. If it is not set the regular path is searched as described in the docs for os:find_executable/1.
check_if_running: A string that is the name of the service to check for before running docker-compose up. If defined the hook will check if a service is already up and not call docker-compose up if it is. By default this is done by attempting exec ls in the service's container, but the command can be set to anything by passing a tuple {Service, Command}
skip_or_fail: The atom skip or fail (default is fail). If the hook is unable to bring up the service with docker-compose then the suite will either skip or fail, depending on this configuration.