v1.10.0 Release (#302)

Author: bachuv

.github/workflows/build-validation.yml

@@ -142,6 +142,14 @@ jobs:
         name: Integration test report
         path: client/build/reports/tests/integrationTest
 
+    - name: Archive large payload integration test report
+      if: always()
+      uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+      with:
+        name: Large payload integration test report
+        path: azure-blob-payloads/build/reports/tests/integrationTest
+        if-no-files-found: ignore
+
     - name: Archive export history integration test report
       if: always()
       uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
@@ -150,11 +158,19 @@ jobs:
         path: exporthistory/build/reports/tests/integrationTest
         if-no-files-found: ignore
 
+    - name: Assemble packages for upload
+      run: ./gradlew assemble
+
     - name: Upload JAR output
       uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
       with:
-        name: Package
-        path: client/build/libs
+        name: Packages
+        path: |
+          client/build/libs
+          azurefunctions/build/libs
+          azuremanaged/build/libs
+          azure-blob-payloads/build/libs
+          exporthistory/build/libs
 
     - name: Fail the job if tests failed
       if: env.TEST_FAILED == 'true'

CHANGELOG.md

@@ -1,4 +1,7 @@
 ## Unreleased
+
+## v1.10.0
+* Enable custom exception providers for Durable Functions Java activities ([#294](https://github.com/microsoft/durabletask-java/pull/294))
 * Recover verified ambiguous payload uploads on HTTP 409 `BlobAlreadyExists` as well as HTTP 412, while rejecting unrelated conflicts.
 * Change the default large-payload externalization threshold from 900,000 bytes to 256 KiB, matching .NET.
 * Align the large-payload worker estimator threshold with the 256 KiB storage default, resolve externalized entity-operation failure traces, recover verified ambiguous blob uploads, and recognize `$root` payload tokens.
@@ -14,8 +17,10 @@
 * Add optional connection-string `AuthorityHost` forwarding for Azure Identity credentials that support it. Audience selection does not change the service endpoint or credential authority; managed identity and developer-tool cloud configuration remain separate.
 * Add the `exporthistory` module for durable, checkpointed export of terminal orchestration history to Azure Blob Storage ([#293](https://github.com/microsoft/durabletask-java/pull/293))
 * Add client APIs to list terminal instance IDs by completion time (`listInstanceIds`) and read orchestration history (`getOrchestrationHistory`) ([#292](https://github.com/microsoft/durabletask-java/pull/292))
-* Add `createReplaySafeLogger` to suppress orchestration log output during replay ([#295](https://github.com/microsoft/durabletask-java/pull/295)).
+* Add `createReplaySafeLogger` to suppress orchestration log output during replay ([#295](https://github.com/microsoft/durabletask-java/pull/295))
 * Add `getParentInstance()` API to `TaskOrchestrationContext` for discovering parent orchestration info ([#284](https://github.com/microsoft/durabletask-java/pull/284))
+* Add the `azure-blob-payloads` module for externalizing large orchestration payloads to Azure Blob Storage ([#280](https://github.com/microsoft/durabletask-java/pull/280))
+* Add inner failure details and custom exception properties to `FailureDetails` ([#263](https://github.com/microsoft/durabletask-java/pull/263))
 
 ## v1.9.0
 * Fix entity locking deserialization and add Jackson support for EntityInstanceId/EntityMetadata ([#281](https://github.com/microsoft/durabletask-java/pull/281))

README.md

@@ -40,6 +40,10 @@ Logger logger = ctx.createReplaySafeLogger(executionContext.getLogger());
 Replay-safe logging suppresses calls made while replaying; it does not guarantee
 exactly-once log delivery across failed or retried live orchestration turns.
 
+### Externalized large payloads
+
+The [`durabletask-azure-blob-payloads`](azure-blob-payloads/README.md) module transparently stores orchestration payloads that exceed a configurable threshold in Azure Blob Storage. Configure the same storage container on the client and worker to exchange large inputs, outputs, activity payloads, and orchestration actions without exceeding gRPC message limits.
+
 ### Reliable fan-out / fan-in orchestration pattern
 
 ```java
@@ -102,8 +106,11 @@ The following packages are produced from this repo.
 
 | Package | Latest version |
 | - | - |
-| Durable Task - Client | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-client?label=durabletask-client)](https://mvnrepository.com/artifact/com.microsoft/durabletask-client/1.0.0) |
-| Durable Task - Azure Functions | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-azure-functions?label=durabletask-azure-functions)](https://mvnrepository.com/artifact/com.microsoft/durabletask-azure-functions/1.0.1) |
+| Durable Task - Client | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-client?label=durabletask-client)](https://mvnrepository.com/artifact/com.microsoft/durabletask-client) |
+| Durable Task - Azure Functions | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-azure-functions?label=durabletask-azure-functions)](https://mvnrepository.com/artifact/com.microsoft/durabletask-azure-functions) |
+| Durable Task - Azure Managed | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-azuremanaged?label=durabletask-azuremanaged)](https://mvnrepository.com/artifact/com.microsoft/durabletask-azuremanaged) |
+| [Durable Task - Azure Blob Payloads](azure-blob-payloads/README.md) | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-azure-blob-payloads?label=durabletask-azure-blob-payloads)](https://mvnrepository.com/artifact/com.microsoft/durabletask-azure-blob-payloads) |
+| [Durable Task - Export History](exporthistory/README.md) | [![Maven Central](https://img.shields.io/maven-central/v/com.microsoft/durabletask-exporthistory?label=durabletask-exporthistory)](https://mvnrepository.com/artifact/com.microsoft/durabletask-exporthistory) |
 
 ## Azure Durable Task Scheduler authentication
 

azdevops-pipeline/build-release-artifacts.yml

@@ -25,7 +25,7 @@ steps:
     publishJUnitResults: false
     tasks: clean assemble
     options: '--init-script init.gradle'
-  displayName: Assemble durabletask-client and durabletask-azure-functions
+  displayName: Assemble all publishable Durable Task Java packages
 
 # the secring.gpg file is required to sign the artifacts, it's generated from GnuPG, and it's stored in the library of the durabletaskframework ADO
 - task: DownloadSecureFile@1
@@ -44,7 +44,7 @@ steps:
     jdkArchitectureOption: 'x64'
     tasks: publish
     options: '--init-script init.gradle -Psigning.keyId=$(gpgSignKey) -Psigning.password=$(gpgSignPassword) -Psigning.secretKeyRingFile=$(gpgSecretFile.secureFilePath)'
-  displayName: Publish durabletask-client and durabletask-azure-functions
+  displayName: Stage all publishable Durable Task Java packages
 
 - task: CopyFiles@2
   displayName: 'Copy publish file to Artifact Staging Directory'

azure-blob-payloads/README.md

@@ -7,7 +7,7 @@ The `durabletask-azure-blob-payloads` module transparently externalizes large Du
 Add the module alongside the Durable Task client and your backend-specific extension:
 
 ```groovy
-implementation 'com.microsoft:durabletask-azure-blob-payloads:1.0.0'
+implementation 'com.microsoft:durabletask-azure-blob-payloads:1.10.0'
 ```
 
 The module includes Azure Blob Storage support. Applications that use managed identity should also add `com.azure:azure-identity`.

azure-blob-payloads/build.gradle

@@ -6,7 +6,7 @@ plugins {
 }
 
 group 'com.microsoft'
-version = '1.0.0'
+version = '1.10.0'
 archivesBaseName = 'durabletask-azure-blob-payloads'
 
 def grpcVersion = '1.78.0'

azurefunctions/build.gradle

@@ -6,7 +6,7 @@ plugins {
 }
 
 group 'com.microsoft'
-version = '1.9.0'
+version = '1.10.0'
 archivesBaseName = 'durabletask-azure-functions'
 
 def protocVersion = '3.25.8'

azuremanaged/build.gradle

@@ -17,7 +17,7 @@ plugins {
 
 archivesBaseName = 'durabletask-azuremanaged'
 group 'com.microsoft'
-version = '1.9.0'
+version = '1.10.0'
 
 def grpcVersion = '1.78.0'
 def azureCoreVersion = '1.57.1'

client/build.gradle

@@ -10,7 +10,7 @@ plugins {
 }
 
 group 'com.microsoft'
-version = '1.9.0'
+version = '1.10.0'
 archivesBaseName = 'durabletask-client'
 
 def grpcVersion = '1.78.0'

eng/ci/release.yml

@@ -23,7 +23,7 @@ extends:
     stages:
     - stage: release
       jobs:
-      - job: durabletask_azuremanaged 
+      - job: durabletask_client
         templateContext:
           type: releaseJob
           isProduction: true
@@ -36,19 +36,20 @@ extends:
 
         steps:
         - task: SFP.release-tasks.custom-build-release-task.EsrpRelease@9
-          displayName: 'Release durabletask-azuremanaged'
+          displayName: 'Release durabletask-client'
           inputs:
             connectedservicename: 'dtfx-internal-esrp-prod'
             usemanagedidentity: true
             keyvaultname: 'durable-esrp-akv'
             signcertname: 'dts-esrp-cert'
             clientid: '0b3ed1a4-0727-4a50-b82a-02c2bd9dec89'
-            folderlocation: '$(System.DefaultWorkingDirectory)/drop/durabletask-azuremanaged'
+            folderlocation: '$(System.DefaultWorkingDirectory)/drop/durabletask-client'
             owners: 'wangbill@microsoft.com'
             approvers: 'kaibocai@microsoft.com'
             mainpublisher: 'durabletask-java'
 
-      - job: durabletask_client
+      - job: durabletask_azuremanaged
+        dependsOn: durabletask_client
         templateContext:
           type: releaseJob
           isProduction: true
@@ -61,19 +62,20 @@ extends:
 
         steps:
         - task: SFP.release-tasks.custom-build-release-task.EsrpRelease@9
-          displayName: 'Release durabletask-client'
+          displayName: 'Release durabletask-azuremanaged'
           inputs:
             connectedservicename: 'dtfx-internal-esrp-prod'
             usemanagedidentity: true
             keyvaultname: 'durable-esrp-akv'
             signcertname: 'dts-esrp-cert'
             clientid: '0b3ed1a4-0727-4a50-b82a-02c2bd9dec89'
-            folderlocation: '$(System.DefaultWorkingDirectory)/drop/durabletask-client'
+            folderlocation: '$(System.DefaultWorkingDirectory)/drop/durabletask-azuremanaged'
             owners: 'wangbill@microsoft.com'
             approvers: 'kaibocai@microsoft.com'
             mainpublisher: 'durabletask-java'
 
       - job: durabletask_azure_functions
+        dependsOn: durabletask_client
         templateContext:
           type: releaseJob
           isProduction: true
@@ -97,3 +99,55 @@ extends:
             owners: 'wangbill@microsoft.com'
             approvers: 'kaibocai@microsoft.com'
             mainpublisher: 'durabletask-java'
+
+      - job: durabletask_azure_blob_payloads
+        dependsOn: durabletask_client
+        templateContext:
+          type: releaseJob
+          isProduction: true
+          inputs:
+          # Declare inputs to be released here to ensure they receive relevant checks
+          - input: pipelineArtifact
+            pipeline: DurableTaskJavaBuildPipeline
+            artifactName: drop
+            targetPath: $(System.DefaultWorkingDirectory)/drop
+
+        steps:
+        - task: SFP.release-tasks.custom-build-release-task.EsrpRelease@9
+          displayName: 'Release durabletask-azure-blob-payloads'
+          inputs:
+            connectedservicename: 'dtfx-internal-esrp-prod'
+            usemanagedidentity: true
+            keyvaultname: 'durable-esrp-akv'
+            signcertname: 'dts-esrp-cert'
+            clientid: '0b3ed1a4-0727-4a50-b82a-02c2bd9dec89'
+            folderlocation: '$(System.DefaultWorkingDirectory)/drop/durabletask-azure-blob-payloads'
+            owners: 'wangbill@microsoft.com'
+            approvers: 'kaibocai@microsoft.com'
+            mainpublisher: 'durabletask-java'
+
+      - job: durabletask_exporthistory
+        dependsOn: durabletask_client
+        templateContext:
+          type: releaseJob
+          isProduction: true
+          inputs:
+          # Declare inputs to be released here to ensure they receive relevant checks
+          - input: pipelineArtifact
+            pipeline: DurableTaskJavaBuildPipeline
+            artifactName: drop
+            targetPath: $(System.DefaultWorkingDirectory)/drop
+
+        steps:
+        - task: SFP.release-tasks.custom-build-release-task.EsrpRelease@9
+          displayName: 'Release durabletask-exporthistory'
+          inputs:
+            connectedservicename: 'dtfx-internal-esrp-prod'
+            usemanagedidentity: true
+            keyvaultname: 'durable-esrp-akv'
+            signcertname: 'dts-esrp-cert'
+            clientid: '0b3ed1a4-0727-4a50-b82a-02c2bd9dec89'
+            folderlocation: '$(System.DefaultWorkingDirectory)/drop/durabletask-exporthistory'
+            owners: 'wangbill@microsoft.com'
+            approvers: 'kaibocai@microsoft.com'
+            mainpublisher: 'durabletask-java'