Skip to content

phase-3-build-ci-cd.md

Latest commit

 

History

History
42 lines (32 loc) · 1.6 KB

phase-3-build-ci-cd.md

File metadata and controls

42 lines (32 loc) · 1.6 KB

Phase 3 -- Build System and CI/CD

Status: Complete

Related ADRs: ADR 004

Summary

Set up Cake SDK build script, GitHub Actions workflows for CI and release, and install scripts for cross-platform distribution.

Tasks

  • Create build.cs with Cake SDK (Clean, Build, Test, Publish tasks)
  • Create .config/dotnet-tools.json with Cake.Tool 6.0.0
  • Create .github/workflows/ci.yaml (PR validation: build + test)
  • Create .github/workflows/release.yaml (tag-triggered: matrix build, archive, GitHub Release)
  • Create install.ps1 (Windows installer with auto-detect, PATH setup, dry-run)
  • Create install.sh (Linux/macOS installer with platform detection, uninstall)
  • Add MinVer for git-tag-based versioning
  • Add NuGet.Config to pin package source

Running the build

dotnet tool restore
dotnet run build.cs                    # Default: Clean + Build + Test
dotnet run build.cs --target Publish   # Also publish self-contained binaries

Key Files

build.cs                               # Cake SDK build script
.config/dotnet-tools.json              # Cake.Tool local tool manifest
.github/workflows/ci.yaml             # PR validation
.github/workflows/release.yaml        # Release pipeline
install.ps1                            # Windows installer
install.sh                             # Linux/macOS installer
global.json                            # .NET SDK version pin
Directory.Build.props                  # Shared build properties
Directory.Packages.props               # Central package management