Skip to content

Latest commit

 

History

History
412 lines (369 loc) · 19.2 KB

changelog.md

File metadata and controls

412 lines (369 loc) · 19.2 KB

ChangeLog

  • 0.13.8

    • Add option nocache to build configuration (#348)
    • Add system property docker.nocache to disable build caching globally (#349)
    • Add support for '.maven-dockerignore' for excluding certain files in plain Dockerfile build (#362)
    • If naming strategy is "alias" stop only the container with the given alias with docker:stop (#359)
    • Fix that containers without d-m-p label where still stopped
    • Add support for OpenShift login (use -DuseOpenShiftAuth for enabling this) (#350)
    • Add support for dedicated pull and push registry configuration respectively (#351)

  • 0.13.7

    • Fix default for "cleanup" in build configuration to true (as documented) (#338)
    • Fix dynamic host property update in port mapping (#323)
    • New goal 'docker:source' for attaching a Docker tar archive to the Maven project with an classifier "docker-" (#311)
    • Be more careful with chowning the user when is used in an assembly (#336)
    • Move VOLUME to the end of the Dockerfile to allow initialization via RUN commands (#341)
    • Allow multiple configurations with different Docker hosts again (#320)
    • docker:start blocks now only when system property docker.follow is given (#249)
    • docker:stop only stops containers started by this plugin by default (#87)
    • Lookup ~/.docker/config.json for registry credentials as fallback (#147)

  • 0.13.6

    • Don't use user from image when pulling base images (#147)
    • Add a new assembly descriptor reference hawt-app for using assemblies created by hawt-app

  • 0.13.5

    • Improvements for docker:watch (#288)
    • Add parameter kill to <watch> configuration for waiting before sending SIGKILL when stopping containers (#293)
    • Add file for <log> to store the logout put in a file. Use docker.logStdout to show logs nevertheless to stdout (#287)
    • Support watchMode == copy for copying changed assembly files into a running container (#268)
    • Add a target/classpath file to the assembly as classpath for artifact-with-dependencies predefined assembly descriptor (#283)
    • Disable Apache HTTP Client retry in WaitUtil (#297)

  • 0.13.4

    • Support explicit exec arguments for start.cmd and start.entrypoint. (#253)
    • Fix processing of split chunked JSON responses (#259)
    • Fix for default registry handling. Again and again. (#261)
    • Allow runCmds to be compressed into a single command with the build config option optimise. (#263)
    • Proper error message when default timeout is hit while waiting (#274)
    • Add proper error message when docker host URL is malformed (#277)
    • If no wait condition is given in wait continue immediately (#276)
    • Add logic to specify exec commands during postStart and preStop (#272)
    • Fixed docker:watch bug when watching on plain files

  • 0.13.3

    • Allow dangling images to be cleaned up after build (#20)
    • Adapt order of WORKDIR and RUN when building images (#222)
    • Allow 'build' and/or 'run' configuration to be skipped (#207)
    • Refactored to use 'inspect' instead of 'list' for checking the existence of an image (#230)
    • Refactored ApacheHttpClientDelegate to avoid leaking connections (#232)
    • Allow empty build or assembly elements (#214) (#236)
    • Add new configuration parameter 'maxConnections' to allow to specify the number of parallel connections to the Docker Host. Default: 100 (#254)
    • Allow multiple containers of the same image to be linked (#182)
    • HTTP method and status code can be specified when waiting on an HTTP URL (#258)
    • Introduced global portPropertyFile setting (#90)
    • Allow the container's host ip to be bound to a maven property and exported

  • 0.13.2

    • "run" directives can be added to the Dockerfile (#191)
    • Support user information in wait URL (#211)
    • Stop started container in case of an error during startup (#217)
    • Allow linking to external containers (#195)
    • Allow volume mounting from external containers (#73)

  • 0.13.1

    • Allow autoPull to be forced on docker:build and docker:start (#96)
    • Respect username when looking up credentials for a Docker registry (#174)
    • Add "force=1" to push for Fedora/CentOs images allowing to push to docker hub

Note that the default registry has been changed to docker.io as docker hub doesn't use registry.hub.docker.com as the default registry and refused to authenticate against this registry. For backward compatibility reasons registry.hub.docker.com, index.docker.io and docker.io can be used as a server id in ~/.m2/settings.xml for the default credentials for pushing without registry to Docker hub.

  • 0.13.0
    • Add docker:watch (#187)
    • Allow extraHosts IPs to be resolved at runtime (#196)
    • Add workDir as configuration option to <build> (#204)
    • Fix problem with log output and wait (#200)
    • Don't verify SSL server certificates if DOCKER_TLS_VERIFY is not set (#192)
    • For bind path on Windows machines (#188)
    • No 'from' required when using a Dockerfile (#201)
    • Support for LABEL for build and run.

Note that since version 0.13.0 this plugin requires Docker API version v1.17 or later in order to support labels.

The watch feature has changed: Instead of using paramters like docker.watch or docker.watch.interval for docker:start a dedicated docker:watch has been introduced. Also the <run><watch>...</watch></run> configuration has been moved one level up so that <watch> and <run> are on the same level. Please refer to the manual for an in depth explanation of the much enhanced watch functionality.

  • 0.12.0
    • Allow CMD and ENTRYPOINT with shell and exec arguments (#130) (#149)
    • Unix Socket support (#179)
    • Add a new parameter 'skipTags' for avoiding configured tagging of images (#145)
    • Break build if log check or URL check runs into a timeout (#173)

Please note that for consistencies sake <command> has been renamed to <cmd> which contains inner elements to match better the equivalent Dockerfile argument. The update should be trivial and easy to spot since a build will croak immediately.

The old format

<build> 
  <command>java -jar /server.jar</command>
</build>

becomes now

<build> 
  <cmd> 
    <exec> 
      <arg>java</arg> 
      <arg>-jar</arg>
      <arg>/server.jar</arg>
    </exec>         
  </cmd> 
</build>

or

<build>
  <cmd>
    <shell>java -jar /server.jar</shell>
  </cmd>
</build>

depending on whether you prefer the exec or shell form.

  • 0.11.5

    • Fix problem with http:// URLs when a CERT path is set
    • Fix warnings when parsing a pull response
    • Add a new parameter 'docker.follow' which makes a docker:start blocking until the CTRL-C is pressed (#176)
    • Add a user parameter to the assembly configuration so that the added files are created for this user
    • Fix problem when creating intermediate archive for collecting assembly files introduced with #139. The container can be now set with "mode" in the assembly configuration with the possible values dir, tar, tgz and zip (#171)
    • Workaround Docker problem when using an implicit registry index.docker.io when no registry is explicitly given.
    • Fixed references to docker hub in documentation (#169)
    • Fixed registry authentication lookup (#146)

  • 0.11.4

    • Fixed documentation for available properties
    • Changed property docker.assembly.exportBase to docker.assembly.exportBaseDir (#164)
    • Changed default behaviour of exportBaseDir (true if no base image used with from, false otherwise)
    • Fix log messages getting cut off in the build (#163)
    • Allow system properties to overwrite dynamic port mapping (#161)
    • Fix for empty authentication when pushing to registries (#102)
    • Added watch mode for images with -Ddocker.watch (#141)
    • Added support for inline assemblies (#157, #158)
    • Add support for variable substitution is environment declarations (#137)
    • Use Tar archive as intermediate container when creating image (#139)
    • Better error handling for Docker errors wrapped in JSON response only (#167)

  • 0.11.3

    • Add support for removeVolumes in docker:stop configuration (#120)
    • Add support for setting a custom maintainer in images (#117)
    • Allow containers to be named using <namingStrategy>alias</namingStrategy> when started (#48)
    • Add new global property 'docker.verbose' for switching verbose image build output (#36)
    • Add support for environment variables specified in a property file (#128)
    • Documentation improvements (#107, #121)
    • Allow to use a dockerFileDir without any assembly

  • 0.11.2

    • Fix maven parse error when specifying restart policy (#99)
    • Allow host names to be used in port bindings (#101)
    • Add support for tagging at build and push time (#104)
    • Use correct output dir during multi-project builds (#97)
    • descriptor and descriptorRef in the assembly configuration are now optional (#66)
    • Fix NPE when filtering enabled during assembly creation (#82)
    • Allow ${project.build.finalName} to be overridden when using a pre-packaged assembly descriptor for artifacts (#111)

  • 0.11.1

    • Add support for binding UDP ports (#83)
    • "Entrypoint" supports now arguments (#84)
    • Fix basedir for multi module projects (#89)
    • Pull base images before building when "autoPull" is switched on (#76, #77, #88)
    • Fix for stopping containers without tag (#86)

  • 0.11.0

    • Add support for binding/exporting containers during startup (#55)
    • Provide better control of the build assembly configuration. In addition, the plugin will now search for assembly descriptors in src/main/docker. This default can be overridden via the global configuration option sourceDirectory.
    • An external Dockerfile can now be specified to build an image.
    • When "creating" containers they get now all host configuration instead of during "start". This is the default behaviour since v1.15 while the older variant where the host configuration is fed into the "start" call is deprecated and will go away.
    • Allow selecting the API version with the configuration "apiVersion". Default and minimum API version is now "v1.15"
    • A registry can be specified as system property docker.registry or environment variable DOCKER_REGISTRY (#26)
    • Add new wait parameter shutdown which allows to specify the amount of time to wait between stopping a container and removing it (#54)

Please note, that the syntax for binding volumes from another container has changed slightly in 0.10.6. See "Volume binding" for details but in short:

<run>
  <volumes>
    <from>data</from>
    <from>jolokia/demo</from>
  </volumes>
....
</run>

becomes

<run>
  <volumes>
    <from>
      <image>data</image>
      <image>jolokia/demo</image>
    </from>
  </volumes>
....
</run>

The syntax for specifying the build assembly configuration has also changed. See "[Build Assembly] (manual.md#build-assembly)" for details but in short:

<build>
  ...
  <exportDir>/export</exportDir>
  <assemblyDescriptor>src/main/docker/assembly.xml</assemblyDescriptor>  
</build>

becomes

<build>
  ...  
  <assembly>
    <basedir>/export</basedir>
    <descriptor>assembly.xml</descriptor> 
  </assembly>
</build>

  • 0.10.5

    • Add hooks for external configurations
    • Add property based configuration for images (#42)
    • Add new goal docker:logs for showing logs of configured containers (#49)
    • Support for showing logs during docker:start (#8)
    • Use COPY instead of ADD when putting a Maven assembly into the container (#53)
    • If exportDir is / then do not actually export (since it doesn't make much sense) (see #62)

  • 0.10.4

    • Restructured and updated documentation
    • Fixed push issue when using a private registry (#40)
    • Add support for binding to an arbitrary host IP (#39)

  • 0.10.3

    • Added "remove" goal for cleaning up images
    • Allow "stop" also as standalone goal for stopping all managed builds

  • 0.10.2

    • Support for SSL Authentication with Docker 1.3. Plugin will respect DOCKER_CERT_PATH with fallback to ~/.docker/. The plugin configuration certPath can be used, too and has the highest priority.
    • Getting rid of UniRest, using Apache HttpComponents exclusively for contacting the Docker host.
    • Support for linking of containers (see the configuration in the shootout-docker-maven POM) Images can be specified in any order, the plugin takes care of the right startup order when running containers.
    • Support for waiting on a container's log output before continuing

0.9.x Series

Original configuration syntax (as described in the old README)

  • 0.9.12

    • Fixed push issue when using a private registry (#40)

  • 0.9.11

    • Support for SSL Authentication with Docker 1.3. Plugin will respect DOCKER_CERT_PATH with fallback to ~/.docker/. The plugin configuration certPath can be used, too and has the highest priority.