Release Process

Extension Release Process — Step-by-Step Guide

1. Verify Extension Pipeline Run

   • Open the extension pipeline:
     https://dev.azure.com/azfunc/internal/_build?definitionId=1639
   • Confirm the latest run has passed after all changes were merged.

2. Update Package Version (SemVer)

   • Determine the correct version using semantic versioning rules.
   • Run the command:

     npm run updateVersion -- --version <insert-version>

3. Run Build Pipeline (Preview / Validation Run)

   • Start the build pipeline:
     https://dev.azure.com/azfunc/internal/_build?definitionId=1634
   • Run the pipeline with the prerelease configuration as needed.
   • Wait for the pipeline to complete.

4. Verify Preview Artifacts

   • After the run completes, go to Artifacts.
   • Confirm that extension packages are generated with the preview tag.
   • Example artifact view:
     https://dev.azure.com/azfunc/internal/_build/results?buildId=258656&view=artifacts&pathAsName=false&type=publishedArtifacts

5. Run Final Pipeline (Non-Prerelease Build)

   • Execute the pipeline again with IsPrerelease unchecked.
   • Wait for the pipeline to finish.
   • Download the artifact intended for release.

6. Ensure Access Requirements

   • Follow the partner release wiki:
     https://dev.azure.com/azure-sdk/internal/_wiki/wikis/internal.wiki/1/Partner-Release-Pipeline
   • Verify access to the required security group:
     https://coreidentity.microsoft.com/manage/Entitlement/entitlement/azuresdkpart-heqj

7. Upload TGZ to Partner Release Blob

   • Locate the generated .tgz package file.
   • Upload it to the correct team location in the blob container:
     https://ms.portal.azure.com/#view/Microsoft_Azure_Storage/ContainerMenuBlade/~/overview/storageAccountId/%2Fsubscriptions%2Fa18897a6-7e44-457d-9260-f2854c0aca42%2FresourceGroups%2Fazuresdkpartnerdrops%2Fproviders%2FMicrosoft.Storage%2FstorageAccounts%2Fazuresdkpartnerdrops/path/drops/etag/%220x8D680AE5A72EEFF%22

8. Run JS Partner Release Pipeline

   • Open the JS partner-release pipeline:
     https://dev.azure.com/azure-sdk/internal/_build?definitionId=6992&_a=summary
   • Run the pipeline using this path convention:

     <team>/<language>/<version>
     

   • Example:

     azure-functions/azure-functions-nodejs-extensions-servicebus/0.2.0-preview
     

9. Publish GitHub Release
   • Create and publish the corresponding GitHub release using the final version and artifacts.
   • https://github.com/Azure/azure-functions-nodejs-extensions/releases/new