From ac4e069b73deb7ca13e1141e309174ae0bdfe148 Mon Sep 17 00:00:00 2001 From: stijnmoreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 16 May 2023 07:34:13 +0200 Subject: [PATCH 1/7] feat: add scripting v1.0 blog post --- .../README.md | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md new file mode 100644 index 00000000..24d86889 --- /dev/null +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -0,0 +1,71 @@ +# New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release +We recently released the milestone v1.0 release in the Arcus Scripting library. Besides new functionality, this is a milestone in bringing reliable scripting functionality to projects. + +## Azure Logic Apps +Azure Logic Apps functionality is already a long-time part of the Arcus Scripting library. The recent changes only expand the usability further to bring real added value to projects working with Logic Apps. + +### Resubmit failed instances on an Azure Logic App +One of the hurdles with managing failed Azure Logic Apps instances is that you have to manually resubmit each instance individually in the Azure Portal. There is no 'batch' functionality available for this kind of operation. That is why the new v1.0 release has a new command in the `Arcus.Scripting.LogicApps` PowerShell module that lets you interact with the Logic App in a more high-level way. Instead of specifying each failed instance separately, it uses date filtering to get many failed instances in a given time frame. + +```powershell +PS> Resubmit-FailedAzLogicAppRuns ` + -ResourceGroupName "rg-common-dev" ` + -LogicAppName "rcv-shopping-order-sftp" ` + -StartTime "2023-05-01 00:00:00" ` + -EndTime "2023-05-01 10:00:00" +# Successfully resubmitted all failed instances for the Azure Logic App 'rcv-shopping-order-sftp' in resource group 'rg-common-dev' from '2023-05-01 00:00:00' and until '2023-05-01 10:00:00' +``` + +🔗 For more information on this particular command and other Logic Apps-related commands in this module, [see our feature documentation](https://scripting.arcus-azure.net/Features/powershell/azure-logic-apps). + +### Cancel running instances on an Azure Logic App +Same as with failed Logic Apps instances, there is no 'batch' functionality to cancel running instances on an Azure Logic App in the Azure Portal. This is particularly a problem when the instances were accidentally triggered with a big load. With a combination of several Azure PowerShell commands, you can mimic this functionality but it is not maintainable or easy to transfer to other projects that require the same or similar functionality. Arcus Scripting v1.0 also includes a 'batch' version of canceling many running Azure Logic Apps instances in one go. + +```powershell +PS> Cancel-AzLogicAppRuns ` + -ResourceGroupName "rg-common-dev" ` + -LogicAppName "rcv-shopping-order-sftp" +# Successfully cancelled all running instances for the Azure Logic App 'rcv-shopping-order-sftp' in resource group 'rg-common-dev' +``` + +🚩 It is important to note that this functionality is externally requested by a contributor. It is yet another a great example of how the usability of the Arcus Scripting library. It is fully grown out of the frustration and struggles of interacting with Azure-related resources using PowerShell. An extra layer that makes this interaction more comfortable and logical. + +🔗 For more information on this particular command and other Logic Apps-related commands in this module, [see our feature documentation](https://scripting.arcus-azure.net/Features/powershell/azure-logic-apps). + +## Azure DevOps +There is not even an Azure DevOps package that lets you interact with DevOps-related custom functionality. Interacting with DevOps functionality requires constant research for the correct syntax and possibilities. Luckily, with Arcus Scripting we have bundled commonly used functionality in the `Arcus.Scripting.DevOps` module which the v1.0 release enhances even further. + +### Set a variable as secret +Setting a secret in Azure DevOps dynamically at runtime requires you to write a specially designed host message. Because of this fragile way of working, we already had a command that was able to do this for you. This release now adds the option to dynamically write a variable as a secret. This means that it is not publicly logged in the build output so is handled with more care. + +```powershell +PS> Set-AzDevOpsVariable "my-variable" "my-variable-value" -AsSecret +##vso[task.setvariable variable=my-variable;issecret=true]*** +``` + +🔗 For more information on this particular command and other DevOps-related commands in this module, [see our feature documentation](https://scripting.arcus-azure.net/Features/powershell/azure-devops). + +### Set a custom retention period +We were already able to programmatically retain an Azure DevOps build indefinitely. In some scenarios, though, indefinite is too long. Especially if you have to delete them manually. The new v1.0 release will let you pass in the number of days such a build should be saved, making the command more flexible for numerous scenarios. + +```powershell +PS> Save-AzDevOpsBuild ` + -ProjectId $(System.TeamProjectId) ` + -BuildId $(Build.BuildId) ` + -DaysToKeep 10 +# Saved Azure DevOps build for 10 days with build ID $BuildId in project $ProjectId +``` + +💡 The variables `$(System.TeamProjectId)` and `$(Build.BuildId)` are predefined Azure DevOps variables. Information on them can be found [here](https://docs.microsoft.com/en-us/azure/devops/pipelines/build/variables?view=azure-devops&tabs=yaml). + +## Conclusion +We have released Arcus Scripting v1.0! 🎉 + +This new major release has besides some great new and enhanced functionality a big role to play. From now on we are confident that the Arcus Scripting library is ready for the public. It has been used across several projects, has received many enhancement and feature requests, which makes it mature enough for us to decide to take this milestone of a step. + +Have a look at our [release notes](https://github.com/arcus-azure/arcus.scripting/releases/tag/v1.0.0) and [official documentation](https://scripting.arcus-azure.net/) for more information on this new release. + +If you have any questions, remarks, comments, or just want to discuss something with us; feel free to [contact the Arcus team at Codit](https://github.com/arcus-azure/arcus.scripting/issues/new/choose). + +Thanks for reading! +The Arcus team \ No newline at end of file From d5d8c099699dd2da9744331e6bc622b8904e4ec1 Mon Sep 17 00:00:00 2001 From: Stijn Moreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 16 May 2023 08:13:59 +0200 Subject: [PATCH 2/7] Update community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md Co-authored-by: Pim Simons <32359437+pim-simons@users.noreply.github.com> --- .../README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md index 24d86889..77f65b03 100644 --- a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -2,7 +2,7 @@ We recently released the milestone v1.0 release in the Arcus Scripting library. Besides new functionality, this is a milestone in bringing reliable scripting functionality to projects. ## Azure Logic Apps -Azure Logic Apps functionality is already a long-time part of the Arcus Scripting library. The recent changes only expand the usability further to bring real added value to projects working with Logic Apps. +Azure Logic Apps functionality has been a part of the Arcus Scripting library for a long time. The recent changes only expand the usability further to bring real added value to projects working with Logic Apps. ### Resubmit failed instances on an Azure Logic App One of the hurdles with managing failed Azure Logic Apps instances is that you have to manually resubmit each instance individually in the Azure Portal. There is no 'batch' functionality available for this kind of operation. That is why the new v1.0 release has a new command in the `Arcus.Scripting.LogicApps` PowerShell module that lets you interact with the Logic App in a more high-level way. Instead of specifying each failed instance separately, it uses date filtering to get many failed instances in a given time frame. From 6f4f28a953d2481557e778ec992a93f0974e71a2 Mon Sep 17 00:00:00 2001 From: Stijn Moreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 16 May 2023 08:14:24 +0200 Subject: [PATCH 3/7] Update community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md Co-authored-by: Pim Simons <32359437+pim-simons@users.noreply.github.com> --- .../README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md index 77f65b03..3c1ffd77 100644 --- a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -28,7 +28,7 @@ PS> Cancel-AzLogicAppRuns ` # Successfully cancelled all running instances for the Azure Logic App 'rcv-shopping-order-sftp' in resource group 'rg-common-dev' ``` -🚩 It is important to note that this functionality is externally requested by a contributor. It is yet another a great example of how the usability of the Arcus Scripting library. It is fully grown out of the frustration and struggles of interacting with Azure-related resources using PowerShell. An extra layer that makes this interaction more comfortable and logical. +🚩 It is important to note that this functionality is externally requested by a contributor. It is yet another a great example of how the usability of the Arcus Scripting library. It is fully grown out of the challenges and struggles of interacting with Azure-related resources using PowerShell. An extra layer that makes this interaction more comfortable and logical. 🔗 For more information on this particular command and other Logic Apps-related commands in this module, [see our feature documentation](https://scripting.arcus-azure.net/Features/powershell/azure-logic-apps). From 812ebe105e21cb06c4699d29d28949429d4521c7 Mon Sep 17 00:00:00 2001 From: Stijn Moreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 16 May 2023 08:14:46 +0200 Subject: [PATCH 4/7] Update community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md Co-authored-by: Pim Simons <32359437+pim-simons@users.noreply.github.com> --- .../README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md index 3c1ffd77..92bca3e9 100644 --- a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -33,7 +33,7 @@ PS> Cancel-AzLogicAppRuns ` 🔗 For more information on this particular command and other Logic Apps-related commands in this module, [see our feature documentation](https://scripting.arcus-azure.net/Features/powershell/azure-logic-apps). ## Azure DevOps -There is not even an Azure DevOps package that lets you interact with DevOps-related custom functionality. Interacting with DevOps functionality requires constant research for the correct syntax and possibilities. Luckily, with Arcus Scripting we have bundled commonly used functionality in the `Arcus.Scripting.DevOps` module which the v1.0 release enhances even further. +Interacting with DevOps functionality requires constant research for the correct syntax and possibilities. Luckily, with Arcus Scripting we have bundled commonly used functionality in the `Arcus.Scripting.DevOps` module which the v1.0 release enhances even further. ### Set a variable as secret Setting a secret in Azure DevOps dynamically at runtime requires you to write a specially designed host message. Because of this fragile way of working, we already had a command that was able to do this for you. This release now adds the option to dynamically write a variable as a secret. This means that it is not publicly logged in the build output so is handled with more care. From 59869c4d29283ddccae83c8d2feefcc8187e92e5 Mon Sep 17 00:00:00 2001 From: Stijn Moreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 16 May 2023 08:16:31 +0200 Subject: [PATCH 5/7] Update community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md Co-authored-by: Pim Simons <32359437+pim-simons@users.noreply.github.com> --- .../README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md index 92bca3e9..d5e45db7 100644 --- a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -61,7 +61,7 @@ PS> Save-AzDevOpsBuild ` ## Conclusion We have released Arcus Scripting v1.0! 🎉 -This new major release has besides some great new and enhanced functionality a big role to play. From now on we are confident that the Arcus Scripting library is ready for the public. It has been used across several projects, has received many enhancement and feature requests, which makes it mature enough for us to decide to take this milestone of a step. +Besides some great new and enhanced functionality this new major release has a big role to play. We are confident that the Arcus Scripting library is ready for the public. It has been used across several projects, has received many enhancement and feature requests, which makes it mature enough for us to decide to take this milestone of a step. Have a look at our [release notes](https://github.com/arcus-azure/arcus.scripting/releases/tag/v1.0.0) and [official documentation](https://scripting.arcus-azure.net/) for more information on this new release. From 6d4b073e7b52c2f83571417752b506d3daf4adba Mon Sep 17 00:00:00 2001 From: Stijn Moreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 16 May 2023 08:17:20 +0200 Subject: [PATCH 6/7] pr-sug: use major release io publc --- .../README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md index d5e45db7..67bd60ff 100644 --- a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -61,11 +61,11 @@ PS> Save-AzDevOpsBuild ` ## Conclusion We have released Arcus Scripting v1.0! 🎉 -Besides some great new and enhanced functionality this new major release has a big role to play. We are confident that the Arcus Scripting library is ready for the public. It has been used across several projects, has received many enhancement and feature requests, which makes it mature enough for us to decide to take this milestone of a step. +Besides some great new and enhanced functionality this new major release has a big role to play. We are confident that the Arcus Scripting library is mature enough to move to an official v1.0 release. It has been used across several projects, has received many enhancement and feature requests, which makes it mature enough for us to decide to take this milestone of a step. Have a look at our [release notes](https://github.com/arcus-azure/arcus.scripting/releases/tag/v1.0.0) and [official documentation](https://scripting.arcus-azure.net/) for more information on this new release. If you have any questions, remarks, comments, or just want to discuss something with us; feel free to [contact the Arcus team at Codit](https://github.com/arcus-azure/arcus.scripting/issues/new/choose). Thanks for reading! -The Arcus team \ No newline at end of file +The Arcus team From 825bc55359120513d19ea542398ebc7875731621 Mon Sep 17 00:00:00 2001 From: Stijn Moreels <9039753+stijnmoreels@users.noreply.github.com> Date: Tue, 23 May 2023 07:46:35 +0200 Subject: [PATCH 7/7] Update community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md Co-authored-by: Frederik Gheysels --- .../README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md index 67bd60ff..86865388 100644 --- a/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md +++ b/community/blog/2023-05 New Azure Logic Apps and DevOps functionality in milestone v1.0 Arcus Scripting release/README.md @@ -28,7 +28,7 @@ PS> Cancel-AzLogicAppRuns ` # Successfully cancelled all running instances for the Azure Logic App 'rcv-shopping-order-sftp' in resource group 'rg-common-dev' ``` -🚩 It is important to note that this functionality is externally requested by a contributor. It is yet another a great example of how the usability of the Arcus Scripting library. It is fully grown out of the challenges and struggles of interacting with Azure-related resources using PowerShell. An extra layer that makes this interaction more comfortable and logical. +🚩 It is important to note that this functionality is externally requested by a contributor. It is yet another great example of the usability of the Arcus Scripting library. It is fully grown out of the challenges and struggles of interacting with Azure-related resources using PowerShell. An extra layer that makes this interaction more comfortable and logical. 🔗 For more information on this particular command and other Logic Apps-related commands in this module, [see our feature documentation](https://scripting.arcus-azure.net/Features/powershell/azure-logic-apps).