iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

start to rewrite mirrorring specs (using DNS approach)

This commit is contained in:
Tarek Ziadé 2009-03-29 21:37:27 +00:00
parent 64d3e73864
commit f2cb34d7a7
1 changed files with 17 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
pep-0381.txt
View File

@ -19,8 +19,8 @@ This PEP describes a mirroring infrastructure for PyPI.
Rationale
=========
PyPI is hosting over 4000 projects and is used on a daily basis by
people to build applications. Especially systems like `easy_install`
PyPI is hosting over 6000 projects and is used on a daily basis
by people to build applications. Especially systems like `easy_install`
and `zc.buildout` make intensive usage of PyPI.
For people making intensive use of PyPI, it can act as a single point
@ -41,48 +41,26 @@ In order to make the system more reliable, this PEP describes:
Mirror listing and registering
==============================
A new text page will be added at http://pypi.python.org/mirrors that
can be browsed like the simple index. This page gives a list of the
mirrors through a list of links.
People that wants to mirror PyPI make a proposal on catalog-SIG.
When a mirror is proposed on the mailing list, it is manually
added in a mirror list in the PyPI application after it
has been checked to be compliant with the mirroring rules.
These links are the URL of the simple index of each mirror. The page
will look like this::
A mirror has to be a hostname. For example:
# PyPI mirrors
#
# If you want to register a new mirror, send an email
# to the catalog-SIG@python.org with:
#
# - The urls of your mirror:
# - the root of the server
# - the index page
# - the last modified page
# - the local stats page
# - the global stats page
# - the mirrors page
#
# - The name and email of the maintainer.
#
# The registering is done manually and to become a
# mirror, you need to strictly follow the mirror protocol
# described here:
#
# http://wiki.python.org/PEP_374
#
# root,index,last-modified,local-stats,stats,mirrors
http://example.com/pypi,index,last-modified,local-stats,stats,mirrors
http://example2.com/pypi,index,last-modified,local-stats,stats,mirrors
- http://pypi.my-company.com
- http://mirror-pypi.somewhere.org
When a mirror is proposed on the mailing list, it is manually added in
the mirror list in the PyPI application after it has been checked to
be compliant with the mirroring rules.
The mirror list is handled by a DNS entry for this hostname:
The mirror list page is a simple text page that can be browsed by any
tool that wants to get a list of registered mirrors. Other package
indexes that are not mirrors of PyPI are not added in the mirror list
in PyPI, although they can provide themselve the same mirroring list
mechanism for their own mirrors.
mirrors.pypi.python.org
When a mirror is added into the DNS, it becomes an official
IP for `mirrors.pypi.python.org`.
The new mirror also appears at `http://pypi.python.org/mirrors`
which is a human-readable page that gives the list of mirrors.
This page also explains how to register a new mirror.
Special pages a mirror needs to provide
=======================================