act: Chạy GitHub Actions Tại Local

Tìm Hiểu Cách act Thực Thi Workflow Tại Local

act là công cụ dòng lệnh (CLI) đọc các file workflow trong thư mục .github/workflows/ của một repo và chạy các action đó ngay tại local thay vì trên máy chủ của GitHub. Nó xác định job nào cần chạy dựa trên các phụ thuộc giữa chúng, dùng Docker API để kéo hoặc build image mà từng job khai báo, rồi chạy mỗi job trong container riêng với biến môi trường và hệ thống tệp được cấu hình khớp với những gì GitHub cung cấp.

Các Tính Năng Cốt Lõi Của act

• ✓Đọc file workflow trực tiếp từ .github/workflows/ và xác định thứ tự chạy dựa trên các phụ thuộc giữa các job trước khi thực thi bất cứ thứ gì.
• ✓Dùng Docker API để kéo hoặc build image mà một workflow tham chiếu tới, thay vì bắt bạn chuẩn bị image thủ công.
• ✓Chạy mỗi action trong container riêng, với biến môi trường và hệ thống tệp được cấu hình khớp với những gì GitHub cung cấp.
• ✓Có thể thay thế Makefile: các workflow đã viết sẵn cho GitHub Actions trở thành đúng những lệnh bạn chạy tại local, nên logic không phải nằm ở hai nơi.
• ✓Có một tiện ích mở rộng VS Code đi kèm, GitHub Local Actions, do một người bảo trì khác xây dựng, để chạy và quản lý act mà không cần rời khỏi editor.
• ✓Là một dự án Go dưới giấy phép MIT mà bạn có thể tự build bằng Go 1.20 trở lên và make, nếu không muốn dùng bản release đóng gói sẵn.

Ứng Dụng Thực Tế Của act

• •Kiểm tra xem một thay đổi trong file workflow YAML có thực sự chạy đúng như mong đợi trước khi push và chờ hàng đợi của GitHub.
• •Thay Makefile của dự án bằng chính các job đã định nghĩa cho CI, để chỉ cần duy trì một script thay vì hai.
• •Debug một bước bị lỗi bằng cách chạy lại đúng phần đó của workflow tại local thay vì trigger lại toàn bộ pipeline trên GitHub.
• •Chạy act ngay trong VS Code qua tiện ích mở rộng GitHub Local Actions khi bạn không muốn chuyển sang terminal.

Bắt Đầu: Cài Đặt act

Cách cài đặt duy nhất mà facts ở đây có là build từ mã nguồn: cài Go 1.20 trở lên, clone repo bằng git clone [email protected]:nektos/act.git, chạy unit test bằng make test, rồi build và cài đặt bằng make install. README cũng dẫn tới một user guide riêng tại nektosact.com để có tài liệu đầy đủ hơn, nên bản binary đóng gói sẵn hay lệnh cài qua trình quản lý gói không được ghi rõ ở đây; mọi thứ ngoài đường dẫn make install nên coi là chưa nằm trong facts này.

Chạy GitHub Workflow Của Bạn Tại Local

Dùng act về cơ bản là chạy nó từ một repo có thư mục .github/workflows/. Nó đọc các file đó, xác định job nào cần chạy, rồi dùng Docker API để kéo hoặc build image mà mỗi job cần trước khi thực thi trong container. README đóng khung việc này quanh hai trường hợp cụ thể: phản hồi nhanh khi chỉnh sửa workflow mà không cần vòng lặp commit rồi push, và dùng chính các định nghĩa GitHub Actions đó làm công cụ chạy tác vụ tại local thay cho Makefile. Trên thực tế, điều đó có nghĩa là chạy act ngay sau khi sửa file workflow. Các flag và cú pháp lệnh cụ thể ngoài điểm khởi đầu đó không nằm trong facts ở đây; README dẫn người dùng tới user guide tại nektosact.com cho phần còn lại.

Các Cách Tiếp Cận Khác Để Kiểm Thử Workflow

Câu Hỏi Thường Gặp Về act

Vấn đề act giải quyết

Kiểm thử một workflow GitHub Actions theo cách thông thường nghĩa là sửa file .github/workflows/*.yml, commit, push, rồi chờ runner của GitHub nhận job, và lặp lại vòng đó cho mỗi lỗi gõ nhầm hay biến môi trường thiếu. README của act đóng khung lý do dự án tồn tại quanh đúng vòng lặp đó: chạy cùng những file workflow ấy trên Docker ngay tại máy của bạn và thấy kết quả ngay lập tức, hoặc dùng chính các file đó làm công cụ chạy tác vụ của dự án thay vì viết tay một Makefile lặp lại các lệnh tương tự.

Ai nên dùng — và ai nên bỏ qua

Hãy thử act nếu bạn đang chỉnh sửa file .github/workflows/ thường xuyên và ngán vòng lặp commit-push-rồi-chờ chỉ để xem một bước có chạy được không, hoặc nếu bạn muốn các job CI đó kiêm luôn vai trò công cụ chạy tác vụ tại local thay vì viết một Makefile riêng. Bỏ qua nếu đội của bạn hiếm khi động vào file workflow, hoặc nếu bạn cần độ khớp tuyệt đối với đặc thù runner do GitHub host vượt ngoài những gì được tài liệu hoá: facts ở đây chỉ nói về biến môi trường và hệ thống tệp được cấu hình khớp với GitHub, không phải một cam kết tái hiện mọi hành vi của runner được host.

Repo liên quan