create_github_release.yaml

name: Create Github Release

on:
  workflow_dispatch:
    inputs:
      Release_Version:
        description: "Provide a release version. e.g. v3.1.0"
        required: true
        type: string
      Build_OSX:
        description: "Build OSX artifacts. It can sometimes take a while (1hr+) to find a Mac runner."
        required: false
        default: true
        type: boolean

jobs:
  generate_extractor_artifacts:
    name: Generate extractor artifacts
    strategy:
      matrix:
        dotnet-runtime: ${{ fromJSON(inputs.Build_OSX && '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64","win-x64","osx-arm64","osx-x64"]' || '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64","win-x64"]') }}
    # Dynamically set the runner OS based on the .NET runtime
    runs-on: ${{ fromJSON('{"linux-x64":"ubuntu-latest", "linux-arm64":"ubuntu-latest", "linux-musl-x64":"ubuntu-latest", "linux-musl-arm64":"ubuntu-latest", "win-x64":"windows-latest", "osx-arm64":"macos-latest", "osx-x64":"macos-latest"}')[matrix.dotnet-runtime] }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v5

      - name: Setup .NET
        uses: actions/setup-dotnet@v5
        with:
          dotnet-version: 10.x

      - name: Generate executable
        run: |
          Set-StrictMode -Version Latest
          $ErrorActionPreference = "Stop"
          $VerbosePreference = "Continue"
          $InformationPreference = "Continue"

          $releaseTag = '${{ github.event.inputs.Release_Version }}'
          $releaseTag = $releaseTag.Trim()

          if ($releaseTag -notmatch '(?<maj>\d+)\.(?<min>\d+)\.(?<patch>\d+)')
          {
            throw "Release_Version must contain <major>.<minor>.<patch> (for example, v7.0.0-alpha.2.0.0). Actual: '${{ github.event.inputs.Release_Version }}'"
          }

          $formattedVersion = "$($Matches.maj).$($Matches.min).$($Matches.patch)"

          Write-Information "Creating output directory..."
          $outputFolderPath = Join-Path "${{ runner.temp }}" "extractor-output"
          New-Item -Path "$outputFolderPath" -ItemType "Directory"

          Write-Information "Publishing application..."
          $sourcePath = Join-Path "${{ github.workspace }}" "src" "extractor" "extractor.csproj"
          & dotnet publish "$sourcePath" --self-contained --runtime "${{ matrix.dotnet-runtime }}" -p:PublishSingleFile=true -p:Version="$formattedVersion" --output "$outputFolderPath"
          if ($LASTEXITCODE -ne 0) { throw "Generating extractor failed."}

          Write-Information "Zipping application..."
          $sourceFolderPath = Join-Path "$outputFolderPath" "*"
          $destinationFilePath = Join-Path "$outputFolderPath" "extractor-${{ matrix.dotnet-runtime }}.zip"
          Compress-Archive -Path $sourceFolderPath -DestinationPath $destinationFilePath -CompressionLevel Optimal
          "ZIP_FILE_PATH=$destinationFilePath" | Out-File -FilePath $env:GITHUB_ENV -Append

          Write-Information "Execution complete."
        shell: pwsh

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: extractor-${{ matrix.dotnet-runtime }}
          path: ${{ env.ZIP_FILE_PATH }}

  generate_publisher_artifacts:
    name: Generate publisher artifacts
    strategy:
      matrix:
        dotnet-runtime: ${{ fromJSON(inputs.Build_OSX && '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64","win-x64","osx-arm64","osx-x64"]' || '["linux-x64","linux-arm64","linux-musl-x64","linux-musl-arm64","win-x64"]') }}
    # Dynamically set the runner OS based on the .NET runtime
    runs-on: ${{ fromJSON('{"linux-x64":"ubuntu-latest", "linux-arm64":"ubuntu-latest", "linux-musl-x64":"ubuntu-latest", "linux-musl-arm64":"ubuntu-latest", "win-x64":"windows-latest", "osx-arm64":"macos-latest", "osx-x64":"macos-latest"}')[matrix.dotnet-runtime] }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Setup .NET
        uses: actions/setup-dotnet@v3
        with:
          dotnet-version: 10.x

      - name: Generate executable
        run: |
          Set-StrictMode -Version Latest
          $ErrorActionPreference = "Stop"
          $VerbosePreference = "Continue"
          $InformationPreference = "Continue"

          $releaseTag = '${{ github.event.inputs.Release_Version }}'
          $releaseTag = $releaseTag.Trim()

          if ($releaseTag -notmatch '(?<maj>\d+)\.(?<min>\d+)\.(?<patch>\d+)')
          {
            throw "Release_Version must contain <major>.<minor>.<patch> (for example, v7.0.0-alpha.2.0.0). Actual: '${{ github.event.inputs.Release_Version }}'"
          }

          $formattedVersion = "$($Matches.maj).$($Matches.min).$($Matches.patch)"

          Write-Information "Creating output directory..."
          $outputFolderPath = Join-Path "${{ runner.temp }}" "publisher-output"
          New-Item -Path "$outputFolderPath" -ItemType "Directory"

          Write-Information "Publishing application..."
          $sourcePath = Join-Path "${{ github.workspace }}" "src" "publisher" "publisher.csproj"
          & dotnet publish "$sourcePath" --self-contained --runtime "${{ matrix.dotnet-runtime }}" -p:PublishSingleFile=true -p:Version="$formattedVersion" --output "$outputFolderPath"
          if ($LASTEXITCODE -ne 0) { throw "Generating publisher failed."}

          Write-Information "Zipping application..."
          $sourceFolderPath = Join-Path "$outputFolderPath" "*"
          $destinationFilePath = Join-Path "$outputFolderPath" "publisher-${{ matrix.dotnet-runtime }}.zip"
          Compress-Archive -Path $sourceFolderPath -DestinationPath $destinationFilePath -CompressionLevel Optimal
          "ZIP_FILE_PATH=$destinationFilePath" | Out-File -FilePath $env:GITHUB_ENV -Append

          Write-Information "Execution complete."
        shell: pwsh

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: publisher-${{ matrix.dotnet-runtime }}
          path: ${{ env.ZIP_FILE_PATH }}

  generate_github_pipeline_artifacts:
    name: Generate GitHub artifacts
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Update versions in YAML
        run: |
          Set-StrictMode -Version Latest
          $ErrorActionPreference = "Stop"
          $VerbosePreference = "Continue"
          $InformationPreference = "Continue"

          $runExtractorPath = Join-Path "${{ github.workspace }}" "tools" "github_workflows" "run-extractor.yaml"
          (Get-Content -Path "$runExtractorPath") |
            ForEach-Object {$_ -Replace 'desired-version-goes-here', '${{ github.event.inputs.Release_Version }}'} |
              Set-Content -Path "$runExtractorPath"

          $runPublisherWithEnvPath = Join-Path "${{ github.workspace }}" "tools" "github_workflows" "run-publisher-with-env.yaml"
          (Get-Content -Path "$runPublisherWithEnvPath") |
            ForEach-Object {$_ -Replace 'desired-version-goes-here', '${{ github.event.inputs.Release_Version }}'} |
              Set-Content -Path "$runPublisherWithEnvPath"

          Write-Information "Execution complete."
        shell: pwsh

      - name: Setup artifact contents
        run: |
          Set-StrictMode -Version Latest
          $ErrorActionPreference = "Stop"
          $VerbosePreference = "Continue"
          $InformationPreference = "Continue"

          $artifactsFolderPath = Join-Path "${{ runner.temp }}" "github_artifacts"

          Write-Information "Copying GitHub workflows..."
          $sourceFolderPath = Join-Path "${{ github.workspace }}" "tools" "github_workflows" "*"
          $destinationFolderPath = Join-Path "$artifactsFolderPath" ".github" "workflows"
          New-Item -Path "$destinationFolderPath" -ItemType "Directory"
          Copy-Item -Path "$sourceFolderPath" -Destination "$destinationFolderPath" -Recurse

          Write-Information "Zipping artifacts..."
          $destinationFilePath = Join-Path "${{ runner.temp }}" "Github.zip"

          # We use System.IO.Compression.ZipFile instead of Compress-Archive because of this issue: https://github.com/PowerShell/Microsoft.PowerShell.Archive/issues/66
          [System.IO.Compression.ZipFile]::CreateFromDirectory("$artifactsFolderPath", "$destinationFilePath")

          Write-Information "Execution complete."
        shell: pwsh

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: github
          path: ${{ runner.temp }}/Github.zip

  generate_ado_pipeline_artifacts:
    name: Generate Azure DevOps artifacts
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Update versions in YAML
        run: |
          Set-StrictMode -Version Latest
          $ErrorActionPreference = "Stop"
          $VerbosePreference = "Continue"
          $InformationPreference = "Continue"

          $runExtractorPath = Join-Path "${{ github.workspace }}" "tools" "azdo_pipelines" "run-extractor.yaml"
          (Get-Content -Path "$runExtractorPath") |
            ForEach-Object {$_ -Replace 'desired-version-goes-here', '${{ github.event.inputs.Release_Version }}'} |
              Set-Content -Path "$runExtractorPath"

          $runPublisherWithEnvPath = Join-Path "${{ github.workspace }}" "tools" "azdo_pipelines" "run-publisher-with-env.yaml"
          (Get-Content -Path "$runPublisherWithEnvPath") |
            ForEach-Object {$_ -Replace 'desired-version-goes-here', '${{ github.event.inputs.Release_Version }}'} |
              Set-Content -Path "$runPublisherWithEnvPath"

          Write-Information "Execution complete."
        shell: pwsh

      - name: Setup artifact contents
        run: |
          Set-StrictMode -Version Latest
          $ErrorActionPreference = "Stop"
          $VerbosePreference = "Continue"
          $InformationPreference = "Continue"

          $artifactsFolderPath = Join-Path "${{ runner.temp }}" "azdo_artifacts"

          Write-Information "Copying Azure DevOps pipelines..."
          $sourceFolderPath = Join-Path "${{ github.workspace }}" "tools" "azdo_pipelines" "*"
          $destinationFolderPath = Join-Path "$artifactsFolderPath" "tools" "pipelines"
          New-Item -Path "$destinationFolderPath" -ItemType "Directory"
          Copy-Item -Path "$sourceFolderPath" -Destination "$destinationFolderPath" -Recurse

          Write-Information "Zipping artifacts..."
          $destinationFilePath = Join-Path "${{ runner.temp }}" "Azure_DevOps.zip"

          # We use System.IO.Compression.ZipFile instead of Compress-Archive because of this issue: https://github.com/PowerShell/Microsoft.PowerShell.Archive/issues/66
          [System.IO.Compression.ZipFile]::CreateFromDirectory("$artifactsFolderPath", "$destinationFilePath")

          Write-Information "Execution complete."
        shell: pwsh

      - name: Upload artifact
        uses: actions/upload-artifact@v5
        with:
          name: ado
          path: ${{ runner.temp }}/Azure_DevOps.zip

  generate_release:
    name: Generate release
    needs:
      [
        generate_extractor_artifacts,
        generate_publisher_artifacts,
        generate_github_pipeline_artifacts,
        generate_ado_pipeline_artifacts,
      ]
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: read
    steps:
      - name: Checkout repository
        uses: actions/checkout@v5

      - name: Download artifacts
        id: download-artifacts
        uses: actions/download-artifact@v5
        with:
          merge-multiple: true
          path: ${{ runner.temp }}/release-artifacts

      - name: Create release
        env:
          ARTIFACT_DOWNLOAD_PATH: ${{ steps.download-artifacts.outputs.download-path }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GITHUB_WORKSPACE: ${{github.workspace}}
          RELEASE_TAG: ${{ github.event.inputs.Release_Version }}
          COMMIT_ID: ${{ github.sha }}
        run: |
          set -euo pipefail

          # Check if this is prerelease
          VERSION="${RELEASE_TAG#v}"    # strip leading "v" if present
          PRERELEASE_FLAG=""
          if [[ "$VERSION" == *-* ]]; then
            PRERELEASE_FLAG="--prerelease"
          fi

          # Create the release
          gh release create "$RELEASE_TAG" \
            --title "APIOps Toolkit for Azure APIM $RELEASE_TAG" \
            --generate-notes \
            $PRERELEASE_FLAG \
            --draft \
            --target "$COMMIT_ID"

          # Upload assets (non-macOS)
          gh release upload "$RELEASE_TAG" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-linux-arm64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-linux-musl-arm64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-linux-musl-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-linux-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-win-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-linux-arm64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-linux-musl-arm64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-linux-musl-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-linux-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-win-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/Github.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/Azure_DevOps.zip" \
            --repo "$GITHUB_REPOSITORY" \
            --clobber

      - name: Upload macOS assets
        if: ${{ inputs.Build_OSX }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          RELEASE_TAG: ${{ github.event.inputs.Release_Version }}
        run: |
          set -euo pipefail

          ARTIFACT_DOWNLOAD_PATH="${{ runner.temp }}/release-artifacts"

          gh release upload "$RELEASE_TAG" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-osx-arm64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/extractor-osx-x64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-osx-arm64.zip" \
            "$ARTIFACT_DOWNLOAD_PATH/publisher-osx-x64.zip" \
            --repo "$GITHUB_REPOSITORY" \
            --clobber