https://github.com/saltstack-formulas/memcached-formula
https://github.com/saltstack-formulas/memcached-formula
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/saltstack-formulas/memcached-formula
- Owner: saltstack-formulas
- License: other
- Created: 2013-06-12T22:06:05.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-02-19T15:05:31.000Z (almost 3 years ago)
- Last Synced: 2023-03-11T09:43:43.733Z (almost 3 years ago)
- Language: SaltStack
- Homepage: http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html
- Size: 40 KB
- Stars: 15
- Watchers: 38
- Forks: 78
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
memcached
=========
Install and start the memcached service on GNU/Linux and FreeBSD
.. note::
See the full `Salt Formulas installation and usage instructions
`_.
Available states
================
.. contents::
:local:
``memcached``
-------------
Installs and starts memcached service
``memcached.config``
--------------------
Memcached configuration file
``memcached.python_memcached``
------------------------------
Installs ``python-memcached`` package for RedHat/CentOS and ``python-memcache`` package for Debian
``memcached.libmemcached``
--------------------
Installs libmemcached development files to install ``pylibmc`` as python driver
``memcached.uninstall``
-------------
Stops the memcached service and uninstalls the package.
Instructions
============
1. Add this repository as a `GitFS backend`_ in your Salt master config.
2. Determine which minions will run memcached and ``include`` the
``memcached`` state.
One possible example is to run memcached on each server that is also
running your web application. The following contrived example uses a Django
web app deployed from an internal Git repository::
include:
- memcached
- memcached.python_memcached
python-django:
pkg:
- installed
https://internal-repos/mydjangoapp.git:
git.latest:
- target: /var/www/mydjangoapp
- require:
- pkg: python-django
- pkg: python-memcached
3. (Optional) Use Salt Mine to maintain a live list of currently running
memcached instances in your web application config.
The following example assumes all web application servers have a hostname
that starts with "web".
1. Configure your Pillar top file (``/srv/pillar/top.sls``)::
base:
'web*':
- application_server
2. Configure Salt Mine in ``/srv/pillar/application_server.sls``::
mine_functions:
network.interfaces: [eth0]
3. Add the IP addresses to your web application config.
Building on the Django example above, add the following states::
/var/www/mydjangoapp/config.py:
file:
- managed
- source: salt://mydjangoapp/config.py
- template: jinja
- require:
- git: https://internal-repos/mydjangoapp.git
Edit the ``/srv/salt/mydjangoapp/config.py`` template to add the
memcached server addresses (only relevant portions of ``config.py`` are
shown)::
CACHES = {
'default': {
'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
'LOCATION': [
{% for server,ip in salt['mine.get']('web*', 'network.interfaces', ['eth0']).items() %}
'{{ ip }}:11211`,
{% endfor %}
]
}
}
.. _`GitFS backend`: http://docs.saltstack.com/topics/tutorials/gitfs.html