This is a combination Bower registry/caching proxy. It can do two things:
- act as a registry (a name to URL mapper) for remote packages.
- act as a caching proxy for remote Bower packages.
The admin interface is available for both functionalities.
We strongly suggest installing into a virtualenv, and updating pip and setuptools inside the virtualenv first.
virtualenv .
. bin/activate
pip install -U pip setuptools
pip install bower-cache
After Bower Cache has been installed, use the bower-cache-init command to initialize a Bower Cache site. The site contains configuration and is where the packages are actually cached.
bower-cache-init /var/lib/bower-cache
The site contains a standard Django manage.py file. In order to log into the admin site, the admin user (which has been created as part of site initialization) needs a password. Set it by running
python manage.py changepassword admin
Bower Cache requires several services to run for it to be fully functional. The commands listed expect to be run from the site directory (the directory containing manage.py).
Run Gunicorn to serve the REST interface and admin site on port 8000:
gunicorn bowercachesite.wsgi
Run a single-process Celery worker, including the scheduler (-B):
python manage.py celery worker -c 1 -B
Run a git daemon to serve the cached packages:
git daemon --export-all --base-path=<site>/cache
If you're using the dev server, the admin will be available at http://127.0.0.1:8000/admin by default. Open the URL and log in as the admin.
The admin interface allows managing the cached packages, including manually issuing caching tasks and setting up daily package updates.
Copyright © 2013 Toran Billups, Tin Tvrtković.
Licensed under the MIT License