Skip to content

v3.0.0 - Universal GitHub Actions Runner Manager

Choose a tag to compare

View all tags
@ibuildrun ibuildrun released this 17 Jan 17:39
· 49 commits to main since this release
v3.0.0
9a46223

Release v3.0.0 - Universal GitHub Actions Runner Manager

🎉 Major Release

This is a complete rewrite of the GitHub Actions Runner Manager with a focus on modularity, flexibility, and universal repository support.

✨ New Features

🏗️ Modular Architecture

  • Refactored monolithic script into 8 specialized modules:
    • Config.ps1 - Configuration management with RunnerConfig class
    • GitHub.ps1 - GitHub API integration
    • UI.ps1 - User interface components
    • TokenManager.ps1 - Token configuration and storage
    • RepositorySelector.ps1 - Repository search and selection
    • RunnerInstaller.ps1 - Runner installation/uninstallation
    • RunnerManager.ps1 - Process management
    • AutoStart.ps1 - Auto-start functionality

🔍 Repository Search

  • Search and select from any of your GitHub repositories via API
  • Filter repositories by name or description
  • Support for both public and private repositories
  • Visual indicators for repository visibility (🔒 private, 🌐 public)

🔐 Flexible Token Storage

Three storage options to fit your security needs:

  1. Environment Variable (Recommended) - Persistent, user-level storage
  2. Configuration File - Local, base64 encoded
  3. Session Only - Not saved, re-enter each time

✅ Token Validation

  • Validates GitHub token before saving
  • Shows authenticated username
  • Prevents invalid tokens from being stored

📋 Enhanced UI

  • Categorized menu options (Configuration, Runner Management, Auto-Start, Advanced)
  • Real-time status display showing repository and token configuration
  • Color-coded status indicators
  • Improved error messages and user feedback

📚 Comprehensive Documentation

  • English README with detailed usage instructions
  • Russian README (README.ru.md) for Russian-speaking users
  • MIT License
  • Detailed troubleshooting section
  • Security best practices

🔄 Changes

Improved

  • Better error handling across all modules
  • More informative status messages
  • Cleaner code organization
  • Enhanced security with multiple token storage options

Removed

  • ❌ Hardcoded repository references
  • ❌ .env files (replaced with interactive configuration)
  • ❌ Manual configuration file editing

⚠️ Breaking Changes

  1. Configuration Required: First-time users must configure token and repository via interactive menu
  2. No .env Files: Configuration is now done entirely through the menu system
  3. Repository Selection: Must select repository via API search (no manual entry)

📦 Installation

# Clone the repository
git clone https://github.com/ibuildrun/avyx-deploy.git
cd avyx-deploy

# Run the script
.\runner.ps1

🚀 Quick Start

  1. Run .\runner.ps1
  2. Select Option 1 - Configure GitHub Token
  3. Select Option 2 - Select Repository
  4. Select Option 3 - Install Runner
  5. Select Option 4 - Start Runner

📊 Statistics

  • 15 files changed
  • 1,447 insertions
  • 447 deletions
  • 8 new modules
  • 2 language versions (English + Russian)

🔗 Links

🙏 Acknowledgments

Thank you to everyone who provided feedback on the previous versions. This release addresses many of the pain points and makes the tool truly universal.

🐛 Known Issues

None at this time. Please report any issues on the GitHub Issues page.

📝 Migration Guide

From v2.x to v3.0.0

  1. Stop existing runner: Use old script to stop runner
  2. Update repository: git pull origin main
  3. Run new script: .\runner.ps1
  4. Configure: Follow the interactive setup (Options 1 & 2)
  5. Reinstall: Install runner with new configuration (Option 3)

Your existing runner installation at C:\actions-runner will be detected and you'll be prompted to reinstall.

Full Changelog: v2.0.0...v3.0.0

Assets 2
Loading