@ongtrieuhau861457/runner-tailscale-sync 1.260202.11920

package/README.md

@@ -0,0 +1,310 @@
+# runner-tailscale-sync
+
+Đồng bộ runner-data giữa các runner trên GitHub Actions, Azure Pipeline qua Tailscale network.
+
+## ✨ Tính năng
+
+- 🔄 Tự động đồng bộ `.runner-data` giữa các runner
+- 🌐 Sử dụng Tailscale để kết nối an toàn giữa runners
+- 🛑 Tự động stop services trên runner cũ khi runner mới bắt đầu
+- 📦 Push data lên git repository
+- 🎯 Hỗ trợ cả CLI và Library
+- 🪟 Cross-platform (Windows + Linux)
+- 📊 Logging chi tiết với version tracking
+
+## 📦 Cài đặt
+
+```bash
+npm install runner-tailscale-sync
+
+# Hoặc global
+npm install -g runner-tailscale-sync
+```
+
+## 🚀 Sử dụng
+
+### CLI
+
+```bash
+# Full sync workflow
+TAILSCALE_ENABLE=1 runner-sync
+
+# Chỉ khởi tạo Tailscale
+runner-sync init
+
+# Chỉ push git
+runner-sync push
+
+# Xem status
+runner-sync status
+
+# Custom working directory
+runner-sync --cwd /path/to/project
+
+# Verbose mode
+runner-sync -v
+```
+
+### Library
+
+```javascript
+const runnerSync = require('runner-tailscale-sync');
+
+// Full sync
+await runnerSync.sync({
+  cwd: '/path/to/project',
+  verbose: true,
+});
+
+// Chỉ init
+await runnerSync.init();
+
+// Chỉ push git
+await runnerSync.push();
+
+// Xem status
+await runnerSync.status();
+```
+
+### Advanced Usage - Sử dụng modules riêng lẻ
+
+```javascript
+const { 
+  Config, 
+  Logger, 
+  syncOrchestrator,
+  runnerDetector,
+  dataSync,
+  tailscale 
+} = require('runner-tailscale-sync');
+
+// Tạo config
+const config = new Config({ cwd: process.cwd() });
+const logger = new Logger({ packageName: 'my-tool', version: '1.0.0' });
+
+// Detect previous runner
+const detection = await runnerDetector.detectPreviousRunner(config, logger);
+
+// Pull data
+if (detection.previousRunner) {
+  await dataSync.pullData(config, detection.previousRunner, logger);
+}
+
+// Hoặc orchestrate toàn bộ
+await syncOrchestrator.orchestrate(config, logger);
+```
+
+## ⚙️ Cấu hình
+
+### Environment Variables
+
+```bash
+# Tailscale (required nếu TAILSCALE_ENABLE=1)
+TAILSCALE_CLIENT_ID=your_client_id
+TAILSCALE_CLIENT_SECRET=your_client_secret
+TAILSCALE_TAGS=tag:ci
+TAILSCALE_ENABLE=1
+
+# Services to stop on previous runner
+SERVICES_TO_STOP=cloudflared,pocketbase,http-server
+
+# Git
+GIT_PUSH_ENABLED=1
+GIT_BRANCH=main
+
+# Working directory
+TOOL_CWD=/path/to/project
+```
+
+### .env File
+
+```env
+TAILSCALE_CLIENT_ID=tskey-client-xxxxx
+TAILSCALE_CLIENT_SECRET=tskey-xxxxx
+TAILSCALE_TAGS=tag:ci
+TAILSCALE_ENABLE=1
+SERVICES_TO_STOP=cloudflared,pocketbase
+GIT_PUSH_ENABLED=1
+GIT_BRANCH=main
+```
+
+## 📂 Cấu trúc dữ liệu
+
+Tất cả dữ liệu được lưu trong `.runner-data/`:
+
+```
+.runner-data/
+├── logs/              # Log files
+├── pid/               # PID files
+├── data-services/     # Service data
+└── tmp/               # Temporary files
+```
+
+## 🔄 Quy trình hoạt động
+
+1. **Runner01** khởi động → Join Tailscale → Chạy 55 phút → Dữ liệu được lưu trong `.runner-data/`
+2. **Runner02** bắt đầu:
+   - Join Tailscale network
+   - Detect Runner01 (cùng tag, đang active)
+   - Pull `.runner-data/` từ Runner01
+   - Stop services trên Runner01 (cloudflared, pocketbase, etc.)
+   - Chạy services trên Runner02
+   - Push `.runner-data/` lên git repository
+3. **Runner01** → **Runner02** xoay vòng liên tục
+
+## 🎯 Use Cases
+
+### GitHub Actions
+
+```yaml
+- name: Setup Tailscale Sync
+  env:
+    TAILSCALE_CLIENT_ID: ${{ secrets.TAILSCALE_CLIENT_ID }}
+    TAILSCALE_CLIENT_SECRET: ${{ secrets.TAILSCALE_CLIENT_SECRET }}
+    TAILSCALE_ENABLE: 1
+  run: |
+    npm install -g runner-tailscale-sync
+    runner-sync
+```
+
+### Azure DevOps
+
+```yaml
+- script: |
+    npm install -g runner-tailscale-sync
+    runner-sync
+  env:
+    TAILSCALE_CLIENT_ID: $(TAILSCALE_CLIENT_ID)
+    TAILSCALE_CLIENT_SECRET: $(TAILSCALE_CLIENT_SECRET)
+    TAILSCALE_ENABLE: 1
+  displayName: 'Sync Runner Data'
+```
+
+### Self-hosted Runner
+
+```bash
+# Install
+npm install -g runner-tailscale-sync
+
+# Add to runner startup script
+export TAILSCALE_ENABLE=1
+export TAILSCALE_CLIENT_ID=your_client_id
+export TAILSCALE_CLIENT_SECRET=your_secret
+
+runner-sync
+```
+
+## 🛠️ Development
+
+### Scripts
+
+```bash
+# Generate new version (VN timezone: 1.yyMMdd.1HHmm)
+npm run version
+
+# Build validation
+npm run build
+
+# Publish to npm
+npm run publish
+
+# Dry run publish
+node scripts/publish.js --dry-run
+```
+
+### Testing Locally
+
+```bash
+# Link globally
+npm link
+
+# Test CLI
+runner-sync --help
+runner-sync status
+
+# Test as library
+node -e "require('./src/index.js').status().then(console.log)"
+```
+
+## 📝 Version Format
+
+Version theo giờ Việt Nam (UTC+7): `1.yyMMdd.1HHmm`
+
+Ví dụ:
+- Build lúc 15:30 ngày 02/02/2025 → `1.250202.11530`
+- Build lúc 09:45 ngày 15/03/2025 → `1.250315.10945`
+
+Đảm bảo semver compliance và tự động tăng theo thời gian.
+
+## 🔧 Yêu cầu hệ thống
+
+- Node.js >= 20
+- Git (cho tính năng push)
+- Tailscale (sẽ tự động cài trên Linux)
+- rsync hoặc scp (cho data sync)
+
+### Windows
+
+Trên Windows, cần cài thêm:
+- [Tailscale for Windows](https://tailscale.com/download/windows)
+- Git for Windows (có sẵn ssh/scp)
+- Hoặc cài rsync qua: `choco install rsync` hoặc WSL
+
+Cấu hình đường dẫn trong `.env`:
+```env
+SSH_PATH=C:\Program Files\Git\usr\bin\ssh.exe
+RSYNC_PATH=C:\Program Files\rsync\rsync.exe
+```
+
+## 🐛 Troubleshooting
+
+### Tailscale không kết nối được
+
+```bash
+# Kiểm tra Tailscale status
+tailscale status
+
+# Login manually
+tailscale login
+
+# Check logs
+runner-sync status -v
+```
+
+### Sync thất bại
+
+```bash
+# Kiểm tra SSH connection
+ssh runner01-ip echo "OK"
+
+# Test rsync
+rsync -avz runner01-ip:.runner-data/ .runner-data/
+
+# Verbose mode
+runner-sync -v
+```
+
+### Git push bị conflict
+
+```bash
+# Pull latest trước
+cd /path/to/repo
+git pull origin main
+
+# Hoặc disable git push
+export GIT_PUSH_ENABLED=0
+runner-sync
+```
+
+## 📄 License
+
+MIT
+
+## 🤝 Contributing
+
+Pull requests are welcome!
+
+## 📧 Support
+
+- Issues: [GitHub Issues](https://github.com/yourname/runner-tailscale-sync/issues)
+- Email: your-email@example.com

package/bin/runner-sync.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * bin/runner-sync.js
+ * CLI entry point
+ */
+
+const path = require("path");
+const Config = require("../src/utils/config");
+const Logger = require("../src/utils/logger");
+const { parseArgs, printHelp } = require("../src/cli/parser");
+const pkg = require("../package.json");
+
+// Parse arguments
+const { command, options } = parseArgs(process.argv);
+
+// Handle help
+if (options.help) {
+  printHelp();
+  process.exit(0);
+}
+
+// Handle version
+if (command === "version") {
+  console.log(`${pkg.name} v${pkg.version}`);
+  process.exit(0);
+}
+
+// Create config
+const config = new Config(options);
+
+// Create logger
+const logger = new Logger({
+  packageName: pkg.name,
+  version: pkg.version,
+  command,
+  verbose: options.verbose,
+  quiet: options.quiet,
+});
+
+// Print banner
+logger.printBanner();
+
+// Run command
+(async () => {
+  try {
+    let commandModule;
+
+    switch (command) {
+      case "init":
+        commandModule = require("../src/cli/commands/init");
+        break;
+      case "sync":
+        commandModule = require("../src/cli/commands/sync");
+        break;
+      case "push":
+        commandModule = require("../src/cli/commands/push");
+        break;
+      case "status":
+        commandModule = require("../src/cli/commands/status");
+        break;
+      default:
+        logger.error(`Unknown command: ${command}`);
+        printHelp();
+        process.exit(1);
+    }
+
+    const result = await commandModule.run(config, logger);
+
+    if (result.success) {
+      process.exit(0);
+    } else {
+      process.exit(1);
+    }
+  } catch (err) {
+    logger.error(err.message);
+
+    if (options.verbose && err.stack) {
+      logger.debug(err.stack);
+    }
+
+    // Exit with appropriate code
+    const exitCode = err.exitCode || 1;
+    process.exit(exitCode);
+  }
+})();

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@ongtrieuhau861457/runner-tailscale-sync",
+  "version": "1.260202.11920",
+  "description": "Đồng bộ runner-data giữa các runner trên GitHub Actions, Azure Pipeline qua Tailscale network",
+  "main": "src/index.js",
+  "bin": {
+    "runner-sync": "./bin/runner-sync.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "runner",
+    "sync",
+    "tailscale",
+    "github-actions",
+    "azure-devops",
+    "ci-cd"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "scripts": {
+    "version": "node scripts/version.js",
+    "build": "node scripts/build.js",
+    "publish": "node scripts/publish.js"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ongtrieuhau861457-hue/runner-tailscale-sync.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/adapters/fs.js

@@ -0,0 +1,160 @@
+/**
+ * adapters/fs.js
+ * File system operations với atomic write, ensure dir
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * Ensure directory exists
+ */
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+/**
+ * Ensure multiple directories exist
+ */
+function ensureDirs(dirPaths) {
+  dirPaths.forEach(ensureDir);
+}
+
+/**
+ * Read JSON file
+ */
+function readJson(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    return JSON.parse(content);
+  } catch (err) {
+    throw new Error(`Failed to read JSON from ${filePath}: ${err.message}`);
+  }
+}
+
+/**
+ * Write JSON file (atomic)
+ */
+function writeJson(filePath, data) {
+  const content = JSON.stringify(data, null, 2);
+  const tmpPath = `${filePath}.tmp`;
+
+  try {
+    // Write to temp file first
+    fs.writeFileSync(tmpPath, content, "utf8");
+
+    // Rename to actual file (atomic on most filesystems)
+    fs.renameSync(tmpPath, filePath);
+  } catch (err) {
+    // Clean up temp file if exists
+    if (fs.existsSync(tmpPath)) {
+      fs.unlinkSync(tmpPath);
+    }
+    throw new Error(`Failed to write JSON to ${filePath}: ${err.message}`);
+  }
+}
+
+/**
+ * Write text file (atomic)
+ */
+function writeFile(filePath, content) {
+  const tmpPath = `${filePath}.tmp`;
+
+  try {
+    fs.writeFileSync(tmpPath, content, "utf8");
+    fs.renameSync(tmpPath, filePath);
+  } catch (err) {
+    if (fs.existsSync(tmpPath)) {
+      fs.unlinkSync(tmpPath);
+    }
+    throw new Error(`Failed to write file ${filePath}: ${err.message}`);
+  }
+}
+
+/**
+ * Read text file
+ */
+function readFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch (err) {
+    throw new Error(`Failed to read file ${filePath}: ${err.message}`);
+  }
+}
+
+/**
+ * Check if path exists
+ */
+function exists(filePath) {
+  return fs.existsSync(filePath);
+}
+
+/**
+ * Delete file or directory recursively
+ */
+function remove(targetPath) {
+  if (!fs.existsSync(targetPath)) return;
+
+  if (fs.statSync(targetPath).isDirectory()) {
+    fs.rmSync(targetPath, { recursive: true, force: true });
+  } else {
+    fs.unlinkSync(targetPath);
+  }
+}
+
+/**
+ * Get directory size (recursive)
+ */
+function getDirSize(dirPath) {
+  let size = 0;
+
+  if (!fs.existsSync(dirPath)) return 0;
+
+  const files = fs.readdirSync(dirPath);
+  for (const file of files) {
+    const filePath = path.join(dirPath, file);
+    const stats = fs.statSync(filePath);
+
+    if (stats.isDirectory()) {
+      size += getDirSize(filePath);
+    } else {
+      size += stats.size;
+    }
+  }
+
+  return size;
+}
+
+/**
+ * Format bytes to human readable
+ */
+function formatBytes(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+
+module.exports = {
+  ensureDir,
+  ensureDirs,
+  readJson,
+  writeJson,
+  writeFile,
+  readFile,
+  exists,
+  remove,
+  getDirSize,
+  formatBytes,
+};