Após análise extensa e discussão no ticket de solicitação e em reuniões recentes do Conselho (veja o meetbot de 29 e 15 de julho de 2026), o Fedora Council deu início ao processo de política de mudança de política para ratificar a política de uso do Fedora Forge. O documento está aberto a feedback público por no mínimo duas semanas. Se não houver alterações significativas após quinta-feira, 13 de agosto de 2026, a política seguirá para votação formal em ticket para aprovação ou rejeição pelo Conselho. Caso haja mudanças significativas, o Conselho revisará a política e, se necessário, estenderá o período de feedback antes de convocar a votação oficial. Envie seus comentários no post de discussão.

A política também está disponível na página do Conselho no wiki e reproduzida abaixo.

Agradecemos a todos pelas contribuições até agora e, em nome do Conselho, esperamos trabalhar com vocês para ratificar esta política em breve.

1. Escopo, Critérios e Exceções

O Fedora Forge é um espaço de trabalho dedicado ao Projeto Fedora. Historicamente, o Fedora utilizava o pagure.io, que operava como uma forja pública de uso geral, onde repositórios do Fedora coexistiam com projetos pessoais, softwares upstream não relacionados e portfólios individuais.

O Fedora Forge (baseado em Forgejo) adota intencionalmente um escopo mais restrito. Não é um provedor de hospedagem Git público e de uso geral. É uma infraestrutura interna do projeto, explicitamente provisionada para hospedar o código, a documentação e as ferramentas que constroem, gerenciam e governam diretamente o Projeto Fedora.

Critérios para “Relacionado ao Projeto Fedora”

Para se qualificar para hospedagem no Fedora Forge, um repositório deve atender a pelo menos um dos seguintes critérios:

  • Infraestrutura e Operações: Gerenciamento de configuração, scripts de implantação ou ferramentas usadas pela equipe de Infraestrutura do Fedora para executar o projeto.
  • Engenharia de Release e Empacotamento: Ferramentas, scripts e modelos usados para construir, compor e distribuir releases, edições e spins do Fedora.
  • Governança e Organização de Equipes: Rastreadores, documentação e espaços colaborativos para equipes oficiais do Fedora, Grupos de Interesse Especial (SIGs), Grupos de Trabalho e iniciativas do Fedora Council.
  • Software Específico do Fedora: Projetos de software concebidos e desenvolvidos principalmente para servir a comunidade Fedora (ex.: Fedora Badges, Bodhi, fedmsg).

Exceções e Casos Especiais (Upstreams do Ecossistema)

Embora o desenvolvimento upstream geral deva ocorrer em forjas públicas (como GitHub, GitLab ou Codeberg), o Projeto Fedora reconhece que certos projetos upstream de grande escala estão tão profundamente entrelaçados com a infraestrutura e história do Fedora que se qualificam como exceções.

Exceções Reconhecidas:

  • Ferramentas de infraestrutura fundamentais amplamente mantidas por contribuidores do Fedora e do ecossistema Red Hat (ex.: Koji, FreeIPA).
  • Componentes centrais do sistema cuja equipe de desenvolvimento principal está historicamente enraizada na comunidade Fedora e depende da Infraestrutura do Fedora para seu fluxo de trabalho.

Nota: Estar empacotado no repositório Fedora não concede automaticamente status de exceção para usar o Fedora Forge como host upstream.

Processo de Decisão para Casos Limítrofes

Se um membro da comunidade não tiver certeza se seu projeto se encaixa no escopo ou se qualifica como exceção do ecossistema, o seguinte processo se aplica:

  1. Submissão de Solicitação: O solicitante deve abrir um ticket no rastreador de Infraestrutura do Fedora, detalhando o propósito do projeto, sua conexão com o Fedora e por que deve ser hospedado no Fedora Forge em vez de uma alternativa pública.
  2. Revisão da Infraestrutura: A equipe de Infraestrutura do Fedora realizará uma revisão inicial com base nos critérios estabelecidos para avaliar a viabilidade técnica e o impacto de recursos.
  3. Consulta ao Comitê Diretivo: Se a solicitação cair em uma área cinzenta, a equipe de Infraestrutura encaminhará o ticket ao Fedora Engineering Steering Committee (FESCo) ou ao Fedora Council para uma decisão política.
  4. Resolução Final: A decisão será documentada no ticket. Se negada, o solicitante será incentivado a hospedar o projeto em uma forja pública e espelhar componentes específicos se estritamente necessário para builds internos do Fedora.

2. Acesso e Autenticação

O acesso ao Fedora Forge é integrado com nossos sistemas de identidade central para garantir acesso seguro e responsável.

  • Criação de Conta e Login: Toda autenticação é feita via Fedora Account System (FAS). Não é possível criar uma conta local diretamente na instância Forgejo. Para fazer login, use a integração de Single Sign-On (SSO) com suas credenciais FAS ativas.
  • Namespaces Pessoais: No primeiro login, um namespace pessoal (ex.: forge.fedoraproject.org/seu-usuario-fas) é provisionado automaticamente. Você só pode fazer fork de repositórios neste espaço; a criação de novos repositórios é permitida apenas sob uma Organização.
  • Organizações e Equipes: Para evitar proliferação de organizações, a criação de Organizações de alto nível (ex.: /infra ou /quality) é restrita. Se sua equipe ou SIG do Fedora precisar de um espaço de Organização dedicado, abra um ticket com a equipe do Forge. Os proprietários da Organização são responsáveis por gerenciar o acesso da equipe dentro de seu espaço designado.
  • Desativação de Conta: Se sua conta FAS for suspensa, desabilitada ou marcada como inativa, seu acesso ao Fedora Forge será revogado automaticamente. Repositórios hospedados em seu namespace pessoal podem ser arquivados ou removidos se sua conta permanecer inativa por um período prolongado. Se você estiver deixando o projeto, transfira a propriedade de quaisquer ferramentas críticas para uma Organização do Fedora ou para um co-mantenedor ativo antes de sua partida.

3. Código de Conduta e Comportamento Comunitário

O Fedora Forge é um espaço colaborativo. Toda atividade nesta plataforma é estritamente regida pelo Código de Conduta do Fedora.

4. Atividades Proibidas

Para garantir que o Fedora Forge permaneça performático, seguro e em conformidade legal, as seguintes atividades e conteúdos são estritamente proibidos:

  • Projetos Não Relacionados ao Fedora: Conforme o escopo, esta Forja não é um host Git de propósito geral. Portfólios pessoais, dotfiles ou projetos de hobby não diretamente ligados ao Fedora são proibidos.
  • Conteúdo Malicioso: Hospedar malware, exploits, infraestrutura de comando e controle de botnets ou materiais de phishing. (Nota: Ferramentas relacionadas à segurança estritamente usadas para testes de infraestrutura do Fedora devem ser explicitamente aprovadas.)
  • Material Proprietário e Protegido por Direitos Autorais: Enviar materiais protegidos por direitos autorais que você não tem o direito de distribuir, ou hospedar blobs binários proprietários e de código fechado. Todo código deve ser open source e estar em conformidade com as diretrizes de licenciamento do Fedora.
  • Exposição de Segredos: Commitar informações sensíveis como senhas, tokens de API, chaves SSH privadas ou Informações Pessoais Identificáveis (PII).
  • Abuso do Sistema: Envolver-se em atividades que degradem o desempenho da instância Forgejo ou de seus runners, como scraping agressivo de rede, ataques DDoS ou acionamento intencional de loops infinitos de CI.
  • Mineração de Criptomoedas: Usar a Forja ou seus runners de CI/CD para minerar criptomoedas é estritamente proibido e resultará em banimento imediato e permanente.

5. Limites de Recursos e CI/CD

Queremos capacitar as equipes do Fedora com as ferramentas necessárias, mas também devemos gerenciar nossos custos de infraestrutura e armazenamento de forma eficaz.

  • Tamanho do Repositório: Git não é um sistema de backup. Mantenha os repositórios focados em código-fonte e documentação baseada em texto.
    • Repositórios idealmente devem permanecer abaixo de 500MB.
    • Se seu projeto exigir grandes ativos (ex.: arquivos de design, conjuntos de dados de teste), você deve usar Git LFS (Large File Storage).
  • Forgejo Actions e Runners de CI:
    • Infraestrutura Compartilhada: Os runners de CI padrão fornecidos pela Infraestrutura do Fedora são um recurso comunitário compartilhado. Os jobs devem ser otimizados para executar eficientemente e estão sujeitos a um tempo limite máximo de 10 minutos por job.
    • Runners de Propriedade da Comunidade (BYOR): Incentivamos fortemente equipes maiores, SIGs e Grupos de Trabalho com testes extensivos ou requisitos arquiteturais específicos (ex.: uso intensivo de ARM, RISC-V ou longos tempos de build) a provisionar e registrar seus próprios runners. Runners dedicados podem ser anexados diretamente à sua Organização ou a repositórios específicos.
    • Conformidade para Runners Personalizados: Mesmo que sua equipe forneça os recursos computacionais, qualquer runner conectado ao Fedora Forge é uma extensão de nossa infraestrutura. Todos os fluxos de trabalho e ações executados em runners de propriedade da comunidade devem cumprir estritamente a Seção 4 (Atividades Proibidas). Você não pode usar runners personalizados para contornar a política (ex.: sem mineração de criptomoedas, sem construção de projetos upstream não relacionados ao Fedora e sem scraping malicioso de rede).
    • Processo de Registro: Para registrar um runner dedicado para sua equipe, consulte nossos Documentos de Registro de Runner e garanta que seu runner esteja seguro de acordo com os padrões da Infraestrutura do Fedora.
  • Uso da API: Scripts automatizados e bots que interagem com a API do Forgejo devem respeitar os limites de taxa e incluir strings de user-agent descritivas identificando a ferramenta e seu mantenedor.

6. Ciclo de Vida do Repositório e Organização

  • Convenções de Nomenclatura: Temos uma convenção geral de nomenclatura; deve haver um repositório tickets em sua Organização para ter um ponto único de abertura de tickets relevantes para seu grupo. O repositório docs em sua organização deve apontar para as fontes oficiais do seu grupo para o namespace docs.fedoraproject.org. Em outros casos, use nomes claros e descritivos para repositórios para que outros membros da comunidade possam entender facilmente seu propósito.
  • Arquivamento: Projetos que não são mais mantidos ativamente devem ser arquivados (marcados como somente leitura) para sinalizar seu status à comunidade. Proprietários ativos de Organizações da Forja devem arquivar repositórios conforme necessário. Se necessário (ex.: no caso de uma organização inativa), a equipe de Infraestrutura reserva-se o direito de arquivar repositórios que não tenham atividade após tentar contatar os proprietários da organização.
  • Exclusão: Se você precisar que uma Organização ou repositório seja completamente excluído, abra um ticket com a equipe do Forge. A equipe de Infraestrutura também reserva-se o direito de excluir repositórios abandonados, não conformes ou vazios para manter um espaço de trabalho limpo.

7. Suporte e Denúncia de Abusos

  • Obtendo Ajuda: Para problemas técnicos com o Fedora Forge (ex.: falhas de runner de CI, problemas de login, solicitação de uma Organização), abra um ticket no rastreador da equipe do Forge ou pergunte no canal Matrix #fedora-admin (https://matrix.to/).
  • Denunciando Violações do Código de Conduta: Para denunciar uma violação do CoC ocorrendo na Forja, entre em contato com o Comitê do Código de Conduta do Fedora.
  • Denunciando Problemas de Segurança/Legais: Para denunciar uma vulnerabilidade de segurança na plataforma, segredos expostos ou uma violação de DMCA/direitos autorais, envie imediatamente um e-mail para a equipe de Infraestrutura do Fedora.