mxschmitt/action-tmate

🐛 SSH trực tiếp vào runner GitHub Actions để debug

Thêm một dòng YAML, nhận terminal live trên chính hệ thống đang chạy workflow — không cần guess, không cần log mò mẫm.

action-tmate là một GitHub Action cho phép bạn tương tác trực tiếp với host system nơi các workflow đang thực thi. Dùng tmate để tạo phiên SSH hoặc web terminal ngay trên runner, giúp bạn inspect environment, chạy lệnh thử, và sửa lỗi trong thời gian thực thay vì chỉ đọc log và đoán.

✨ Điểm nổi bật

• SSH hoặc Web shell: Kết nối trực tiếp vào runner qua SSH hoặc terminal trên trình duyệt từ tab Checks của Pull Request
• Workflow tiếp tục sau debug: Phiên tmate không chặn workflow — job vẫn chạy tiếp sau khi bạn thoát
• Detached mode: Chạy tmate ở chế độ nền, job tiếp tục ngay; nhận ssh-command, ssh-address, web-url để dùng trong các job khác
• Manual trigger: Kích hoạt debug chỉ khi cần qua workflow_dispatch với input debug_enabled, không cần chỉnh sửa code mỗi lần
• Hỗ trợ đa nền tảng: Linux, macOS, Windows — không giới hạn runner
• Timeout tùy chỉnh: Thiết lập timeout-minutes để kiểm soát thời gian session mở, tránh lãng phí GitHub Actions minutes
• Chỉ chạy khi thất bại: Điều kiện if: failure() để tmate chỉ khởi động khi bước trước đó lỗi
• Không cần sudo: Tùy chọn sudo: false khi runner không có sudo

💡 Vì sao đáng chú ý

Debug GitHub Actions từ lâu là đau đầu vì log chỉ cho biết lỗi xảy ra chứ không cho thấy tại sao và trong môi trường nào. action-tmate giải quyết đúng điểm đó: bạn được vào thẳng runner, inspect biến môi trường, file cấu hình, dependency — tất cả trong ngữ cảnh thực.

Detached mode đặc biệt hữu ích vì bạn không phải chờ đợi tương tác thủ công mà vẫn nhận SSH command để chia sẻ cho đồng đội hoặc dùng trong job tiếp theo. Kết hợp với workflow_dispatch, team có thể tự bật debug khi cần mà không để lộ session trong mọi lần chạy CI.

#GitHub-Actions #SSH #Debugging #tmate #TiniX