Sphinx なドキュメントを Git から取り出して CI なナニ

debian

結構お手軽に環境構築できる模様。要件としては

  • Sphinx なソースを Git でバージョン管理
  • リポジトリを poll して更新されたら Jenkins で make
  • make 成功したら _build/html/* なソレを apache2 から見れる場所にコピィ

みたいなカンジ。

実装

ホストはうぶんつなので git、jenkins、python-sphinx あたりは apt-get でナニ。あと ssh な public-key を gitosis-admin などで管理してたりしますが詳細略。ざっくりな手順としては

  • gitosis@localhost なリポジトリに jenkins 君がアクセスできる権限を付けておく
  • jenkins でリポジトリを poll して、なトリガを設定
  • Build なナニとして以下を設定
make clean html
rsync -aru --delete ./_build/html/* /var/www/axis_install/.
  • 言い忘れてましたが apache2 も入れておきましょう

課題

  • Sphinx のプロジェクトをどの単位で設定するか
  • 今、apache2 なディレクトリを手で掘ってます