bahdotsh/wrkflw

🛠️ wrkflw — Chạy và kiểm tra GitHub Actions ngay trên máy bạn

Một công cụ CLI/Rust giúp validate và thực thi workflow GitHub Actions (và GitLab CI) trực tiếp trên máy phát triển, trước khi đẩy lên máy chủ.

wrkflw là một công cụ dòng lệnh viết bằng Rust, cho phép bạn kiểm tra cú pháp và chạy thử các workflow GitHub Actions hoặn GitLab CI ngay trên máy cá nhân. Thay vì phải đẩy lên GitHub rồi mới biết lỗi, bạn có thể dùng wrkflw để kiểm tra và chạy workflow trong môi trường địa phương với giao diện đồ họa TUI trực tuyến trong terminal.

✨ Điểm nổi bật

• Giao diện TUI tương tác: Hỗ trợ các tab Workflows, Execution, DAG, Logs, Trigger, Secrets, Help ngay trong terminal nhờ thư viện ratatui.
• Kiểm tra cú pháp và cấu trúc: Kiểm tra cú pháp YAML, cấu trúc workflow và kiểu dữ liệu composite action với mã thoát thân thiện CI/CD.
• Thực thi đa môi trường: Hỗ trợ chạy bằng Docker, Podman, emulation, hoặc secure emulation (không dùng container).
• Lọc theo diff thông minh: Bỏ qua workflow không khới điều kiện on: với sự kiện hoặc tệp thay đổi.
• Chế độ theo dõi (Watch mode): Tự động chạy lại workflow khi thay đổi tệp, có lọc theo trigger.
• Chọn job riêng lẻ: Chạy từng job bằng --job hoặc qua giao diện TUI.
• Giải quyết phụ thuộc job: Tự động sắp xếp thứ tự job dựa trên needs, chạy song song các job độc lập.
• Đánh giá biểu thức GitHub Actions: Hỗ trợ ${{ ... }} bao gồm toJSON, fromJSON, contains, startsWith, v.v.
• Hỗ trợ action đa dạng: Docker container actions, JavaScript actions, composite actions và local actions.
• Workflow tái sử dụng: Chạy caller jobs qua jobs.<id>.uses với truyền output.
• Quản lý secrets đa nguồn: Hỗ trợ env, file, Vault, AWS, Azure, GCP với mã hóa AES-256-GCM.
• Kích hoạt từ xa: Trigger workflow workflow_dispatch trên GitHub hoặc GitLab.
• Hỗ trợ GitLab CI: Validate và trigger pipeline GitLab.

💡 Vì sao đáng chú ý

wrkflw khác biệt từ các công cụ chạy GitHub Actions cục bản khác như act bởi giao diện TUI trực quan và khả năng lọc thông minh dựa trên diff. Nó không chỉ là một runner mà còn là công cụ kiểm tra đầy đủ với hỗ trợ nhiều loại runtime và nguồn secrets. Phù hợp cho các nhóm phát triển muốn tối ưu quy trình CI/CD mà không cần phụ thuộc vào nền tảng.

#GitHubActions #DevOps #Rust #TUI #CI #TiniX