azure-pipelines.yml

trigger:
  branches:
    include:
    - '*'
  tags:
    include:
    - release-*

parameters:
  - name: cache_nuget
    displayName: Cache NuGet packages
    type: boolean
    default: true
  - name: release_myget
    displayName: Release to MyGet
    type: string
    default: auto
    values:
      - auto # Only release to MyGet on public releases, otherwise skip
      - prerelease # Release to MyGet pre-release feed, regardless of release type
      - nightly # Release to MyGet nightly feed, regardless of release type
      - skip # Skip releasing to MyGet, regardless of release type
  - name: release
    displayName: Release
    type: string
    default: auto
    values:
      - auto # Only release to NuGet on public releases, otherwise skip
      - public # Release to NuGet, regardless of release type
      - skip # Skip releasing to NuGet, regardless of release type
  - name: sbom
    displayName: SBOM
    type: string
    default: auto
    values:
      - auto # Only generate SBOM for the develop branch, otherwise skip
      - force # Generate SBOM, regardless of branch
      - skip # Skip generating SBOM, regardless of branch

variables:
  solution: Umbraco.JsonSchema.Extensions.sln
  vmImage: 'ubuntu-latest'
  buildConfiguration: Release
  DOTNET_NOLOGO: true
  DOTNET_GENERATE_ASPNET_CERTIFICATE: false
  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
  DOTNET_CLI_TELEMETRY_OPTOUT: true

stages:
  - stage: Build
    variables:
      NUGET_PACKAGES: $(Pipeline.Workspace)/.nuget/packages
    jobs:
      - job: Build
        pool:
          vmImage: $(vmImage)
        steps:
          # Checkout source (avoid shallow clone to calculate version height)
          - checkout: self
            fetchDepth: 0

          # Setup build environment
          - task: UseDotNet@2
            displayName: Use .NET SDK from global.json
            inputs:
              useGlobalJson: true

          # Cache and restore NuGet packages
          - task: Cache@2
            condition: ${{ parameters.cache_nuget }}
            displayName: Cache NuGet packages
            inputs:
              key: 'nuget | "$(Agent.OS)" | **/packages.lock.json, !**/bin/**, !**/obj/**'
              restoreKeys: |
                nuget | "$(Agent.OS)"
                nuget
              path: $(NUGET_PACKAGES)

          - script: dotnet restore $(solution) --locked-mode
            displayName: Restore NuGet packages

          # Build
          - script: dotnet build $(solution) --configuration $(buildConfiguration) --no-restore -p:ContinuousIntegrationBuild=true
            displayName: Run dotnet build
            name: build

          # Pack
          - script: dotnet pack $(solution) --configuration $(buildConfiguration) --no-build --output $(Build.ArtifactStagingDirectory)/nupkg
            displayName: Run dotnet pack

          # Publish
          - publish: $(Build.ArtifactStagingDirectory)/nupkg
            artifact: nupkg
            displayName: Publish NuGet packages

          - publish: $(Build.SourcesDirectory)
            artifact: build_output
            displayName: Publish build output

  - stage: Test
    dependsOn: Build
    variables:
      NUGET_PACKAGES: $(Pipeline.Workspace)/.nuget/packages
    jobs:
      - job: UnitTests
        displayName: Unit Tests
        strategy:
          matrix:
            Windows:
              vmImage: 'windows-latest'
            Linux:
              vmImage: 'ubuntu-latest'
            macOS:
              vmImage: 'macos-latest'
        pool:
          vmImage: $(vmImage)
        steps:
          # Setup test environment
          - task: DownloadPipelineArtifact@2
            displayName: Download build output artifact
            inputs:
              artifact: build_output
              path: $(Build.SourcesDirectory)

          - task: UseDotNet@2
            displayName: Use .NET SDK from global.json
            inputs:
              useGlobalJson: true

          # Cache and restore NuGet packages
          - task: Cache@2
            condition: ${{ parameters.cache_nuget }}
            displayName: Cache NuGet packages
            inputs:
              key: 'nuget | "$(Agent.OS)" | **/packages.lock.json, !**/bin/**, !**/obj/**'
              restoreKeys: |
                nuget | "$(Agent.OS)"
                nuget
              path: $(NUGET_PACKAGES)

          - script: dotnet restore $(solution) --locked-mode
            displayName: Restore NuGet packages

          # Test
          - script: dotnet test --solution $(solution) --configuration $(buildConfiguration) --no-build --results-directory $(Build.ArtifactStagingDirectory)/tests --report-trx
            displayName: Run dotnet test

          # Publish
          - task: PublishTestResults@2
            displayName: Publish test results
            condition: succeededOrFailed()
            inputs:
              testResultsFormat: VSTest
              testResultsFiles: '*.trx'
              searchFolder: $(Build.ArtifactStagingDirectory)/tests
              testRunTitle: Unit Tests - $(Agent.OS)
              configuration: $(buildConfiguration)

  - stage: ReleaseMyGet
    displayName: Release to MyGet
    dependsOn:
      - Build
      - Test
    condition: |
      and(
        succeeded('Build'),
        ne('${{ parameters.release_myget }}', 'skip'),
        or(
          ne('${{ parameters.release_myget }}', 'auto'),
          eq(dependencies.Build.outputs['Build.build.NBGV_PublicRelease'], true)
        )
      )
    jobs:
      - job: NuGet
        pool:
          vmImage: 'windows-latest' # NuGetCommand@2 requires Mono and is no longer supported on Ubuntu 24.04+
        steps:
          - checkout: none

          - download: current
            artifact: nupkg
            displayName: Download nupkg artifact

          - task: NuGetCommand@2
            displayName: NuGet push
            inputs:
              command: push
              packagesToPush: '$(Pipeline.Workspace)/nupkg/*.nupkg'
              nuGetFeedType: external
              ${{ if eq(parameters.release_myget, 'nightly') }}:
                publishFeedCredentials: 'MyGet - Nightly'
              ${{ else }}:
                publishFeedCredentials: 'MyGet - Pre-releases'

  - stage: Release
    dependsOn:
      - Build
      - Test
      - ReleaseMyGet
    condition: |
      and(
        succeeded('Build'),
        ne('${{ parameters.release }}', 'skip'),
        or(
          ne('${{ parameters.release }}', 'auto'),
          eq(dependencies.Build.outputs['Build.build.NBGV_PublicRelease'], true)
        )
      )
    jobs:
      - job: NuGet
        pool:
          vmImage: 'windows-latest' # NuGetCommand@2 requires Mono and is no longer supported on Ubuntu 24.04+
        steps:
          - checkout: none

          - download: current
            artifact: nupkg
            displayName: Download nupkg artifact

          - task: NuGetCommand@2
            displayName: NuGet push
            inputs:
              command: push
              packagesToPush: '$(Pipeline.Workspace)/nupkg/*.nupkg'
              nuGetFeedType: external
              publishFeedCredentials: 'NuGet'

  # Generate SBOM on development branch
  - stage: SBOM
    dependsOn: Build
    condition: |
      and(
        succeeded(),
        ne('${{ parameters.sbom }}', 'skip'),
        or(
          ne('${{ parameters.sbom }}', 'auto'),
          eq(variables['Build.SourceBranch'], 'refs/heads/develop')
        )
      )
    variables:
      majorVersion: $[ stageDependencies.Build.Build.outputs['build.NBGV_VersionMajor'] ]
    jobs:
      - job: GenerateSBOM
        displayName: Generate SBOM
        pool:
          vmImage: $(vmImage)
        steps:
          - template: generate-sbom.yml
            parameters:
              productGroup: 'Umbraco'
              productName: 'Umbraco.JsonSchema.Extensions'
              baseUrl: $(DT_BASE_URL)
              apiKey: $(DT_API_KEY)
              majorVersion: $(majorVersion)