docker-maven-plugin
This is a Maven plugin for building Docker images and managing containers for integration tests. It works with Maven 3.0.5 and Docker 1.6.0 or later.
Goals
| Goal | Description | Default Lifecycle Phase |
|---|---|---|
docker:start |
Create and start containers | pre-integration-test |
docker:stop |
Stop and destroy containers | post-integration-test |
docker:build |
Build images | install |
docker:watch |
Watch for doing rebuilds and restarts | |
docker:push |
Push images to a registry | deploy |
docker:remove |
Remove images from local docker host | post-integration-test |
docker:logs |
Show container logs | |
docker:source |
Attach docker build archive to Maven project | package |
docker:save |
Save image to a file | |
docker:volume-create |
Create a volume to share data between containers | pre-integration-test |
docker:volume-remove |
Remove a created volume | post-integration-test |
docker:copy |
Copy files and directories from a container | post-integration-test |
Documentation
- The User Manual [PDF] has a detailed reference for all and everything.
- The Introduction is a high-level overview of this plugin's features and provides a usage example. provided goals and possible configuration parameters.
- Examples are below
samples/and contain example setups that you can use as blueprints for your projects. - ChangeLog has the release history of this plugin.
- Contributing explains how you can contribute to this project. Pull requests are highly appreciated!
- We publish nightly builds on maven central. Read How to use Docker Maven Plugin Snapshot artifacts.
Docker API Support
- Docker 1.6 (v1.18) is the minimal required version
- Docker 1.8.1 (v1.20) is required for
docker:watch - Docker 1.9 (v1.21) is required for using custom networks and build args.