Cake.Docker 1.4.0-beta.1

This is a prerelease version of Cake.Docker.
dotnet add package Cake.Docker --version 1.4.0-beta.1                
NuGet\Install-Package Cake.Docker -Version 1.4.0-beta.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Cake.Docker" Version="1.4.0-beta.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Cake.Docker --version 1.4.0-beta.1                
#r "nuget: Cake.Docker, 1.4.0-beta.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=Cake.Docker&version=1.4.0-beta.1&prerelease                

Cake.Docker

A Cake AddIn that extends Cake with Docker command tools.

cakebuild.net NuGet

Including addin

Including addin in cake script is easy.

#addin "Cake.Docker"

Commands supported

Cake references

  • 1.3.0: Cake 4.0.0

  • 1.2.0: Cake 3.0.0

  • 1.1.0: Cake 2.0.0

  • 1.0.0: Cake 1.0.0

  • 0.10.0: Cake 0.33

  • 0.9.4: Cake 0.28

  • 0.9 references Cake 0.26 (and goes .NET Standard 2.0 only)

Important: In version 1.2.1 DockerComposeUpSettings.DetachedMode is renamed to Detach.

Important: In version 1.2.0 the .netcore 3.1 is dropped, only .net6+ versions are distributed.

Important: In version 1.1.0 the .netstandard 2.0 version is dropped and instead .netcore 3.1, .net5 and .net6 versions are distributed.

Important: Since version 0.10.0 path argument to DockerBuild is now quoted if not quoted already.

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

Usage

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.

General Notes

This is an initial version and not tested thoroughly.

Contributions welcome - but ask first (create an issue).

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.

Follow @mihamarkic@mastodon.social

Discussion

For questions and to discuss ideas & feature requests, use the GitHub discussions on the Cake GitHub repository, under the Extension Q&A category.

Join in the discussion on the Cake repository

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (3)

Showing the top 3 popular GitHub repositories that depend on Cake.Docker:

Repository Stars
GitTools/GitVersion
From git log to SemVer in no time
charlessolar/Aggregates.NET
.NET event sourced domain driven design model via NServiceBus and GetEventStore
localstack-dotnet/localstack-dotnet-client
A lightweight .NET client for LocalStack
Version Downloads Last updated
1.4.0-beta.1 170 9/1/2024
1.3.0 298,133 1/19/2024
1.2.3 94,783 10/28/2023
1.2.2 143,143 8/6/2023
1.2.1 243 8/5/2023
1.2.0 459,503 1/16/2023
1.1.2 593,389 4/8/2022
1.1.1 214,404 2/19/2022
1.1.0 504,347 12/18/2021
1.0.0 574,697 2/15/2021
0.11.1 222,046 9/3/2020
0.11.0 423,965 12/8/2019
0.10.1 367,912 8/7/2019
0.10.0 759,752 4/17/2019
0.9.9 947,514 2/21/2019
0.9.8 5,702 2/14/2019
0.9.7 75,611 11/30/2018
0.9.6 87,924 8/22/2018
0.9.5 24,098 7/25/2018
0.9.4 40,322 6/11/2018
0.9.3 8,719 4/18/2018
0.9.2 13,000 4/16/2018
0.9.1 3,276 3/27/2018
0.9.0 15,073 3/5/2018
0.8.5 29,763 1/19/2018
0.8.4 1,555 1/16/2018
0.8.3 3,231 12/24/2017
0.8.2 53,620 9/30/2017
0.7.7 39,592 6/9/2017
0.7.6 2,431 5/18/2017
0.7.5 3,677 3/8/2017
0.7.4 2,424 12/28/2016
0.7.3 1,290 12/28/2016
0.7.2 1,256 12/28/2016
0.7.1 1,716 12/15/2016
0.7.0 1,340 11/17/2016
0.6.0 1,620 8/29/2016
0.5.0 1,439 7/22/2016
0.4.0 1,505 5/13/2016
0.3.0 1,787 4/24/2016
0.2.0 1,468 4/21/2016
0.1.1 1,182 4/20/2016