๐ Introduction
Build-Agent is a flexible build Docker image, built on top of NUKE, designed to standardize and simplify the CI/CD process for various types of applications, especially:
- ๐งฑ Docker images builds with tagging and registry push
- ๐ฆ Node.js applications (Express, Angular, React, etc.)
- ๐ Artifacts
โจ Featuresโ
- ๐ Reusable build logic via NUKE targets
- ๐ Dynamic build and app environment generation from pipeline secrets
- ๐ช Automatic detection of Node.js package managers
- ๐ฌ Discord integration for notifications
- ๐ GitHub integration for creating releases with controlled release strategy
- ๐ Orchestration by convention or via
.build.scripts
and.build.copy
- ๐งช Dry-run mode for safe testing
- ๐ข Node.js runtime
- ๐ ฐ๏ธ Latest Angular and Angular CLI
- ๐ป PowerShell for cross-platform scripting
- ๐ฃ .NET 8 SDK for .NET builds and tools
- ๐๏ธ Git for source control
- ๐ข GitVersion for semantic versioning in CI/CD
- ๐ CHANGELOG generation with Git integration and customizable formatting
- โก Forge build system with specialized commands for different project types
โก Fast Trackโ
Ready to get started? Check out our Fast Track Guide for quick examples, or explore the comprehensive Build Types Reference to understand all available build commands and choose the right approach for your project.
For advanced configuration, see Customization Options.
๐๏ธ Architecture & Developmentโ
For developers and advanced users, explore our architecture guides:
- Multi-Build Architecture - Understanding the modular build system
- Dependency Injection - Service architecture and testing
- Development Guide - Complete setup and contribution guide
- Configuration & Compatibility - Environment setup and platform compatibility