A Cake AddIn that extends Cake with Docker command tools.
Including addin in cake script is easy.
#addin "Cake.Docker"
BREAKING: Since 0.9 references Cake 0.26 (and goes .NET Standard 2.0 only)
Important: Docker 17.* is supported since v0.8 and background compatibility is dropped (most notably, array arguments are converter to strings). If you wish to match older docker versions, user an older Cake.Docker version.
Important: Since version 0.8.0 the settings are generated from the latest Docker source code on github.
BREAKING Starting with 0.8.0 command's setting types that haven't been composed of all words have changed to full name. i.e. DockerBuildSettings to DockerImageBuildSettings).
- DockerComposeExec v0.9.2
- DockerCustomCommand (can execute any command) v0.8.4
- DockerLogout v0.8.3
- DockerStart v0.8.2
- DockerLogs v0.8.2
- DockerExec v0.8.0
- DockerRun v0.7.2
- DockerPull v0.7.1
- DockerComposeBuild v0.7.0
- DockerComposeCreate v0.7.0
- DockerComposeDown v0.7.0
- DockerComposeKill v0.7.0
- DockerComposePause v0.7.0
- DockerComposePull v0.7.0
- DockerComposeRestart v0.7.0
- DockerComposeRm v0.7.0
- DockerComposeRun v0.7.0
- DockerComposeScale v0.7.0
- DockerComposeStart v0.7.0
- DockerComposeStop v0.7.0
- DockerComposeUnpause v0.7.0
- DockerComposeUp v0.7.0
- DockerLoad v0.6.0
- DockerSave v0.6.0
- DockerNetworkCreate v0.5.0
- DockerNetworkConnect v0.5.0
- DockerNetworkDisconnect v0.5.0
- DockerNetworkRm v0.5.0
- DockerSwarmInit v0.5.0
- DockerSwarmJoin v0.5.0
- DockerSwarmLeave v0.5.0
- DockerSwarmUpdate v0.5.0
- DockerLogin v0.4.0
- DockerPush v0.4.0
- DockerTag v0.4.0
- DockerPs v0.3.0
- DockerRm
- DockerRmi
- DockerStop
- DockerBuild
- DockerCreate v0.2.0
- DockerBuild v0.1.0, 0.2.0 (full settings)
- DockerCp v0.2.0
To use the addin just add it to Cake call the aliases and configure any settings you want.
#addin "Cake.Docker"
...
// How to remove a container with no settings
Task("DockerRm")
.Does(() => {
// or more containers at once
DockerRm("containerName1", "containerName2", ...);
)};
// How to remove a container with settings
Task("DockerRmWithSettings")
.Does(() => {
// or more containers at once
DockerRm(new DockerRmSettings { Force = true }, "containerName1", "containerName2", ...);
)};
Other commands follow same convention.
All come with settings argument and support all settings except for DockerBuild which supports only major settings.
This is an initial version and not tested thoroughly.
Contributions welcome - but not for command settings code. The reason being is that the actual code for settings is autogenerated from docker sources.
Tested only on Windows and Ubuntu. Ensure that Docker command line tool can be located using the PATH (e.g. check that it can be found with which docker
).
On Linux machines, ensure that user has access to the docker
daemon Unix socket or use the DOCKER_HOST environment variable to point to the daemon's TCP port.
Refer to the Docker documentation for controlling access to the docker daemon Unix socket.