Azure DevOps Pipelines

Go to the Buildstash extension in the Visual Studio Marketplace for Azure Pipelines.

Select "Get it free" to install.

Select the organization you'd like to install the extension on from the dropdown.

Alternatively, if you're using Azure DevOps Server, select "Download".

Once the extension is installed you'll be able to proceed to using it in your pipelines.

You can copy and paste the provided code into your pipeline yaml script. Set your file paths, platform, stream, and version fields as applicable. See further down for a full list of inputs with descriptions.

- task: BuildstashUpload@1
    displayName: Upload to Buildstash
    inputs:
      apiKey: $(BUILDSTASH_API_KEY)
      structure: 'file'
      primaryFilePath: 'example.exe'
      versionComponent1Major: '1'
      versionComponent2Minor: '0'
      versionComponent3Patch: '1'
      versionComponentExtra: 'beta'
      versionComponentMeta: '2024.12.02'
      customBuildNumber: '12345'
      platform: 'windows'
      stream: 'default'

      # Optional CI info
      ciBuildDuration: '15m30s'

      # Optional VC info
      vcHostType: 'git'
      vcHost: 'github'
      vcRepoName: $(Build.Repository.Name)
      vcRepoUrl: $(Build.Repository.Uri)
      vcBranch: $(Build.SourceBranchName)
      vcCommitSha: $(Build.SourceVersion)
      vcCommitUrl: $(Build.Repository.Uri)/commit/$(Build.SourceVersion)

When editing your Pipeline, go to "Variables" and add a new variable.

To match the sample code above, call the API key BUILDSTASH_API_KEY, paste in your previously generated key, and ensure you select "Keep this value secret".

Note, the API key is application-specific, i.e. matched to one application in Buildstash. So you'll want to generate a unique API key for each pipeline and application.

By default Azure DevOps will timeout jobs after 60 minutes.

This is probably fine, but if you are uploading a particularly massive build, or have a slow connection, you may wish to tweak this.

This is done on the job as below:

jobs:- job: TesttimeoutInMinutes: 60 # how long to run the job before automatically cancelling in minutes - increase if needed for large uploads

Refer to Azure docs for more detail.

Once the build is successfully uploaded, some useful information is provided by the task as outputs. For example, the URL to download the build directly. See below for a full list of outputs.

Successful Pipeline runs will now be sending your builds into Buildstash, giving you seamless management, organization, and distribution of your builds.