Organizations and Teams Mapping for Fedora Forge
DRAFT DOCUMENTATION: This documentation is currently in draft form and may not be fully tested and correct. Please verify all procedures before use and report any issues or inaccuracies. |
Overview
This document explains the relationship between Organizations and Teams in Fedora Forge, and how they map to concepts from Pagure.io. Understanding this mapping is crucial for teams migrating from Pagure.io to Fedora Forge.
Organizations vs Teams
What’s the difference between an Organization and a Team?
Organizations are the top-level containers that group related repositories together - they represent the "namespace" or "group" concept from Pagure.io. Organizations themselves don’t have permissions - they’re just containers. Examples would be rust
, infrastructure
, or council
.
Teams are permission groups within an Organization that define who can do what. They control access to repositories within an Organization and have specific permission levels (Read, Write, Admin, Owner). Examples would be owners
, contributors
, or members
.
Think of it this way: Organization = The "SIG" or "team" or "subproject", and Team = The "roles" within that SIG/team/subproject.
You need both because Organizations provide the namespace structure (like Pagure.io namespaces) while Teams provide the permission management (like Pagure.io group permissions).
Migration Mapping Examples
Rust Organization Example
Based on a typical Rust organization migration, here’s how the mapping would work:
Current Pagure.io Setup
-
FAS Group:
rust-sig
-
Pagure Group:
fedora-rust
-
Pagure Namespace:
fedora-rust/*
-
Permissions:
fedora-rust
group has admin access to most projects
Recommended Forgejo Setup
-
Organization:
rust
-
Team 1:
owners
– maps to FAS groupforge-rust-owners
with Owner permissions -
Team 2:
members
– maps to FAS groupforge-rust-members
with Write permissions -
Repositories: All migrated
fedora-rust/*
projects underrust
organization
The |
Want to help? Learn how to contribute to Fedora Docs ›