Add possibility to add custom steps with attributes.

source/Nuke.Build/CICD/CustomStepConfigurationEntityAttribute.cs

@@ -0,0 +1,16 @@
+// Copyright 2024 Maintainers of NUKE.
+// Distributed under the MIT License.
+// https://github.com/nuke-build/nuke/blob/master/LICENSE
+
+using System;
+using System.Linq;
+using Nuke.Common.Utilities;
+
+namespace Nuke.Common.CI;
+
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
+public abstract class CustomStepConfigurationEntityAttribute<T> : Attribute
+{
+    public abstract T Get();
+
+}

source/Nuke.Common.Tests/AzurePipelinesAttributes/AzureDevOpsDownloadSecureFileStep.cs

@@ -0,0 +1,30 @@
+// Copyright 2024 Maintainers of NUKE.
+// Distributed under the MIT License.
+// https://github.com/nuke-build/nuke/blob/master/LICENSE
+
+using Nuke.Common.CI.AzurePipelines.Configuration;
+using Nuke.Common.Utilities;
+
+namespace Nuke.Common.Tests.AzurePipelinesAttributes;
+
+internal sealed class AzureDevOpsDownloadSecureFileStep : AzurePipelinesStep
+{
+    public AzureDevOpsDownloadSecureFileStep(string fileName)
+    {
+        FileName = fileName;
+    }
+
+    public string FileName { get; }
+    public override void Write(CustomFileWriter writer)
+    {
+        writer.WriteLine("- task: DownloadSecureFile@1");
+        using (writer.Indent())
+        {
+            writer.WriteLine("inputs:");
+            using (writer.Indent())
+            {
+                writer.WriteLine($"secureFile: '{FileName}'");
+            }
+        }
+    }
+}

source/Nuke.Common.Tests/AzurePipelinesAttributes/AzureDevOpsDownloadSecureFileStepAttribute.cs

@@ -0,0 +1,22 @@
+// Copyright 2024 Maintainers of NUKE.
+// Distributed under the MIT License.
+// https://github.com/nuke-build/nuke/blob/master/LICENSE
+
+using Nuke.Common.CI.AzurePipelines.Configuration;
+
+namespace Nuke.Common.Tests.AzurePipelinesAttributes;
+
+internal sealed class AzureDevOpsDownloadSecureFileStepAttribute : AzurePipelineStepAttribute
+{
+    public AzureDevOpsDownloadSecureFileStepAttribute(string fileName)
+    {
+        FileName = fileName;
+    }
+
+    public string FileName { get; }
+
+    public override AzurePipelinesStep Get()
+    {
+        return new AzureDevOpsDownloadSecureFileStep(FileName);
+    }
+}

source/Nuke.Common.Tests/CI/ConfigurationGenerationTest.Test_testName=null_attribute=AzurePipelinesAttribute.verified.txt

@@ -131,6 +131,9 @@ stages:
               key: $(Agent.OS) | nuget-packages | **/global.json, **/*.csproj, **/Directory.Packages.props
               restoreKeys: $(Agent.OS) | nuget-packages
               path: $(HOME)/.nuget/packages
+          - task: DownloadSecureFile@1
+            inputs:
+              secureFile: 'securefile.zip'
           - task: CmdLine@2
             displayName: 'Run: Test'
             inputs:
@@ -271,6 +274,9 @@ stages:
               key: $(Agent.OS) | nuget-packages | **/global.json, **/*.csproj, **/Directory.Packages.props
               restoreKeys: $(Agent.OS) | nuget-packages
               path: $(USERPROFILE)/.nuget/packages
+          - task: DownloadSecureFile@1
+            inputs:
+              secureFile: 'securefile.zip'
           - task: CmdLine@2
             displayName: 'Run: Test'
             inputs:

source/Nuke.Common.Tests/CI/ConfigurationGenerationTest.cs

@@ -16,6 +16,7 @@
 using Nuke.Common.CI.TeamCity;
 using Nuke.Common.Execution;
 using Nuke.Common.IO;
+using Nuke.Common.Tests.AzurePipelinesAttributes;
 using Nuke.Common.Tooling;
 using VerifyXunit;
 using Xunit;
@@ -224,6 +225,7 @@ public class TestBuild : NukeBuild
 
         public AbsolutePath TestResultDirectory => OutputDirectory / "test-results";
 
+        [AzureDevOpsDownloadSecureFileStep("securefile.zip")]
         public Target Test => _ => _
             .DependsOn(Compile)
             .Produces(TestResultDirectory / "*.trx")

source/Nuke.Common/CI/AzurePipelines/AzurePipelinesAttribute.cs

@@ -6,6 +6,7 @@
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using System.Reflection;
 using JetBrains.Annotations;
 using Nuke.Common.CI.AzurePipelines.Configuration;
 using Nuke.Common.Execution;
@@ -275,6 +276,15 @@ string GetArtifactPath(AbsolutePath path)
         //                ArtifactRules = rules
         //            }).ToArray<TeamCityDependency>();
 
+        var customSteps = executableTarget.Member
+            .GetCustomAttributes(typeof(AzurePipelineStepAttribute), true)
+            .ToList();
+
+        foreach (var customStep in customSteps.Cast<AzurePipelineStepAttribute>())
+        {
+            yield return customStep.Get();
+        }
+
         var chainLinkTargets = GetInvokedTargets(executableTarget, relevantTargets).ToArray();
         yield return new AzurePipelinesCmdStep
                      {

source/Nuke.Common/CI/AzurePipelines/Configuration/AzurePipelineStepAttribute.cs

@@ -0,0 +1,15 @@
+// Copyright 2024 Maintainers of NUKE.
+// Distributed under the MIT License.
+// https://github.com/nuke-build/nuke/blob/master/LICENSE
+
+using System;
+using System.Linq;
+using JetBrains.Annotations;
+
+namespace Nuke.Common.CI.AzurePipelines.Configuration;
+
+[PublicAPI]
+public abstract class AzurePipelineStepAttribute : CustomStepConfigurationEntityAttribute<AzurePipelinesStep>
+{
+
+}

source/Nuke.Common/CI/AzurePipelines/Configuration/AzurePipelinesStep.cs

@@ -5,6 +5,7 @@
 using System;
 using System.Linq;
 using JetBrains.Annotations;
+using Nuke.Common.Utilities;
 
 namespace Nuke.Common.CI.AzurePipelines.Configuration;