Skip to content

Releases: tfsaggregator/aggregator-cli

v1.2

19 Mar 13:47
Compare
Choose a tag to compare

This release mainly catches up with .NET and Azure Function Runtime, includes a few fixes and a new feature.

BREAKING CHANGE: Upgrade command does not work. If you have existing rules, you must recreate the instance, redeploy the rules and remap.

CLI Commands and Options

New --filterOnlyLinks option to map.rule command; coincide with the Links are added or removed filter of the Azure DevOps subscription (#244).

Docker and Azure Function Hosting

  • Azure Function Runtime v4
  • .NET 6
  • Fix an off-by-one error when getting unique name from the string (#243).
  • Fix invalid cast exception when the IdentityRef could not be parsed (#243).

Rule Language

No changes.

Rule Interpreter Engine

Improved performance and memory profile through caching compiled rules (#242).

Build, Test, Documentation

  • Azure Function Runtime v4
  • .NET 6
  • Updated NuGet dependencies.
  • Scripts for local build

File Hashes

SHA-256 Hash Value File
00c3019df5f1605746693fd9c38563e5676bd14dbd98eefeff77a0fea6eb2801 FunctionRuntime.zip
e5cc660c0836ff7d222baed4bfc24762c84f1753a4232829f3a690753da6e6c2 aggregator-cli-linux-x64.zip
facc06fb428944268f854163038be4ad3532a799161348d7d5e776161cad1a2c aggregator-cli-osx-x64.zip
d92969bb69eca8eb601456149cd50a082777c0d1a25760bf7b650225d091bd1d aggregator-cli-win-x64.zip

v1.1.0

12 Jun 14:13
332c159
Compare
Choose a tag to compare

This release fixes a number of issues and introduce an additional CLI command.

CLI Commands and Options

  • Fixes spurious upgrade message noted in #225.

Docker and Azure Function Hosting

No changes.

Rule Language

  • Added support for .bypassrules directive (#83, #228).
  • Fixes #231 (Directive check revision false missing after update.rule).

Rule Interpreter Engine

  • Fixes #229 (Updating a work item field with impersonation enabled fails with the message: Remove requires Value to be null).
  • Fixes #234 (Object reference not set when removing a work item link).

Build, Test, Documentation

  • SonarCloud now requires Java 11.

File Hashes

SHA-256 Hash Value File
143978e381d0fa7e49042acf5ae0a569c92725c4b6892ee727c805038d557c36 FunctionRuntime.zip
a3e3aa484d8a29ad3f30aeddd1087b1ca99968cabc97a5441a4d1ff9363d7bac aggregator-cli-linux-x64.zip
f59afd19955147acae2abb2de61ff89f3f6ad2a9712c9ed75870adc27a014d89 aggregator-cli-osx-x64.zip
47431a103b7500da03a1b80b16ff0fd69e13fa2518d56325b9bacc46ae78cc47 aggregator-cli-win-x64.zip

v1.0.1

14 Dec 20:59
Compare
Choose a tag to compare

This release fixes a number of issues and introduce an additional CLI command.

CLI Commands and Options

  • Removed spurious messages about version check.
  • Deprecation warning if --resourceGroup option is missing.
  • Changed IDataProtectionProvider.CreateProtector purpose string to prevent clashes with concurrent running processes.
  • New update.mappings command.

Docker and Azure Function Hosting

  • Using Polly to Retry after HTTP code 429, this addresses #71.
  • Harden Azure resources connectivity (see #225).

Rule Language

No changes.

Rule Interpreter Engine

  • Address #185 by removing field when is set to a null value.
  • Impersonation does not work when a rule updates the same work item (bug #206).

Build, Test, Documentation

  • Terraform and PowerShell scripts to setup a testing VM where one can develop Aggregator.
  • Use latest GitVersion.
  • Drop log streaming in favour of reading the application log file: integration tests should become more reliable.

File Hashes

SHA-256 Hash Value File
d99cbfa30d88cd1e2943cbaa3ffb6befb161b36b8c6fc8e922d2639d9326aead FunctionRuntime.zip
6ee34070d85f5195cd9db8db6d721192d74404c1f6cdc691903abfaa3e3a816c aggregator-cli-linux-x64.zip
94ce042a660b4d309783758bfd623ba64149f111571945a1af407881b1d8515a aggregator-cli-osx-x64.zip
66cd2f1ffab884178ed03ef70f58ff9804065f281668cf32dbe64703b2743467 aggregator-cli-win-x64.zip

v1.0.0

18 Sep 07:18
dbdf4b5
Compare
Choose a tag to compare

This is the initial 1.0 release.

CLI Commands and Options

  • Resolve code analysis warnings.
  • Fix incorrect HTTP Header in web hook Subscriptions made by map.local.rule.
  • Fix incorrect URL in web hook Subscriptions made by map.local.rule.

Docker and Azure Function Hosting

  • Resolve code analysis warnings.
  • Fix CS1705 error.
  • New Aggregator_AzureDevOpsCertificate environment variable to add a certificate to trusted roots (e.g. Azure DevOps use a self-signed certificate or issued by non-trusted Certification Authority).
  • Better handling of API keys.

Rule Language

  • New optional events directive.

Rule Interpreter Engine

  • Resolve code analysis warnings.
  • Improved some messages.

Build, Test, Documentation

  • Updated to the latest version of NuGet packages except for Function SDK and Logging.
  • Stick to Microsoft.NET.Sdk.Functions 3.0.3 until they resolve #465. This locks Microsoft.Extensions.Logging to 3.1.6 too.
  • Resolve code analysis warnings.
  • Fix default branch reference in CI workflow.
  • Push docker images to GitHub Container Registry (beta) in addition to Docker Hub.
  • Local version number is now 0.0.1-localdev; this avoid clashing with published versions.
  • Fix build badge after workflow rename, added SonarQube badge.
  • Improved .dockerignore to trim build context.

File Hashes

SHA-256 Hash Value File
8ab2c399929192de3a8fa4d02fc2e54688f294f38212aad2c96af27005b34f28 FunctionRuntime.zip
846805843db2861665299eb6de30a909f1c998c91d3f147388c7c69a3b985def aggregator-cli-linux-x64.zip
66c5dd2da132faacbdeb3441442f088bf4fbd670c7967509edba71a16bd03613 aggregator-cli-osx-x64.zip
83c483c42aa59766f9dd2e3f5f79f888598c91d307894a933649e8736f95d090 aggregator-cli-win-x64.zip

v1.0.0-beta2.1

02 Sep 21:43
43271f9
Compare
Choose a tag to compare

Reissued

This is the second Release Candidate version: we changed the version number to highlight the milestone.

CLI Commands and Options

  • map.local.rule command to setup web hooks in Azure DevOps.
  • Automatic check if a new version of CLI is available.
  • AGGREGATOR_NEW_VERSION_CHECK_DISABLED environment variable to disable upgrade check.

Docker and Azure Function Hosting

  • Docker hosting image for Windows and Linux.
  • ASP.NET Core hosting (unsupported).
  • Telemetry to collect anonymized command usage.
  • AGGREGATOR_TELEMETRY_DISABLED environment variable to disable telemetry.

Rule Language

No changes.

Rule Interpreter Engine

No changes.

Build, Test, Documentation

  • Updated to the latest version of NuGet packages.
  • Merged GitHub Actions build and deploy scripts.
  • Added Code Coverage in build script.
  • Added SonarCloud scan in build script.
  • Added Docker build and push to deploy script.
  • Updated documentation with more background information.
  • Updated documentation with Docker support information.

File Hashes

SHA-256 Hash Value File
a9e273ad05ea3046ec8c0bdb85fde0d08a3b9b276c9e9aa664b94ab7db8a0db8 FunctionRuntime.zip
f0297568c62f0a5dd3c33e495533096426a783ca3292b2429a1346c9b8aa159f aggregator-cli-linux-x64.zip
b5b85fa9dc037492635dd73e164f236537ce194007fb480804960497a253a774 aggregator-cli-osx-x64.zip
86bfa5cee001c40332c4a633b05243789a536b277fd68f705fbb32735eaca40a aggregator-cli-win-x64.zip

v0.9.14

04 Aug 19:59
Compare
Choose a tag to compare

This is the first Release Candidate version: we will focus on bug fixing to reach 1.0 Release sooner.

CLI Commands and Options

  • Fixes #142 and #127: failed to match mappings with mixed case names.
  • New logon.env command: picks credentials from environment variables.
  • New logoff command: remove locally cached credentials.
  • Telemetry to collect anonymized command usage.
  • AGGREGATOR_TELEMETRY_DISABLED environment variable to disable telemetry.
  • Fixes checking of --event option in invoke.rule command.
  • Fixes Object reference not set to an instance of an object error, when specifying non-existing version.

Rule Language

No changes.

Rule Engine

  • Fixes #88: An item with same key already been added error when settings the same field twice in a Rule.

Build, Test, Documentation

  • List of hashes for artifacts.
  • Fixes double Twitter messages.
  • Terraform scripts to setup Telemetry collection.
  • Added dependabot to update dependent NuGet packages.
  • Updated to the latest version of NuGet packages.

File Hashes

SHA-256 Hash Value File
f21429dea12906b95a3d8f4bf9da072d70b9cc25b453dca41d15140b66f39d0f FunctionRuntime.zip
0aee6f440c7700f76f330c5c802069c84d946854c4b1190e640eff290ab90492 aggregator-cli-linux-x64.zip
3b3afe25ff56026ad8242e524c9145580042d0575ca30f815631b9b6e91d5d1f aggregator-cli-osx-x64.zip
4eb8e96debb6d4da50ea8f7e63c5255ae13b5f9909117a555b393ca6783f632b aggregator-cli-win-x64.zip

v0.9.13

18 Jul 16:37
8925d97
Compare
Choose a tag to compare

CLI Commands and Options

  • Resource Groups affixes are now optional in --namingTemplate JSON.
  • Non-success Exit Codes standardized and documented.

Rule Language

No changes.

Rule Engine

  • Gets work items in batches of 200 items, fixes #138 (error VS403474).

Build, Test, Documentation

v0.9.12

27 Jun 12:16
f89f53e
Compare
Choose a tag to compare

CLI Commands and Options

No changes.

Rule Language

  • New directive .check revision, when false it disable the default behavior that blocks updating a changed work item (see parallelism for details).
  • Directives accept blank ( ) as argument separator in addition to equal sign (=).
  • Rules can use new event variable to check the type of work item event which triggered the rule.

Build, Test, Documentation

v0.9.11

18 Jun 18:04
ff46602
Compare
Choose a tag to compare

CLI Commands and Options

  • GitHub API response is cached to prevent API rate limit exceeded error (resolves #131)
  • New feature: custom naming templates (#126) via the --namingTemplate <template.json>. It allows to define the name of Azure Resources.
    It requires you always specify the --resourceGroup option. The format of the template file is
{
  "ResourceGroupPrefix": "...",
  "ResourceGroupSuffix": "...",
  "FunctionAppPrefix": "...",
  "FunctionAppSuffix": "...",
  "HostingPlanPrefix": "...",
  "HostingPlanSuffix": "...",
  "AppInsightPrefix": "...",
  "AppInsightSuffix": "...",
  "StorageAccountPrefix": "...",
  "StorageAccountSuffix": "..."
}

Rule Language

No changes.

Build & Test

  • Improved Integration tests

v0.9.10

16 Apr 21:45
Compare
Choose a tag to compare

CLI Commands and Options

  • Allow adding of new web hooks with different filters (resolves #96).
  • Filters are correctly applied when querying existing mappings.
  • sourceUrl option supports file: scheme.
  • Call Trigger Syncing API after adding/removing Rules.

Rule Language

  • Simplify setting a WorkItemId to a Field, translate value to int Id (#115)
  • Fixes a possible null ref exception, when a field value with null is returned from API (resolves #101).
  • Now Relations and RelationLinks returns only Work Item links (resolves #117 and potentially #114).
  • Added documentation on accessing Custom Fields.

Build & Test

  • GitHub Actions script rewamped.
  • Added more integration tests.
  • Pipeline works on release/* branches.