Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fabric8io/docker-maven-plugin

Maven plugin for running and creating Docker images
https://github.com/fabric8io/docker-maven-plugin

docker fabric8 java maven

Last synced: 4 days ago
JSON representation

Maven plugin for running and creating Docker images

Host: GitHub
URL: https://github.com/fabric8io/docker-maven-plugin
Owner: fabric8io
License: apache-2.0
Created: 2014-03-26T06:10:05.000Z (almost 11 years ago)
Default Branch: master
Last Pushed: 2025-01-10T16:06:24.000Z (15 days ago)
Last Synced: 2025-01-14T15:09:10.715Z (11 days ago)
Topics: docker, fabric8, java, maven
Language: Java
Homepage: https://dmp.fabric8.io
Size: 20.6 MB
Stars: 1,890
Watchers: 74
Forks: 645
Open Issues: 503
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-docker - docker-maven-plugin - A Maven plugin for running and creating Docker images by [@fabric8io](https://github.com/fabric8io) (Development with Docker / API Client)
awesome-docker - docker-maven-plugin - A Maven plugin for running and creating Docker images by [@fabric8io](https://github.com/fabric8io) (Development with Docker / API Client)
awesome-list-docker - docker-maven-plugin

README

        # docker-maven-plugin

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.fabric8/docker-maven-plugin/badge.svg?style=flat)](https://maven-badges.herokuapp.com/maven-central/io.fabric8/docker-maven-plugin/)

[![Circle CI](https://circleci.com/gh/fabric8io/docker-maven-plugin/tree/master.svg?style=shield)](https://circleci.com/gh/fabric8io/docker-maven-plugin/tree/master)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=fabric8io_docker-maven-plugin&metric=coverage)](https://sonarcloud.io/summary/new_code?id=fabric8io_docker-maven-plugin)

[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=fabric8io_docker-maven-plugin&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=fabric8io_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`](https://fabric8io.github.io/docker-maven-plugin/#docker:start)                 | Create and start containers                      | pre-integration-test    |

| [`docker:stop`](https://fabric8io.github.io/docker-maven-plugin/#docker:stop)                   | Stop and destroy containers                      | post-integration-test   |

| [`docker:build`](https://fabric8io.github.io/docker-maven-plugin/#docker:build)                 | Build images                                     | install                 |

| [`docker:watch`](https://fabric8io.github.io/docker-maven-plugin/#docker:watch)                 | Watch for doing rebuilds and restarts            |                         |

| [`docker:push`](https://fabric8io.github.io/docker-maven-plugin/#docker:push)                   | Push images to a registry                        | deploy                  |

| [`docker:remove`](https://fabric8io.github.io/docker-maven-plugin/#docker:remove)               | Remove images from local docker host             | post-integration-test   |

| [`docker:logs`](https://fabric8io.github.io/docker-maven-plugin/#docker:logs)                   | Show container logs                              |                         |

| [`docker:source`](https://fabric8io.github.io/docker-maven-plugin/#docker:source)               | Attach docker build archive to Maven project     | package                 |

| [`docker:save`](https://fabric8io.github.io/docker-maven-plugin/#docker:save)                   | Save image to a file                             |                         |

| [`docker:tag`](https://fabric8io.github.io/docker-maven-plugin/#docker:tag)                     | Tag images                                       | install                 |

| [`docker:volume-create`](https://fabric8io.github.io/docker-maven-plugin/#docker:volume-create) | Create a volume to share data between containers | pre-integration-test    |

| [`docker:volume-remove`](https://fabric8io.github.io/docker-maven-plugin/#docker:volume-remove) | Remove a created volume                          | post-integration-test   |

| [`docker:copy`](https://fabric8io.github.io/docker-maven-plugin/#docker:copy)                   | Copy files and directories from a container      | post-integration-test   |

#### Documentation

* The **[User Manual](https://fabric8io.github.io/docker-maven-plugin)** [[PDF](https://fabric8io.github.io/docker-maven-plugin/docker-maven-plugin.pdf)] has a detailed reference for all and everything.

* The [Introduction](doc/intro.md) is a high-level

  overview of this plugin's features and provides a usage example.

  provided goals and possible configuration parameters.

* [Examples](doc/examples.md) are below `samples/` and contain example

  setups that you can use as blueprints for your projects.

* [ChangeLog](doc/changelog.md) has the release history of this plugin.

* [Contributing](CONTRIBUTING.md) 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](./doc/HowToUseDockerMavenPluginSnapshotArtifacts.md).

#### 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.