88 lines
2.2 KiB
ReStructuredText
88 lines
2.2 KiB
ReStructuredText
======
|
|
apache
|
|
======
|
|
|
|
Formulas to set up and configure the Apache HTTP server.
|
|
|
|
.. note::
|
|
|
|
See the full `Salt Formulas installation and usage instructions
|
|
<http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
|
|
|
|
Available states
|
|
================
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
``apache``
|
|
----------
|
|
|
|
Installs the Apache package and starts the service.
|
|
|
|
``apache.modules``
|
|
------------------
|
|
|
|
Enables and disables Apache modules.
|
|
|
|
``apache.mod_proxy``
|
|
-------------------
|
|
|
|
Enables the Apache module mod_proxy.
|
|
|
|
``apache.mod_proxy_http``
|
|
-------------------
|
|
|
|
Enables the Apache module mod_proxy_http and requires the Apache module mod_proxy to be enabled.
|
|
|
|
``apache.mod_wsgi``
|
|
-------------------
|
|
|
|
Installs the mod_wsgi package and enables the Apache module.
|
|
|
|
``apache.vhosts.standard``
|
|
-------------------------
|
|
|
|
Configures Apache name-based virtual hosts and creates virtual host directories using data from Pillar.
|
|
|
|
Example Pillar:
|
|
|
|
.. code:: yaml
|
|
|
|
apache:
|
|
sites:
|
|
example.com: # must be unique; used as an ID declaration in Salt; also passed to the template context as {{ id }}
|
|
template_file: salt://apache/vhosts/standard.tmpl
|
|
|
|
|
|
``apache.debian_full``
|
|
----------------------
|
|
|
|
Installs and configures Apache on Debian and Ubuntu systems.
|
|
|
|
These states are ordered using the ``order`` declaration. Different stages
|
|
are divided into the following number ranges:
|
|
|
|
1) apache will use 1-500 for ordering
|
|
2) apache will reserve 1 -100 as unused
|
|
3) apache will reserve 101-150 for pre pkg install
|
|
4) apache will reserve 151-200 for pkg install
|
|
5) apache will reserve 201-250 for pkg configure
|
|
6) apache will reserve 251-300 for downloads, git stuff, load data
|
|
7) apache will reserve 301-400 for unknown purposes
|
|
8) apache will reserve 401-450 for service restart-reloads
|
|
9) apache WILL reserve 451-460 for service.running
|
|
10) apache will reserve 461-500 for cmd requiring operational services
|
|
|
|
Example Pillar:
|
|
|
|
.. code:: yaml
|
|
|
|
apache:
|
|
register-site:
|
|
# any name as an array index, and you can duplicate this section
|
|
{{UNIQUE}}:
|
|
name: 'my name'
|
|
path: 'salt://path/to/sites-available/conf/file'
|
|
state: 'enabled'
|