Glance stable/mitaka docs cannot be built

[Ian Cordasco]

The Glance stable/mitaka docs job has been failing consistently for over a week now. An example of a failure is here: http://logs.openstack.org/periodic-stable/periodic-glance-docs-mitaka/384794b/

(Quoted below for posterity)

2017-01-30 06:10:21.562396 | Installing collected packages: six, pep8, pbr, pyflakes, mccabe, flake8, hacking, pytz, Babel, PyYAML, stevedore, smmap2, gitdb2, GitPython, bandit, coverage, extras, python-mimeparse, linecache2, traceback2, argparse, unittest2, testtools, fixtures, mox3, funcsigs, mock, Pygments, docutils, MarkupSafe, Jinja2, sphinx, requests, python-subunit, testrepository, testresources, testscenarios, psutil, requestsexceptions, wrapt, positional, iso8601, keystoneauth1, appdirs, os-client-config, debtcollector, oslotest, PyMySQL, psycopg2, pysendfile, qpid-python, pycparser, cffi, xattr, futures, python-swiftclient, oslosphinx, dulwich, reno
2017-01-30 06:10:21.562433 | Found existing installation: six 1.10.0
2017-01-30 06:10:21.562461 | Uninstalling six-1.10.0:
2017-01-30 06:10:21.562495 | Successfully uninstalled six-1.10.0
2017-01-30 06:10:21.562524 | Rolling back uninstall of six
2017-01-30 06:10:21.562542 | Exception:
2017-01-30 06:10:21.562573 | Traceback (most recent call last):
2017-01-30 06:10:21.562659 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/basecommand.py", line 215, in main
2017-01-30 06:10:21.562691 | status = self.run(options, args)
2017-01-30 06:10:21.562779 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/commands/install.py", line 342, in run
2017-01-30 06:10:21.562808 | prefix=options.prefix_path,
2017-01-30 06:10:21.562895 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/req/req_set.py", line 784, in install
2017-01-30 06:10:21.562915 | **kwargs
2017-01-30 06:10:21.563004 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/req/req_install.py", line 851, in install
2017-01-30 06:10:21.563052 | self.move_wheel_files(self.source_dir, root=root, prefix=prefix)
2017-01-30 06:10:21.563147 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/req/req_install.py", line 1064, in move_wheel_files
2017-01-30 06:10:21.563174 | isolated=self.isolated,
2017-01-30 06:10:21.563263 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/wheel.py", line 247, in move_wheel_files
2017-01-30 06:10:21.563286 | prefix=prefix,
2017-01-30 06:10:21.563377 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pip/locations.py", line 140, in distutils_scheme
2017-01-30 06:10:21.563407 | d = Distribution(dist_args)
2017-01-30 06:10:21.563494 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/setuptools/dist.py", line 320, in __init__
2017-01-30 06:10:21.563527 | _Distribution.__init__(self, attrs)
2017-01-30 06:10:21.563575 | File "/usr/lib/python2.7/distutils/dist.py", line 287, in __init__
2017-01-30 06:10:21.563628 | self.finalize_options()
2017-01-30 06:10:21.563722 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/setuptools/dist.py", line 386, in finalize_options
2017-01-30 06:10:21.563759 | ep.require(installer=self.fetch_build_egg)
2017-01-30 06:10:21.563850 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 2318, in require
2017-01-30 06:10:21.563914 | items = working_set.resolve(reqs, env, installer, extras=self.extras)
2017-01-30 06:10:21.563998 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 862, in resolve
2017-01-30 06:10:21.564036 | new_requirements = dist.requires(req.extras)[::-1]
2017-01-30 06:10:21.564121 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 2562, in requires
2017-01-30 06:10:21.564150 | dm = self._dep_map
2017-01-30 06:10:21.564235 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 2809, in _dep_map
2017-01-30 06:10:21.564270 | self.__dep_map = self._compute_dependencies()
2017-01-30 06:10:21.564362 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 2818, in _compute_dependencies
2017-01-30 06:10:21.564406 | for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
2017-01-30 06:10:21.564495 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 2800, in _parsed_pkg_info
2017-01-30 06:10:21.564529 | metadata = self.get_metadata(self.PKG_INFO)
2017-01-30 06:10:21.564617 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 1468, in get_metadata
2017-01-30 06:10:21.564653 | value = self._get(self._fn(self.egg_info, name))
2017-01-30 06:10:21.564736 | File "/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/local/lib/python2.7/site-packages/pkg_resources/__init__.py", line 1577, in _get
2017-01-30 06:10:21.564765 | with open(path, 'rb') as stream:
2017-01-30 06:10:21.564857 | IOError: [Errno 2] No such file or directory: '/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/lib/python2.7/site-packages/six-1.10.0.dist-info/METADATA'
2017-01-30 06:10:21.564869 |
2017-01-30 06:10:21.565068 | ERROR: could not install deps [-r/home/jenkins/workspace/periodic-glance-docs-mitaka/test-requirements.txt]; v = InvocationError('/home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/bin/pip install -U --force-reinstall -r/home/jenkins/workspace/periodic-glance-docs-mitaka/test-requirements.txt (see /home/jenkins/workspace/periodic-glance-docs-mitaka/.tox/venv/log/venv-1.log)', 2)

This seems to be due to the fact that pypa/setuptools no longer vendors its dependencies. It also seems related to the possibility that we're using an older version of pip. (See also: https://github.com/pypa/pip/issues/4253)

[Ian Cordasco (icordasc)]

I think this may have been fixed by https://review.openstack.org/410535