Allows to build and use Docker containers from pipelines.

Features

See the user guide for all details.

Open JIRA issues

Version history

Version 1.10 (Feb 13, 2017)

• Fixed detection of agents running inside containers under further special conditions.
• Detect custom Dockerfile when using --file.
• JENKINS-34276 Allow Image.inside to run with either a local or registry-prefixed name.
• JENKINS-37719 Recover when dockerd hangs.

Version 1.9.1 (Nov 14, 2016)

• Name changed to remove word “CloudBees”.

Version 1.9 (Oct 05, 2016)

• Failure to pass --volumes-from from Image.inside when an agent was run in a container using --volume but no VOLUME declaration.
• JENKINS-37769 As-yet-undiagnosed issue with stop meant that cleanup from Image.inside was delayed for ten seconds.
• JENKINS-38018 When withRegistry succeeds, print a message saying where credentials were stored. When credentials are not found, abort rather than silently continuing.
• JENKINS-37951 withTool was not honored by Image.inside.

Version 1.8 (Sep 07, 2016)

• JENKINS-37987 Allow Image.inside to work with images like maven which specify an ENTRYPOINT.
• JENKINS-36332 Allow a command argument to be passed to Image.withRun.
• Improved detection of containerized Jenkins instances from 1.5.
• Avoid blocking log output when running docker commands to compute fingerprints.

Version 1.7 (Jul 26, 2016)

Requires a newer Jenkins baseline and Pipeline dependencies.

• JENKINS-36214 Use a workspace-specific temporary directory to write .container files.
• JENKINS-34050 Docker.build may now take arbitrary arguments, not merely an alternate base directory.
• JENKINS-31225 More portable way of determining when commands need to be wrapped in an implicit node block.

Version 1.6 (Jul 01, 2016)

• Fix error in 1.5 when not run on Linux.

Version 1.5 (Jun 30, 2016)

• Work correctly out of the box when Jenkins itself is running inside a Docker container. Demo also updated to exercise this mode.
• JENKINS-33510 Not solved, but at least print a warning to the build log that dir inside Image.inside does not work.
• JENKINS-33063 Allow a command to be passed to Image.run.
• Added a Container.port function.

Version 1.4 (Mar 03, 2016)

• JENKINS-27152 Mount temporary directories now used by several other plugins in addition to the workspace when using Docker.Image.inside.
• Handle recent deprecation of docker tag --force.

Version 1.3 (Feb 05, 2016)

• No functional change, just following rename from Workflow to Pipeline.

Version 1.2 (Aug 04 2015)

• JENKINS-28611 Honor DOCKER_HOST and similar environment variables from the slave machine when running docker exec for docker.inside.

Version 1.1 (Jul 28 2015)

• JENKINS-28612 Date parsing issue with some Docker clients.

Version 1.0 (Jun 03 2015)

• First release