Candoumbe.Pipelines 0.12.1

dotnet add package Candoumbe.Pipelines --version 0.12.1                
NuGet\Install-Package Candoumbe.Pipelines -Version 0.12.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="Candoumbe.Pipelines" Version="0.12.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Candoumbe.Pipelines --version 0.12.1                
#r "nuget: Candoumbe.Pipelines, 0.12.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.
// Install Candoumbe.Pipelines as a Cake Addin
#addin nuget:?package=Candoumbe.Pipelines&version=0.12.1

// Install Candoumbe.Pipelines as a Cake Tool
#tool nuget:?package=Candoumbe.Pipelines&version=0.12.1                

Candoumbe.Pipelines

GitHub Workflow Status (main) GitHub Workflow Status (develop) GitHub raw issues Nuget

A starter development kit to script your CI/CD using Nuke.

Give a star

⭐ If you like or are using this project please give it a star. Thanks! ⭐

Disclaimer

This project adheres to semantic versioning. Major version zero (0.y.z) is for initial development.

Anything MAY change at any time.

The public API SHOULD NOT be considered stable.

The problem

Most of the time, to set up a CI/CD for your .NET project, you have two options :

1. Going through your repository and use its embedded GUI to create the pipeline

This approach is nice and helpful to get started. But most of the time, the history of changes made to the pipeline is separated from the history of the code base.

2. Writing a pipeline file of some sort

Most of the time in YAML, the file that describes the steps required to build a project are providers specific. So even though you can write YAML, knowing how to write an Azure DevOps pipeline does not really help when it comes to writing a pipeline for GitHub Actions.

The solution

Nuke is a library written by Matthias Koch that helps to create builds.

This project offers an opinionated way at writing pipelines by giving a set of components (more on that later) with the following benefits :

  1. no need to go your code management tool to set up your project CI/CD.
  2. no more YAML file : yeah YAML is great but the tooling is not great and the structure itself is error-prone.
  3. it's just a C# project that every team member can contribute to !
  4. it sits right with your source code so that each change to the pipeline is just a commit into your codebase.

Try it out

To get started you'll have to :

  1. install Nuke.GlobalTool dotnet tool (locally or globally)
  2. run dotnet nuke :setup to set up your pipeline project
  3. replace the Nuke.Common nuget dependency with Candoumbe.Pipelines

From this point, you should be able to customize your pipeline by adding [components] \o/.

How does it work ?

This library is built on top of Nuke, an open source library started by Matthias Koch. It provides a set of components that, when added to a pipeline, bring clever default features.

Components are C# interfaces that come with a default / opinionated implementation. They are grouped in namespaces which correspond to their main task.

  • Candoumbe.Pipelines.Components : contains the core components needed for general required tasks.

Let's say you have the following Build.cs class as your starting pipeline

class Build : NukeBuild
{
    public static void Main() => Execute<Build>(x => x.Compile());

    Target Compile => _ => _
        .Executes(() => {

            // Code omitted for brievity

        });
}

you can get rid of the Compile property and use the ICompile component instead.

class Build : NukeBuild, ICompile
{
    public static void Main() => Execute<Build>(x => ((ICompile)x).Compile());

}

In the example above, the build pipeline benefits from the ICompile component which comes with a default implementation of the Compile target.

Candoumbe.Pipelines.Components.Workflows

This workspace contains components related to branching strategies and providing tools that can help normalize how teams works.

IGitFlow and IGitHubFlow are two main components that helps handle branching strategy locally.

Some components are used to set the workflow to use throughout a repository and streamline the work of a developer and a team.

working on a feature / hotfix
%%{init: {"flowchart": {"htmlLabels": false}} }%%
flowchart
    A((start)) --> B[["./build feature"]]
    A -->O[["./build hotfix"]]
    O --> P{is on 'hotfix' branch ?}
    P -- yes --> finish-hotfix
    P -- no --> Q{{computes semver}}
    Q --> R{{creates 'hotfix/<semver>' branch}}
    R --> S[work on your hotfix]
    S --> T{Are you done}
    T -- yes --> O
    T -- not yet --> S
    B --> C{is on 'feature/*' branch ?}
    C -- yes --> finish-feature
    C -- no --> D[Creates a new feature/* branch]
    D --> E[Work on your feature]
    E --> F{Are you done ?}
    F --yes --> B
    F -- not yet --> E

    subgraph finish-feature[Finish feature]
      N{{Merges changes to develop branch}}
    end
    
    subgraph finish-hotfix[Finish hotfix]
       Y{{Merges changes to main branch}}
    end

    finish-hotfix --> Z
    finish-feature --> Z((end))

using IGitFlowWithPullRequest or IGitHubFlowWithPullRequest components, the library can automagically create a pull request once you're done working on your feature / hotfix.

class Build : NukeBuild, IGitFlowWithPullRequest
{
    public static void Main() => Execute<Build>(x => x.Compile());

    Target Compile => _ => _
        .Executes(() => {

            // Code omitted for brievity

        });
}

or

class Build : NukeBuild, IGitHubFlowWithPullRequest
{
    public static void Main() => Execute<Build>(x => x.Compile());

    Target Compile => _ => _
        .Executes(() => {

            // Code omitted for brievity

        });
}

depending on the workflow that better suits you.

working on a release

To start working on a release, simply call ./build.cmd release and your pipeline will trigger the appropriate commands to get you started.

Calling ./build.cmd release from the release branch created will trigger the appropriate command to finish your release.

%%{init: {"flowchart": {"htmlLabels": false}} }%%
flowchart
    A((start)) --> B["./build release"]
    B --> C{is on 'release/*' branch ?}
    C -- no --> create-branch
    subgraph create-branch[Create a release branch]
        G{{computes semver version}} --> H{{create release/version branch}}
    end
    create-branch --> D[Work on your release]
    C -- yes --> finish-release
    D --> E{Are you done ?}
    E --yes --> B
    E -- not yet --> D

    subgraph finish-release[Finish release]
      J[Update changelog] --> K{{validate changelog modifications}}
      K --> M{{create tag}}
      M --> N{{Merges changes to main branch}}
      N --> O{{Merges changes to develop branch}}
    end

    finish-release --> Z((end))
Candoumbe.Pipelines.Components.NuGet

Contains classes required to push nuget packages to repositories.

Candoumbe.Pipelines.Components.GitHub

Contains classes and components needed to interact with GitHub repositories (creating pull requests).

Candoumbe.Pipelines.Components.Docker

Contains classes and components needed to build and push docker images.

⚠️ Some components may require additional packages and/or tools to be installed in order to be fully functional. For example, the default implementation of the IMutationTest component uses Stryker to run mutation tests.

You can refer to Nuke's documentation to see how to reference required tools.

Want to contribute ?

You can contribute by opening an issue or submitting a feature request.

PRs are welcome, check out the contribution guidelines if you want to contribute to this project !

Special thanks

  • Matthias Koch for the marvelous Nuke library. This project would never exist without its work.
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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.12.1 144 11/12/2024
0.11.0 415 9/14/2024
0.11.0-rc.1 49 9/14/2024
0.10.0 406 7/11/2024
0.10.0-remove-nuget-req0001 104 2/17/2024
0.9.0 1,134 1/25/2024
0.9.0-rc0009 104 1/25/2024
0.9.0-rc0001 102 1/23/2024
0.8.0 240 12/15/2023
0.7.0 930 9/23/2023
0.7.0-rc0004 152 9/18/2023
0.7.0-rc0003 190 9/15/2023
0.7.0-rc0001 145 9/14/2023
0.7.0-rc0000 127 9/13/2023
0.6.1 321 8/31/2023
0.6.1-beta0017 126 9/2/2023
0.6.1-beta0005 131 8/30/2023
0.6.0 441 8/15/2023
0.6.0-rc0003 141 8/15/2023
0.6.0-rc0002 146 8/15/2023
0.6.0-rc0001 153 8/14/2023
0.6.0-rc0000 166 8/13/2023
0.5.0 394 7/24/2023
0.5.0-rc0002 170 7/24/2023
0.5.0-rc0001 190 7/20/2023
0.5.0-rc0000 141 7/20/2023
0.5.0-pulish-nupkg-by-0060 168 7/14/2023
0.5.0-pulish-nupkg-by-0059 156 7/14/2023
0.5.0-pulish-nupkg-by-0058 161 7/14/2023
0.5.0-beta0000 164 7/20/2023
0.5.0-alpha0071 169 7/17/2023
0.4.5 198 7/17/2023
0.4.5-beta0001 150 7/17/2023
0.4.4 201 7/14/2023
0.4.3 213 7/10/2023
0.4.3-beta0006 141 7/8/2023
0.4.3-beta0004 146 7/7/2023
0.4.3-beta0003 146 7/6/2023
0.4.3-beta0001 150 7/6/2023
0.4.2 204 7/5/2023
0.4.1 181 7/5/2023
0.4.1-beta0014 151 7/5/2023
0.4.0 205 7/3/2023
0.4.0-beta0016 162 7/3/2023
0.4.0-beta0015 142 7/2/2023
0.4.0-beta0014 142 7/2/2023
0.4.0-beta0013 131 6/30/2023
0.4.0-beta0012 1,813 6/29/2023
0.4.0-beta0011 158 6/28/2023
0.4.0-beta0007 160 6/9/2023
0.4.0-beta0006 140 5/30/2023
0.4.0-beta0005 140 5/30/2023
0.4.0-beta0002 148 5/30/2023
0.4.0-beta0000 162 3/28/2023
0.3.0 1,328 2/5/2023
0.3.0-beta0001 243 1/30/2023
0.3.0-alpha0011 226 1/29/2023
0.2.0 309 1/22/2023
0.2.0-publish-using-a-0001 163 6/29/2023
0.2.0-coldfix-restore0001 162 6/29/2023
0.2.0-beta0001 141 6/29/2023
0.2.0-alpha0048 175 12/24/2022
0.2.0-alpha0046 154 12/24/2022
0.2.0-alpha0040 162 11/26/2022
0.2.0-alpha0039 171 11/20/2022
0.2.0-alpha0036 186 11/10/2022
0.2.0-alpha0035 161 11/9/2022
0.2.0-alpha0034 151 11/9/2022
0.2.0-alpha0032 138 11/5/2022
0.2.0-alpha0022 179 10/30/2022
0.2.0-alpha0020 141 10/30/2022
0.2.0-alpha0018 146 10/23/2022
0.2.0-alpha0016 139 10/23/2022
0.2.0-alpha0014 173 10/23/2022
0.1.0-alpha0003 172 10/23/2022

### 🛠️ Fixes
• Fixed incorrect verbosity of the default implementation of the IUnitTest component

Full changelog at https://github.com/candoumbe/Pipelines/blob/main/CHANGELOG.md