Project:Infrastructure/Project file hosting
This article details how Gentoo projects can host their (relatively small) project files on Gentoo infrastructure; hosted files generally include plain text copies of project meeting logs, various project notes, and other small files.
Web resources are made available via HTTP. This service replaces the functionality of the old CVS repository for the historical www.g.o main site.
Items that are not permitted include:
- Files referenced in ebuilds, including but not limited to distfiles, patches, or linked documentation.
- Project page-like HTML pages (should be on the wiki instead).
- Large files or resources that expect a lot of traffic (please consult with Infra for alternative hosting locations).
Per-project storage sizes should not exceed 100MiB, unless approved by the infra team.The distfiles/ directory is reserved for future use. Please do not touch it.
- Git repositories:
- Update frequency: every 30 minutes (:15, :45).
- No CGI scripts are executed.
- Directory listings are enabled.
Requesting the service for a project
Projects are assigned a directory name related to their project and an associated Git repository by Infra upon request via Bugzilla.
The request should include a list of developers with +w (or request the current project roster to be used).
Redirects from www.gentoo.org are also possible in reasonable amounts.
Proper distfile hosting will be made available at a future stage - bug #176186.
- Add a new entry in conf/sites.conf for the new repository in gitolite-admin.git
- In puppet.git, update:
- dist/project_hosting/files/var/www/projects.gentoo.org/htdocs/index.html (link to the new project)
- dist/project_hosting/manifests/repos.pp (update list of projects)
- dist/project_hosting/files/etc/nginx/vhosts.d/puppet/projects.gentoo.org/vhost.conf-include (add an alias)