autocat3 is a python-based application used for supporting Project Gutenberg.
CherryPy is used as the web framwork which is easy to develop.
It mainly implements the search functionality and rate limiter. Also return results pages based on templates.
The production version of autocat3 is on app1.
This application in this repository is on appdev1.
Previously, the old version of autocat3 relies on dependencies installed directly on the system. To make it more flexible and easy to deploy, we tend to use virtual env rather than the previous method. To use virtual env, we use pipenv instead of using pip and virtual env separately.
The virtual env directory is on the default directory while we run pipenv --three. So it's not in this directory. (We strictly use python3 for this project because CherryPy will discard the python2 in the future.)
To start the service/application, we use systemd to do that. the autocat3.service file is written under /etc/systemd/systemdirectory.
To start:
- make sure
sudo systemctl daemon-reloadevery time we edit the systemd unit file sudo systemctl start autocat3.serviceto start servicesudo systemctl stop autocat3.serviceto stop servicesudo systemctl status autocat3.serviceto check the running status of the service
Currently, we use the following steps to deploy autocat3 on a different server.
- Create Virtual env:
pipenv --threeto create a virtual env for current working directory(current project) - Install packages/python modules:
pipenv installto install all the packages in the Pipfile. If there is a requirements.txt file output frompip freeze, the command will automatically add the package names into Pipfile and install the packages and keep them in the Popfile for later use. - Lock the packages:
pipenv lockto be used to produce deterministic builds. - Check the virtual env path:
pipenv --venv - Start virtual env:
pipenv shell
Lots of Information on configuring Autocat3 is in configuring.txt
Copyright 2009-2010 by Marcello Perathoner Copyright 2019-present by Project Gutenberg