system-config/doc/source/codesearch.rst
Spencer Krum e5f0f8122f Hound Maintenance
Change-Id: Ice50b20a0418a21b5e778c2433132a627ac73146
2016-01-07 11:55:45 -08:00

45 lines
1.3 KiB
ReStructuredText

:title: Code Search
.. _codesearch:
Code Search
###########
The `Hound <https://github.com/etsy/Hound>`_ code search engine is deployed in
our infrastructure to service all OpenStack repositories.
At a Glance
===========
:Hosts:
* http://codesearch.openstack.org
:Puppet:
* https://git.openstack.org/cgit/openstack-infra/puppet-hound/tree/
* :file:`modules/openstack_project/manifests/codesearch.pp`
:Projects:
* https://github.com/etsy/Hound
:Bugs:
* https://storyboard.openstack.org/#!/project/748
* https://github.com/etsy/Hound/issues
:Resources:
* `Hound README <https://github.com/etsy/hound/blob/master/README.md>`_
Overview
========
Hound is configured to read projects from a config.json file that is
automatically generated from the Gerrit projects.yaml, defined in the
$::project_config::jeepyb_project_file variable in Puppet.
Maintenance
===========
Hound uses 'git pull' to keep repos in sync. If a force push is ever used to
correct an issue in a repo, then hound will not be able to pull or index those
changes. The only way to detect this is to look in /var/log/hound.log. The
error message looks like hound attempting to update the repo and getting a
'remote host hung up' message. The issue can be corrected by an infra-root
removing the relevant hound data directory. Hound will re-clone with the new
history.