zuul openstack-tox-docs failure: html_static_path entry '_static' does not exist

[Ryan Liang]

Zuul openstack-tox-docs check failed for all recent Cinder build.

Error logs:
using tox.ini: /home/zuul/src/opendev.org/openstack/cinder/tox.ini (pid 3767)
  removing /home/zuul/src/opendev.org/openstack/cinder/.tox/log
using tox-3.13.2 from /usr/local/lib/python2.7/dist-packages/tox/__init__.pyc (pid 3767)
skipping sdist step
docs start: getenv /home/zuul/src/opendev.org/openstack/cinder/.tox/docs
python3 (/usr/bin/python3) is {u'executable': u'/usr/bin/python3', u'name': u'python', u'version_info': [3, 6, 8, u'final', 0], u'sysplatform': u'linux', u'version': u'3.6.8 (default, Jan 14 2019, 11:02:34) \n[GCC 8.0.1 20180414 (experimental) [trunk revision 259383]]', u'is_64': True}
docs uses /usr/bin/python3
docs reusing: /home/zuul/src/opendev.org/openstack/cinder/.tox/docs
docs finish: getenv /home/zuul/src/opendev.org/openstack/cinder/.tox/docs after 0.15 seconds
docs start: developpkg /home/zuul/src/opendev.org/openstack/cinder
[3797] /home/zuul/src/opendev.org/openstack/cinder$ /home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin/python setup.py --name
/home/zuul/src/opendev.org/openstack/cinder/.tox/docs/lib/python3.6/site-packages/setuptools/depends.py:2: DeprecationWarning: the imp module is deprecated in favour of importlib; see the module's documentation for alternative uses
  import imp
[3806] /home/zuul/src/opendev.org/openstack/cinder$ /home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin/python -c 'import sys; import json; print(json.dumps(sys.path))'
docs develop-inst-noop: /home/zuul/src/opendev.org/openstack/cinder
docs finish: developpkg /home/zuul/src/opendev.org/openstack/cinder after 1.50 seconds
docs start: envreport
setting PATH=/home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games
[3807] /home/zuul/src/opendev.org/openstack/cinder$ /home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin/python -m pip freeze >.tox/docs/log/docs-4.log
docs finish: envreport after 0.86 seconds
docs installed: alabaster==0.7.12,alembic==1.0.11,amqp==2.5.1,asn1crypto==0.24.0,attrs==19.1.0,automaton==1.16.0,Babel==2.7.0,bcrypt==3.1.7,cachetools==3.1.1,castellan==1.3.0,certifi==2019.6.16,cffi==1.12.3,chardet==3.0.4,# Editable Git install with no remote (cinder==14.1.0.dev417),-e /home/zuul/src/opendev.org/openstack/cinder,cliff==2.15.0,cmd2==0.9.16,colorama==0.4.1,cryptography==2.7,cursive==0.2.2,debtcollector==1.21.0,decorator==4.4.0,defusedxml==0.6.0,dnspython==1.16.0,docutils==0.15.2,dogpile.cache==0.7.1,dulwich==0.19.13,eventlet==0.25.1,extras==1.0.0,fasteners==0.15,fixtures==3.0.0,futurist==1.8.1,google-api-python-client==1.7.11,google-auth==1.6.3,google-auth-httplib2==0.0.3,greenlet==0.4.15,httplib2==0.13.1,idna==2.8,imagesize==1.1.0,importlib-metadata==0.19,iso8601==0.1.12,Jinja2==2.10.1,jsonpatch==1.24,jsonpointer==2.0,jsonschema==3.0.2,keystoneauth1==3.17.0,keystonemiddleware==7.0.0,kombu==4.6.4,linecache2==1.0.0,lxml==4.4.1,Mako==1.1.0,MarkupSafe==1.1.1,mock==3.0.5,monotonic==1.5,msgpack==0.6.1,netaddr==0.7.19,netifaces==0.10.9,networkx==2.3,oauth2client==4.1.3,openstackdocstheme==1.31.1,os-api-ref==1.6.2,os-brick==2.9.1,os-service-types==1.7.0,os-win==4.3.0,oslo.cache==1.37.0,oslo.concurrency==3.29.1,oslo.config==6.11.0,oslo.context==2.22.1,oslo.db==5.0.1,oslo.i18n==3.23.1,oslo.log==3.44.0,oslo.messaging==10.1.0,oslo.middleware==3.38.1,oslo.policy==2.3.0,oslo.privsep==1.33.1,oslo.reports==1.29.2,oslo.rootwrap==5.16.0,oslo.serialization==2.29.1,oslo.service==1.40.0,oslo.upgradecheck==0.3.1,oslo.utils==3.41.0,oslo.versionedobjects==1.36.0,oslo.vmware==2.34.0,osprofiler==2.8.1,packaging==19.1,paramiko==2.6.0,Paste==3.1.0,PasteDeploy==2.0.1,pbr==5.4.2,prettytable==0.7.2,psutil==5.6.3,pyasn1==0.4.6,pyasn1-modules==0.2.6,pycadf==2.9.0,pycparser==2.19,pydot==1.4.1,Pygments==2.4.2,pyinotify==0.9.6,PyNaCl==1.3.0,pyOpenSSL==19.0.0,pyparsing==2.4.2,pyperclip==1.7.0,pyrsistent==0.15.4,python-barbicanclient==4.8.1,python-dateutil==2.8.0,python-editor==1.0.4,python-glanceclient==2.16.0,python-keystoneclient==3.20.0,python-mimeparse==1.6.0,python-novaclient==14.2.0,python-swiftclient==3.8.0,pytz==2019.2,pyudev==0.21.0,PyYAML==5.1.2,reno==2.11.3,repoze.lru==0.7,requests==2.22.0,retrying==1.3.3,rfc3986==1.3.2,Routes==2.4.1,rsa==4.0,rtslib-fb==2.1.69,simplejson==3.16.0,six==1.12.0,snowballstemmer==1.9.0,Sphinx==2.2.0,sphinx-feature-classification==0.4.0,sphinxcontrib-apidoc==0.3.0,sphinxcontrib-applehelp==1.0.1,sphinxcontrib-devhelp==1.0.1,sphinxcontrib-htmlhelp==1.0.2,sphinxcontrib-jsmath==1.0.1,sphinxcontrib-qthelp==1.0.2,sphinxcontrib-serializinghtml==1.1.3,SQLAlchemy==1.3.7,sqlalchemy-migrate==0.12.0,sqlparse==0.3.0,statsd==3.3.0,stevedore==1.30.1,suds-jurko==0.6,taskflow==3.7.0,Tempita==0.5.2,tenacity==5.1.1,testresources==2.0.1,testscenarios==0.5.0,testtools==2.3.0,tooz==1.66.1,traceback2==1.4.0,unittest2==1.1.0,uritemplate==3.0.0,urllib3==1.25.3,vine==1.3.0,voluptuous==0.11.7,warlock==1.3.3,wcwidth==0.1.7,WebOb==1.8.5,wrapt==1.11.2,yappi==1.0,zipp==0.5.2
docs start: run-test-pre
docs run-test-pre: PYTHONHASHSEED='2183600127'
docs finish: run-test-pre after 0.00 seconds
docs start: run-test
docs run-test: commands[0] | rm -fr doc/build doc/source/contributor/api/ .autogenerated
setting PATH=/home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games
[3810] /home/zuul/src/opendev.org/openstack/cinder$ /bin/rm -fr doc/build doc/source/contributor/api/ .autogenerated
docs run-test: commands[1] | sphinx-build -W -b html -d doc/build/doctrees doc/source doc/build/html
setting PATH=/home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games
[3811] /home/zuul/src/opendev.org/openstack/cinder$ /home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin/sphinx-build -W -b html -d doc/build/doctrees doc/source doc/build/html
Running Sphinx v2.2.0
connecting events for openstackdocstheme
[openstackdocstheme] connecting html-page-context event handler
loading stevedore.sphinxext
** Generating driver list...

making output directory... done
/home/zuul/src/opendev.org/openstack/cinder/.tox/docs/lib/python3.6/site-packages/setuptools/depends.py:2: DeprecationWarning: the imp module is deprecated in favour of importlib; see the module's documentation for alternative uses
  import imp

Warning, treated as error:
html_static_path entry '_static' does not exist
ERROR: InvocationError for command /home/zuul/src/opendev.org/openstack/cinder/.tox/docs/bin/sphinx-build -W -b html -d doc/build/doctrees doc/source doc/build/html (exited with code 2)
docs finish: run-test after 6.12 seconds
docs start: run-test-post
docs finish: run-test-post after 0.00 seconds
___________________________________ summary ____________________________________
ERROR: docs: commands failed

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/678130
Committed: https://git.openstack.org/cgit/openstack/cinder/commit/?id=9e2f46a87de7b076714d46a3a71f37db0e17b6c1
Submitter: Zuul
Branch: master

commit 9e2f46a87de7b076714d46a3a71f37db0e17b6c1
Author: Ryan Liang <email address hidden>
Date: Fri Aug 23 11:01:53 2019 +0800

    Fix tox docs failure

    doc/source/_static directory is required by oslo.policy sample generator.
    _static directory is empty in the cinder repo but it must exist.
    https://review.opendev.org/#/c/571106/ dropped doc/source/_static/.placeholder
    accidentally. This commit recovers the place holder file to ensure
    doc/source/_static directory exists.

    Closes-bug: #1841131
    Co-Authored-By: Akihiro Motoki <email address hidden>
    Change-Id: Ifad4371afa096afc2d0d71f6f077a53a9e52b60a

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/cinder 15.0.0.0rc1 release candidate.