ResourcePool.Docs/docs/.gitea/workflows/README.md

Gitea Actions - Sync README Files

Workflow này tự động đồng bộ các file README.md từ repository này sang một repository công khai khác.

Cấu hình

1. Thiết lập Secrets trong Gitea

Vào Settings > Secrets của repository và thêm 2 secrets sau:

• TARGET_REPO_URL: URL của repository đích (ví dụ: https://gitea.example.com/username/public-repo.git)
• TOKEN_ACTION_PUBLIC_README: Token có quyền push vào repository đích

2. Tạo Token trong Gitea

1. Vào Settings > Applications > Generate New Token
2. Đặt tên token (ví dụ: "README Sync Token")
3. Chọn quyền: write:repository hoặc repo
4. Copy token và lưu vào secret TOKEN_ACTION_PUBLIC_README

3. Cách hoạt động

Workflow sẽ tự động chạy khi:

• Push events: Có push vào các branch main hoặc master (sau khi PR được merge)
• Pull Request events: Có PR mới, cập nhật, hoặc reopen vào main/master với thay đổi file .md
• Manual trigger: Chạy thủ công qua Actions > Sync README files > Run workflow

Lưu ý quan trọng:

• Khi chạy trên PR event: Workflow sẽ validate và chuẩn bị files nhưng KHÔNG push vào repo đích (chỉ để preview)
• Khi chạy trên Push event (sau khi merge): Workflow sẽ push files vào repo đích

4. Cấu trúc file được sync

• File readme.md hoặc README.md ở root → được copy thành README.md ở root của repo đích
• Các file README.md trong các thư mục con → được copy vào docs/ của repo đích, giữ nguyên cấu trúc thư mục

5. Kiểm tra kết quả

Sau khi workflow chạy:

• Vào tab Actions để xem log
• Kiểm tra repository đích để xác nhận các file đã được sync

Troubleshooting

Lỗi: "TARGET_REPO_URL secret is not set"

• Kiểm tra đã thêm secret TARGET_REPO_URL chưa
• Đảm bảo tên secret chính xác (case-sensitive)

Lỗi: "Failed to clone target repository"

• Kiểm tra URL repository đích có đúng không
• Kiểm tra token có quyền đọc repository không
• Đảm bảo repository đích là public hoặc token có quyền truy cập

Lỗi: "Push failed"

• Kiểm tra token có quyền push vào repository đích
• Kiểm tra branch mặc định của repository đích (main/master)

Tùy chỉnh

Nếu cần thay đổi:

• Branch trigger: Sửa phần branches trong workflow
• File pattern: Sửa phần paths trong workflow
• Target directory: Sửa phần copy files trong step "Find and copy README files"