Skip to content

Releases: ibuildrun/github-runner-manager

Release list

v3.1.0 Localization, Multi-Runner & UX Improvements

v3.1.0 Localization, Multi-Runner & UX Improvements Latest
Latest

Choose a tag to compare

View all tags
@ibuildrun ibuildrun released this 06 Feb 08:25
v3.1.0
0b5b70a

What's New in v3.1.0

Full Russian Localization

  • Complete Russian translation for all UI elements, menus, and messages
  • Translated: Main menu, Platform selection, Token config, Repository selection, Runner status, Multi-runner management, Docker management, Telegram config, GitHub Secrets Manager (120+ keys), Help Guide
  • Auto-detection of system language on first run
  • Language switching via menu option 19
  • UTF-8 BOM encoding for proper Cyrillic display

Multi-Runner Management

  • Manage multiple local runners for different repositories
  • Add, select, and remove runners from a single interface
  • Each runner has its own directory, repository, and platform
  • Active runner shown in main menu status
  • Auto-migration for existing runner installations

Docker Improvements

  • Resource limits (Memory/CPU) when starting containers
  • Real-time resource usage monitoring (CPU, Memory, Network, Disk I/O)
  • New menu option: View resource usage
  • Resource info in Telegram notifications
  • Input validation for container operations
  • Animated loading indicator when checking containers

UX Improvements

  • Loading indicator while checking Docker and runner status
  • Dynamic banner text centering for multi-language support
  • Runner type visibility (Local Windows vs Docker)
  • Process PID and uptime display for running runners
  • Reduced Docker status check timeout (3s 2s)

Bug Fixes

  • Fixed real count of running Docker containers in menu
  • Fixed duplicate module loading conflicts
  • Fixed syntax errors and file encoding in Config.ps1
  • Fixed banner alignment for longer text
  • Added safe runner path resolution
  • Added UTF-8 BOM to all PowerShell modules

Full Changelog: https://github.com/ibuildrun/github-runner-manager/commits/v3.1.0

Assets 2
Loading

v3.0.0 - Universal GitHub Actions Runner Manager

v3.0.0 - Universal GitHub Actions Runner Manager

Choose a tag to compare

View all tags
@ibuildrun ibuildrun released this 17 Jan 17:39
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

Loading