Sau khi xem xét kỹ lưỡng yêu cầu trên ticket và trong các cuộc họp Hội đồng gần đây (xem meetbot ngày 29 và 15 tháng 7 năm 2026), Hội đồng Fedora (Fedora Council) muốn khởi xướng quy trình thay đổi chính sách để phê chuẩn Chính sách sử dụng Fedora Forge. Tài liệu này được mở để lấy ý kiến công khai (nếu có) trong tối thiểu hai tuần. Nếu không có thay đổi đáng kể nào dựa trên phản hồi của cộng đồng sau thứ Năm, ngày 13 tháng 8 năm 2026, chính sách này sẽ được đưa ra bỏ phiếu chính thức để Hội đồng phê duyệt hoặc từ chối.

Nếu có những thay đổi đáng kể, Hội đồng sẽ xem xét lại và nếu cần, gia hạn thời gian phản hồi trước khi kêu gọi bỏ phiếu chính thức. Vui lòng gửi phản hồi trên bài thảo luận.

Chính sách có thể được tìm thấy trên trang wiki của Hội đồng trong Fedora Forge, đăng trên Discourse và được dán bên dưới để tiện theo dõi.

Cảm ơn mọi người vì những đóng góp cho chính sách này cho đến nay, và thay mặt Hội đồng, chúng tôi mong muốn được làm việc cùng tất cả các bạn để sớm phê chuẩn chính sách này.

1. Phạm vi, Tiêu chí và Ngoại lệ

Fedora Forge là không gian làm việc dành riêng cho Dự án Fedora. Trước đây, Dự án Fedora sử dụng pagure.io, hoạt động như một forge công cộng đa năng nơi các kho lưu trữ Fedora cùng tồn tại với các dự án cá nhân, phần mềm thượng nguồn không liên quan và hồ sơ cá nhân.

Fedora Forge (chạy Forgejo) cố tình áp dụng phạm vi hẹp hơn. Nó không phải là nhà cung cấp dịch vụ lưu trữ Git công cộng đa năng. Nó là một phần cơ sở hạ tầng nội bộ của dự án, được cung cấp rõ ràng để lưu trữ mã nguồn, tài liệu và công cụ trực tiếp xây dựng, quản lý và điều hành Dự án Fedora.

Tiêu chí cho “Liên quan đến Dự án Fedora”

Để đủ điều kiện lưu trữ trên Fedora Forge, một kho lưu trữ phải đáp ứng ít nhất một trong các tiêu chí sau:

  • Cơ sở hạ tầng và Vận hành: Quản lý cấu hình, tập lệnh triển khai hoặc công cụ được Nhóm Cơ sở hạ tầng Fedora sử dụng để vận hành dự án.
  • Kỹ thuật Phát hành và Đóng gói: Công cụ, tập lệnh và mẫu được sử dụng để xây dựng, tổng hợp và phân phối các bản phát hành, phiên bản và spin của Fedora.
  • Quản trị và Tổ chức Nhóm: Trình theo dõi, tài liệu và không gian cộng tác cho các Nhóm Fedora chính thức, Nhóm Quan tâm Đặc biệt (SIG), Nhóm Công tác và các sáng kiến của Hội đồng Fedora.
  • Phần mềm dành riêng cho Fedora: Các dự án phần mềm được hình thành và phát triển chủ yếu để phục vụ cộng đồng Fedora (ví dụ: Fedora Badges, Bodhi, fedmsg).

Ngoại lệ và Trường hợp Đặc biệt (Hệ sinh thái Thượng nguồn)

Mặc dù việc phát triển thượng nguồn nói chung nên diễn ra trên các forge công cộng (như GitHub, GitLab hoặc Codeberg), Dự án Fedora công nhận rằng một số dự án thượng nguồn quy mô lớn có mối liên kết sâu sắc với cơ sở hạ tầng và lịch sử của Fedora đến mức chúng đủ điều kiện là ngoại lệ.

Các ngoại lệ được công nhận:

  • Các công cụ cơ sở hạ tầng nền tảng được duy trì nhiều bởi Fedora và các cộng tác viên hệ sinh thái Red Hat (ví dụ: Koji, FreeIPA).
  • Các thành phần hệ thống cốt lõi mà nhóm phát triển chính có nguồn gốc lịch sử từ cộng đồng Fedora và dựa vào Cơ sở hạ tầng Fedora cho quy trình làm việc của họ.

Lưu ý: Việc được đóng gói trong kho Fedora không tự động cấp quyền ngoại lệ cho một dự án để sử dụng Fedora Forge làm máy chủ thượng nguồn.

Quy trình Quyết định cho các Trường hợp Đặc biệt

Nếu một thành viên cộng đồng không chắc liệu dự án của họ có phù hợp với phạm vi hay đủ điều kiện là ngoại lệ hệ sinh thái hay không, quy trình sau sẽ được áp dụng:

  1. Gửi Yêu cầu: Người yêu cầu phải mở một ticket trên trình theo dõi Cơ sở hạ tầng Fedora, nêu chi tiết mục đích của dự án, mối liên hệ của nó với Fedora và lý do tại sao nó nên được lưu trữ trên Fedora Forge thay vì một giải pháp thay thế công cộng.
  2. Đánh giá Cơ sở hạ tầng: Nhóm Cơ sở hạ tầng Fedora sẽ tiến hành đánh giá ban đầu dựa trên các tiêu chí đã thiết lập để đánh giá tính khả thi về mặt kỹ thuật và tác động đến tài nguyên.
  3. Tham vấn Ủy ban Điều hành: Nếu yêu cầu rơi vào vùng xám, Nhóm Cơ sở hạ tầng sẽ chuyển ticket lên Ủy ban Điều hành Kỹ thuật Fedora (FESCo) hoặc Hội đồng Fedora để có phán quyết chính sách.
  4. Giải quyết Cuối cùng: Quyết định sẽ được ghi lại trong ticket. Nếu bị từ chối, người yêu cầu sẽ được khuyến khích lưu trữ dự án trên một forge công cộng và nhân bản các thành phần cụ thể nếu thực sự cần thiết cho các bản dựng nội bộ của Fedora.

2. Truy cập và Xác thực

Quyền truy cập vào Fedora Forge được tích hợp với các hệ thống nhận dạng trung tâm của chúng tôi để đảm bảo truy cập an toàn và có trách nhiệm.

  • Tạo Tài khoản và Đăng nhập: Tất cả xác thực được xử lý thông qua Hệ thống Tài khoản Fedora (FAS). Bạn không thể tạo tài khoản cục bộ trực tiếp trên phiên bản Forgejo. Để đăng nhập, hãy sử dụng tích hợp Đăng nhập Một lần (SSO) với thông tin FAS đang hoạt động của bạn.
  • Không gian Tên Cá nhân: Khi đăng nhập lần đầu, một không gian tên cá nhân (ví dụ: forge.fedoraproject.org/your-fas-username) sẽ được tự động cấp cho bạn. Bạn chỉ có thể fork kho lưu trữ vào không gian này; việc tạo kho lưu trữ mới chỉ được phép trong Tổ chức.
  • Tổ chức và Nhóm: Để ngăn chặn sự bành trướng tổ chức, việc tạo các Tổ chức cấp cao nhất (ví dụ: /infra hoặc /quality) bị hạn chế. Nếu nhóm hoặc SIG Fedora của bạn cần một không gian Tổ chức chuyên dụng, vui lòng mở ticket với Nhóm Forge. Chủ sở hữu Tổ chức chịu trách nhiệm quản lý quyền truy cập của nhóm trong không gian được chỉ định của họ.
  • Vô hiệu hóa Tài khoản: Nếu tài khoản FAS của bạn bị đình chỉ, vô hiệu hóa hoặc bị đánh dấu là không hoạt động, quyền truy cập của bạn vào Fedora Forge sẽ tự động bị thu hồi. Các kho lưu trữ được lưu trữ trong không gian tên cá nhân của bạn có thể bị lưu trữ hoặc xóa nếu tài khoản của bạn vẫn không hoạt động trong một thời gian dài. Nếu bạn rời khỏi dự án, vui lòng chuyển quyền sở hữu bất kỳ công cụ quan trọng nào cho một Tổ chức Fedora hoặc một người đồng duy trì đang hoạt động trước khi bạn ra đi.

3. Quy tắc Ứng xử và Hành vi Cộng đồng

Fedora Forge là một không gian cộng tác. Mọi hoạt động trên nền tảng này đều được điều chỉnh nghiêm ngặt bởi Quy tắc Ứng xử Fedora.

4. Các Hoạt động Bị Cấm

Để đảm bảo Fedora Forge luôn hoạt động hiệu quả, an toàn và tuân thủ pháp luật, các hoạt động và nội dung sau đây bị nghiêm cấm:

  • Dự án Không phải Fedora: Như đã nêu trong phạm vi, Forge này không phải là máy chủ Git đa năng. Hồ sơ cá nhân, dotfiles hoặc các dự án sở thích không liên quan trực tiếp đến Fedora đều bị cấm.
  • Nội dung Độc hại: Lưu trữ phần mềm độc hại, khai thác lỗ hổng, cơ sở hạ tầng điều khiển botnet hoặc tài liệu lừa đảo. (Lưu ý: Các công cụ liên quan đến bảo mật chỉ được sử dụng để kiểm tra cơ sở hạ tầng Fedora phải được phê duyệt rõ ràng).
  • Tài liệu Độc quyền và Có Bản quyền: Tải lên tài liệu có bản quyền mà bạn không có quyền phân phối hoặc lưu trữ các khối nhị phân độc quyền, mã nguồn đóng. Tất cả mã nguồn phải là mã nguồn mở và tuân thủ hướng dẫn cấp phép của Fedora.
  • Tiết lộ Bí mật: Cam kết thông tin nhạy cảm như mật khẩu, mã thông báo API, khóa SSH riêng tư hoặc Thông tin Nhận dạng Cá nhân (PII).
  • Lạm dụng Hệ thống: Tham gia vào các hoạt động làm giảm hiệu suất của phiên bản Forgejo hoặc các runner của nó, chẳng hạn như quét mạng tích cực, tấn công DDoS hoặc cố tình kích hoạt các vòng lặp CI vô hạn.
  • Khai thác Tiền điện tử: Sử dụng Forge hoặc runner CI/CD của nó để khai thác tiền điện tử bị nghiêm cấm và sẽ dẫn đến lệnh cấm vĩnh viễn ngay lập tức.

5. Giới hạn Tài nguyên và CI/CD

Chúng tôi muốn trao quyền cho các nhóm Fedora với các công cụ họ cần, nhưng chúng tôi cũng phải quản lý chi phí cơ sở hạ tầng và dung lượng lưu trữ một cách hiệu quả.

  • Kích thước Kho lưu trữ: Git không phải là hệ thống sao lưu. Vui lòng giữ các kho lưu trữ tập trung vào mã nguồn và tài liệu dạng văn bản.
    • Các kho lưu trữ lý tưởng nhất nên dưới 500MB.
    • Nếu dự án của bạn yêu cầu tài sản lớn (ví dụ: tệp thiết kế, bộ dữ liệu thử nghiệm), bạn phải sử dụng Git LFS (Lưu trữ Tệp Lớn).
  • Forgejo Actions và CI Runners:
    • Cơ sở hạ tầng Dùng chung: Các runner CI mặc định do Cơ sở hạ tầng Fedora cung cấp là tài nguyên cộng đồng dùng chung. Các công việc nên được tối ưu hóa để chạy hiệu quả và có thời gian chờ tối đa 10 phút mỗi công việc.
    • Runner do Cộng đồng Sở hữu (Tự mang): Chúng tôi khuyến khích các nhóm, SIG và Nhóm Công tác lớn hơn có yêu cầu kiểm thử mở rộng hoặc yêu cầu kiến trúc cụ thể (ví dụ: sử dụng nhiều ARM, RISCV hoặc yêu cầu thời gian xây dựng dài) tự cung cấp và đăng ký runner riêng của họ. Các runner chuyên dụng có thể được gắn trực tiếp vào Tổ chức hoặc kho lưu trữ cụ thể của bạn.
    • Tuân thủ cho Runner Tùy chỉnh: Ngay cả khi nhóm của bạn cung cấp tài nguyên tính toán, bất kỳ runner nào kết nối với Fedora Forge đều là phần mở rộng của cơ sở hạ tầng của chúng tôi. Tất cả các quy trình làm việc và hành động được thực thi trên runner do cộng đồng sở hữu phải tuân thủ nghiêm ngặt Mục 4 (Các Hoạt động Bị Cấm). Bạn không được sử dụng runner tùy chỉnh để vượt qua chính sách (ví dụ: không khai thác tiền điện tử, không xây dựng các dự án thượng nguồn không liên quan đến Fedora và không quét mạng độc hại).
    • Quy trình Đăng ký: Để đăng ký một runner chuyên dụng cho nhóm của bạn, vui lòng xem Tài liệu Đăng ký Runner của chúng tôi và đảm bảo runner của bạn được bảo mật theo tiêu chuẩn Cơ sở hạ tầng Fedora.
  • Sử dụng API: Các tập lệnh tự động và bot tương tác với API Forgejo phải tôn trọng giới hạn tốc độ và bao gồm các chuỗi user-agent mô tả xác định công cụ và người duy trì nó.

6. Vòng đời Kho lưu trữ và Tổ chức

  • Quy ước Đặt tên: Chúng tôi có quy ước đặt tên chung, nên có kho lưu trữ tickets trong Tổ chức của bạn để có một điểm duy nhất mở ticket liên quan đến nhóm của bạn. Kho lưu trữ docs trong tổ chức của bạn nên trỏ đến các nguồn chính thức của nhóm bạn cho không gian tên docs.fedoraproject.org. Trong các trường hợp khác, vui lòng sử dụng tên rõ ràng, mô tả cho các kho lưu trữ để các thành viên cộng đồng khác có thể dễ dàng hiểu mục đích của chúng.
  • Lưu trữ: Các dự án không còn được duy trì tích cực nên được lưu trữ (đánh dấu là chỉ đọc) để báo hiệu trạng thái của chúng cho cộng đồng. Chủ sở hữu Tổ chức Forge đang hoạt động nên lưu trữ các kho lưu trữ khi cần thiết. Nếu cần (ví dụ: trong trường hợp tổ chức không hoạt động), Nhóm Cơ sở hạ tầng có quyền lưu trữ các kho lưu trữ không có hoạt động sau khi cố gắng liên hệ với chủ sở hữu tổ chức.
  • Xóa: Nếu bạn cần xóa hoàn toàn một Tổ chức hoặc kho lưu trữ, vui lòng mở ticket với Nhóm Forge. Nhóm Cơ sở hạ tầng cũng có quyền xóa các kho lưu trữ bị bỏ rơi, không tuân thủ hoặc trống để duy trì không gian làm việc sạch sẽ.

7. Hỗ trợ và Báo cáo Lạm dụng

  • Nhận Trợ giúp: Đối với các vấn đề kỹ thuật với Fedora Forge (ví dụ: lỗi runner CI, sự cố đăng nhập, yêu cầu Tổ chức), vui lòng mở ticket trên trình theo dõi Nhóm Forge hoặc hỏi trong kênh Matrix #fedora-admin.
  • Báo cáo Vi phạm Quy tắc Ứng xử: Để báo cáo vi phạm Quy tắc Ứng xử xảy ra trên Forge, vui lòng liên hệ Ủy ban Quy tắc Ứng xử Fedora.
  • Báo cáo Vấn đề Bảo mật/Pháp lý: Để báo cáo lỗ hổng bảo mật trên nền tảng, bí mật bị lộ hoặc vi phạm DMCA/bản quyền, vui lòng gửi email ngay lập tức cho Nhóm Cơ sở hạ tầng Fedora.