From f673fcfcdd9a42122282eecfba970a23868932cb Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Wed, 15 Apr 2026 11:18:11 -0700 Subject: [PATCH 1/7] Added a warm up step to cache maven-help-plugin into the CFS --- .../stages/archetype-java-release-batch.yml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/eng/pipelines/templates/stages/archetype-java-release-batch.yml b/eng/pipelines/templates/stages/archetype-java-release-batch.yml index 4815f1afb6ac..6d41440b5157 100644 --- a/eng/pipelines/templates/stages/archetype-java-release-batch.yml +++ b/eng/pipelines/templates/stages/archetype-java-release-batch.yml @@ -381,6 +381,13 @@ stages: inputs: artifactsFeeds: 'azure-sdk-for-java' + # java2docfx internally runs 'mvn help:effective-pom' using the short 'help' prefix. + # Azure Artifacts feed metadata may not contain prefix-to-artifactId mappings for + # plugins that haven't been requested before. This fully-qualified invocation forces + # the feed to cache maven-help-plugin so the 'help' prefix resolves in java2docfx. + - script: mvn org.apache.maven.plugins:maven-help-plugin:help -q 2>/dev/null || true + displayName: 'Warm maven-help-plugin feed cache' + - template: /eng/pipelines/templates/steps/install-rex-validation-tool.yml - template: /eng/common/pipelines/templates/steps/update-docsms-metadata.yml @@ -514,6 +521,13 @@ stages: inputs: artifactsFeeds: 'azure-sdk-for-java' + # java2docfx internally runs 'mvn help:effective-pom' using the short 'help' prefix. + # Azure Artifacts feed metadata may not contain prefix-to-artifactId mappings for + # plugins that haven't been requested before. This fully-qualified invocation forces + # the feed to cache maven-help-plugin so the 'help' prefix resolves in java2docfx. + - script: mvn org.apache.maven.plugins:maven-help-plugin:help -q 2>/dev/null || true + displayName: 'Warm maven-help-plugin feed cache' + - template: /eng/pipelines/templates/steps/install-rex-validation-tool.yml - template: /eng/common/pipelines/templates/steps/update-docsms-metadata.yml From 8559742c785da63d93cfbf94a274fe35cda49bf9 Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Wed, 15 Apr 2026 12:01:50 -0700 Subject: [PATCH 2/7] temp change to test docs publish --- sdk/template/ci.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sdk/template/ci.yml b/sdk/template/ci.yml index 0e60e8de0f7a..a80e0116b711 100644 --- a/sdk/template/ci.yml +++ b/sdk/template/ci.yml @@ -90,17 +90,17 @@ extends: groupId: com.azure safeName: azuresdktemplate releaseInBatch: ${{ parameters.release_azuresdktemplate }} - skipPublishDocMs: true + skipPublishDocMs: false - name: azure-sdk-template-two groupId: com.azure safeName: azuresdktemplatetwo releaseInBatch: ${{ parameters.release_azuresdktemplatetwo }} - skipPublishDocMs: true + skipPublishDocMs: false - name: azure-sdk-template-three groupId: com.azure safeName: azuresdktemplatethree releaseInBatch: ${{ parameters.release_azuresdktemplatethree }} - skipPublishDocMs: true + skipPublishDocMs: false AdditionalModules: - name: azure-template-perf groupId: com.azure From d4c2d571525b623eb45cd266b5cd742a3f8fedfc Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Wed, 15 Apr 2026 12:13:27 -0700 Subject: [PATCH 3/7] Moved warm up step to the install-rex-validation template --- .../stages/archetype-java-release-batch.yml | 14 -------------- .../steps/install-rex-validation-tool.yml | 6 ++++++ 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/eng/pipelines/templates/stages/archetype-java-release-batch.yml b/eng/pipelines/templates/stages/archetype-java-release-batch.yml index 6d41440b5157..4815f1afb6ac 100644 --- a/eng/pipelines/templates/stages/archetype-java-release-batch.yml +++ b/eng/pipelines/templates/stages/archetype-java-release-batch.yml @@ -381,13 +381,6 @@ stages: inputs: artifactsFeeds: 'azure-sdk-for-java' - # java2docfx internally runs 'mvn help:effective-pom' using the short 'help' prefix. - # Azure Artifacts feed metadata may not contain prefix-to-artifactId mappings for - # plugins that haven't been requested before. This fully-qualified invocation forces - # the feed to cache maven-help-plugin so the 'help' prefix resolves in java2docfx. - - script: mvn org.apache.maven.plugins:maven-help-plugin:help -q 2>/dev/null || true - displayName: 'Warm maven-help-plugin feed cache' - - template: /eng/pipelines/templates/steps/install-rex-validation-tool.yml - template: /eng/common/pipelines/templates/steps/update-docsms-metadata.yml @@ -521,13 +514,6 @@ stages: inputs: artifactsFeeds: 'azure-sdk-for-java' - # java2docfx internally runs 'mvn help:effective-pom' using the short 'help' prefix. - # Azure Artifacts feed metadata may not contain prefix-to-artifactId mappings for - # plugins that haven't been requested before. This fully-qualified invocation forces - # the feed to cache maven-help-plugin so the 'help' prefix resolves in java2docfx. - - script: mvn org.apache.maven.plugins:maven-help-plugin:help -q 2>/dev/null || true - displayName: 'Warm maven-help-plugin feed cache' - - template: /eng/pipelines/templates/steps/install-rex-validation-tool.yml - template: /eng/common/pipelines/templates/steps/update-docsms-metadata.yml diff --git a/eng/pipelines/templates/steps/install-rex-validation-tool.yml b/eng/pipelines/templates/steps/install-rex-validation-tool.yml index 868a468ebd7d..236c91d7a39a 100644 --- a/eng/pipelines/templates/steps/install-rex-validation-tool.yml +++ b/eng/pipelines/templates/steps/install-rex-validation-tool.yml @@ -8,6 +8,12 @@ steps: - script: | java -version displayName: Print Java Version + # java2docfx internally runs 'mvn help:effective-pom' using the short 'help' prefix. + # Azure Artifacts feed metadata may not contain prefix-to-artifactId mappings for + # plugins that haven't been requested before. This fully-qualified invocation forces + # the feed to cache maven-help-plugin so the 'help' prefix resolves in java2docfx. + - script: mvn org.apache.maven.plugins:maven-help-plugin:help -q 2>/dev/null || true + displayName: 'Warm maven-help-plugin feed cache' # Create a java2docfx subdirectory in the $(Build.BinariesDirectory) and install the java2docfx there # This way, the jar file is in its own subdirectory and isolated. - pwsh: | From c33200413a04e59e82652bdfccd67a82502cb1a7 Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Wed, 15 Apr 2026 13:42:37 -0700 Subject: [PATCH 4/7] Ran command in batch mode rather than quiet mode --- eng/pipelines/templates/steps/install-rex-validation-tool.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/eng/pipelines/templates/steps/install-rex-validation-tool.yml b/eng/pipelines/templates/steps/install-rex-validation-tool.yml index 236c91d7a39a..46d8e3c1f6a8 100644 --- a/eng/pipelines/templates/steps/install-rex-validation-tool.yml +++ b/eng/pipelines/templates/steps/install-rex-validation-tool.yml @@ -12,7 +12,7 @@ steps: # Azure Artifacts feed metadata may not contain prefix-to-artifactId mappings for # plugins that haven't been requested before. This fully-qualified invocation forces # the feed to cache maven-help-plugin so the 'help' prefix resolves in java2docfx. - - script: mvn org.apache.maven.plugins:maven-help-plugin:help -q 2>/dev/null || true + - script: mvn org.apache.maven.plugins:maven-help-plugin:help --batch-mode displayName: 'Warm maven-help-plugin feed cache' # Create a java2docfx subdirectory in the $(Build.BinariesDirectory) and install the java2docfx there # This way, the jar file is in its own subdirectory and isolated. From 5296a78bcfcbcb744b9bde40e816d5392e1ec015 Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Wed, 15 Apr 2026 13:47:16 -0700 Subject: [PATCH 5/7] Reverted test change for template ci --- sdk/template/ci.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sdk/template/ci.yml b/sdk/template/ci.yml index a80e0116b711..0e60e8de0f7a 100644 --- a/sdk/template/ci.yml +++ b/sdk/template/ci.yml @@ -90,17 +90,17 @@ extends: groupId: com.azure safeName: azuresdktemplate releaseInBatch: ${{ parameters.release_azuresdktemplate }} - skipPublishDocMs: false + skipPublishDocMs: true - name: azure-sdk-template-two groupId: com.azure safeName: azuresdktemplatetwo releaseInBatch: ${{ parameters.release_azuresdktemplatetwo }} - skipPublishDocMs: false + skipPublishDocMs: true - name: azure-sdk-template-three groupId: com.azure safeName: azuresdktemplatethree releaseInBatch: ${{ parameters.release_azuresdktemplatethree }} - skipPublishDocMs: false + skipPublishDocMs: true AdditionalModules: - name: azure-template-perf groupId: com.azure From 67a043a053f7d5f2b8e08ab4a93ba109c5b0aa26 Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Fri, 17 Apr 2026 10:04:57 -0700 Subject: [PATCH 6/7] Re-applied template ci change for testing --- sdk/template/ci.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sdk/template/ci.yml b/sdk/template/ci.yml index 0e60e8de0f7a..a80e0116b711 100644 --- a/sdk/template/ci.yml +++ b/sdk/template/ci.yml @@ -90,17 +90,17 @@ extends: groupId: com.azure safeName: azuresdktemplate releaseInBatch: ${{ parameters.release_azuresdktemplate }} - skipPublishDocMs: true + skipPublishDocMs: false - name: azure-sdk-template-two groupId: com.azure safeName: azuresdktemplatetwo releaseInBatch: ${{ parameters.release_azuresdktemplatetwo }} - skipPublishDocMs: true + skipPublishDocMs: false - name: azure-sdk-template-three groupId: com.azure safeName: azuresdktemplatethree releaseInBatch: ${{ parameters.release_azuresdktemplatethree }} - skipPublishDocMs: true + skipPublishDocMs: false AdditionalModules: - name: azure-template-perf groupId: com.azure From 7685405921222de6798ac1d19a611ee3b110f35d Mon Sep 17 00:00:00 2001 From: Ray Chen Date: Fri, 17 Apr 2026 10:49:38 -0700 Subject: [PATCH 7/7] Reverted test change --- sdk/template/ci.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sdk/template/ci.yml b/sdk/template/ci.yml index a80e0116b711..0e60e8de0f7a 100644 --- a/sdk/template/ci.yml +++ b/sdk/template/ci.yml @@ -90,17 +90,17 @@ extends: groupId: com.azure safeName: azuresdktemplate releaseInBatch: ${{ parameters.release_azuresdktemplate }} - skipPublishDocMs: false + skipPublishDocMs: true - name: azure-sdk-template-two groupId: com.azure safeName: azuresdktemplatetwo releaseInBatch: ${{ parameters.release_azuresdktemplatetwo }} - skipPublishDocMs: false + skipPublishDocMs: true - name: azure-sdk-template-three groupId: com.azure safeName: azuresdktemplatethree releaseInBatch: ${{ parameters.release_azuresdktemplatethree }} - skipPublishDocMs: false + skipPublishDocMs: true AdditionalModules: - name: azure-template-perf groupId: com.azure