Skip to content
Lightweight Java Docker client
Java Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
rcfg added release config for maven central Feb 22, 2018
src Merge branch '__rultor' Aug 20, 2019
.0pdd.yml Update .0pdd.yml Jan 9, 2019
.gitattributes cleaned meta stuff Jan 28, 2018
.gitignore (#171) IdentityToken Nov 11, 2018
.rultor.yml Update .rultor.yml May 29, 2018
.travis.yml Update .travis.yml Apr 2, 2019
CONTRIBUTING.md Update CONTRIBUTING.md Aug 24, 2018
LICENSE Updating Copyright headers Jan 9, 2019
README.md Updated itcases setup Aug 1, 2019
checkstyle.xml LocalDocker implemented Feb 4, 2018
pom.xml 0.0.11-SNAPSHOT Feb 22, 2019
rcfg.sh Update rcfg.sh Sep 5, 2019

README.md

docker-java-api

Managed by Zerocrat

Build Status Coverage Status

Donate via Zerocracy DevOps By Rultor.com We recommend IntelliJ IDEA

Lightweight, object-oriented, Docker client for Java

A Java library for the Docker Engine API. It is the equivalent of the docker command-line client, for Java applications.

Unlike other docker clients for Java, this one aims to be as lightweight as possible, with as few transitive dependencies as possible and it should cause absolutely no runtime conflicts with other frameworks or platforms like Java EE.

Another target is that this library should be a true API, not an SDK. Read this blog post and the wiki for more details.

Maven dependency

The library comes as a maven dependency:

<dependency>
    <groupId>com.amihaiemil.web</groupId>
    <artifactId>docker-java-api</artifactId>
    <version>0.0.10</version>
</dependency>

In order for it to work, you need to have an implementation of JSON-P (JSR 374) in your classpath (it doesn't come transitively since most people are using Java EE APIs so, chances are it is already provided!).

If you are not using Maven, you can also download the fat jar.

Contributing

If you would like to contribute, just open an issue or a PR.

Make sure the maven build:

$mvn clean install -Pcheckstyle

passes before making a PR. Checkstyle will make sure you're following our code style and guidlines.

Running Integration Tests

In order to run the integration tests add the itcases profile to the maven command:

$mvn clean install -Pcheckstyle -Pitcases

Docker has to be installed and the ubuntu:latest image should be pulled on the machine, with the default configuration, in order for the IT cases to work.

You can’t perform that action at this time.