577c30508b
This patch updates the bandersnatch documentation to accurately reflect the current state of the mirrors. Change-Id: Ib4eddeb0bc6aa78c7484b8cb5cae3764da1926e0
59 lines
2.0 KiB
ReStructuredText
59 lines
2.0 KiB
ReStructuredText
:title: Bandersnatch
|
|
|
|
.. _bandersnatch:
|
|
|
|
Bandersnatch
|
|
############
|
|
|
|
A pypi mirror tool
|
|
|
|
At a Glance
|
|
===========
|
|
|
|
:Hosts:
|
|
* http://mirror.bhs1.ovh.openstack.org/pypi
|
|
* http://mirror.dfw.rax.openstack.org/pypi
|
|
* http://mirror.gra1.ovh.openstack.org/pypi
|
|
* http://mirror.iad.rax.openstack.orgv
|
|
* http://mirror.nyj01.internap.openstack.org/pypi
|
|
* http://mirror.ord.rax.openstack.org/pypi
|
|
* http://mirror.regionone.bluebox-sjc1.openstack.org/pypi
|
|
:Puppet:
|
|
* :file:`modules/openstack_project/manifests/static.pp`
|
|
:Projects:
|
|
* https://pypi.python.org/pypi/bandersnatch
|
|
* https://git.openstack.org/cgit/openstack-infra/puppet-bandersnatch
|
|
:Documentation:
|
|
* https://pypi.python.org/pypi/bandersnatch#configuration
|
|
:Bugs:
|
|
* https://storyboard.openstack.org/#!/project/748
|
|
* https://bitbucket.org/pypa/bandersnatch/issues?status=new&status=open
|
|
|
|
Overview
|
|
========
|
|
|
|
Bandersnatch is a tool we run on the static.openstack.org host to
|
|
build a complete mirror of pypi.python.org. Cron execs bandersnatch
|
|
on an interval with logs going to ``/var/log/bandersnatch``.
|
|
|
|
Stale Packages
|
|
==============
|
|
|
|
There is an issue with pypi.python.org syncing to its CDN occasionally
|
|
resulting in stale package artifacts. You will notice this in the
|
|
bandersnatch logs as::
|
|
|
|
2014-07-11 01:30:04,592 INFO: Syncing package: python-novaclient (serial 1154164)
|
|
2014-07-11 01:30:04,592 DEBUG: Getting /pypi/python-novaclient/json (serial 1154164)
|
|
2014-07-11 01:30:04,599 DEBUG: Expected PyPI serial 1154164 for request https://pypi.python.org/pypi/python-novaclient/json but got 1154163
|
|
2014-07-11 01:30:04,599 ERROR: Stale serial for package python-novaclient
|
|
2014-07-11 01:30:04,599 ERROR: Stale serial for python-novaclient (1154164) not updating. Giving up.
|
|
|
|
The fix for this is to issue a PURGE against the url specified above::
|
|
|
|
curl -X PURGE https://pypi.python.org/pypi/python-novaclient/json
|
|
|
|
The next run of bandersnatch will sync the package. Note this PURGE
|
|
step should be performed automatically by our bandersnatch wrapper
|
|
script, but can be performed by hand safely if necessary.
|