This is a collection of extension modules aimed at extending Varnish Cache without spending too much work on deployment.
Contents:
- vmods you will need often. (cookie, var, header, etc)
- Useful VCL snippets. (planned)
- Extension scripts, like cronjobs for logging 5xx safely with log rotation (planned)
Main platform to run on is Ubuntu LTS. (currently 18.04/bionic) Main Varnish version is the latest LTS. (currently 6.0)
You need cmake, varnish-dev and a compiler.
cmake .
make
sudo make install
There will be binary packages (for Ubuntu) made available.
They are meant to be used with the LTS packages that Varnish Cache (or, specificly, VS) have on packagecloud.io.
For anything that is imported verbatim (most vmods), you should file bugs upstream.
Look in foreign/*/README.rst and see if that helps you find the correct bug/issue tracker.
If you don't get any traction there and you have business needs, Isokron AS is offering consulting services and can help you out. Email contact@isokron.no and we'll be in touch.
PRs are welcome.
Stale issues will be closed after 60 days of inactivity. There is no benefit for anyone having an unmanageable amount of open issues.
If you feel strongly about a bug or feature request, keep polling and we'll know about it.
Maybe.
Key questions: Is the code quality ok? Is anyone maintaining it? Will we want to use it ourselves?
If it is trivial (no third party libs), has documentation and tests, the answer is most likely yes.
git submodule add https://github.com/user/libvmod-foo foreign/user-foo
mkdir vmods/foo && cd vmods/foo
cp ../_templates/* .
# edit CMakeLists.txt to taste.
# Either symlink sources from ../../foreign/user-foo/, or use ./import-upstream if
# modifications are needed.
cd ../../
# add to top-level CMakeLists.txt