saltstack-formulas
/
postfix-formula
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
postfix-formula/README.rst

63 lines
1.3 KiB
ReStructuredText
Raw Normal View History

Update README.rst
2014-09-08 04:01:17 +02:00
postfix-formula
===============
Set up initial readme
2013-06-13 07:50:38 +02:00
Update readme to show both available states
2014-08-20 02:33:41 +02:00
Formulas to set up and configure the Postfix mail transfer agent.
.. note::
See the full `Salt Formulas installation and usage instructions
<http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
Improve services definitions The services definitions for master.cf were previously defined in the services.jinja file. This commit instead moves them into the services.yaml file, as we should not require any jinja parsing inside the services definitions. Drive-By: Add a .gitignore file Drive-By: Set manage_master_config: True for kitchen. We do want to verify that the master.cf file generation is actually working. Drive-By: Add fedora-latest as a kitchen testing target, this helps with verifying the os_family map testing that was added in PR #79 Drive-By: Link to the kitchen-salt getting started guide in the README
2018-10-08 11:07:34 +02:00
Update readme to show both available states
2014-08-20 02:33:41 +02:00
Available states
================
.. contents::
:local:
``postfix``
-----------
Installs and starts postfix SMTP server
``postfix.config``
------------------
Set up initial readme
2013-06-13 07:50:38 +02:00
Allow for full managed master.cf services Currently master.cf only allows for _very_ limited configuration options mainly focussed on SMTP submission settings. This is rather limited and does not scale very well for managing the other services defined in master.cf. This patch has moved all the service definitions into a jinja file and generates the master.cf service definition on the fly based on these defaults. Defaults can be overridden in a pillar to customize the rendered master.cf file accordingly to local needs. Undefined values will be filled with the postfix defaults. Care has been taken that the previous ways of managing the submission configuration options are still supported for backwards compatibility to prevent breakage for existing users of the formula.
2018-03-11 19:22:12 +01:00
Manages postfix main.cf and optionally the master.cf configuration file
added missing sls to README
2016-05-23 12:39:55 +02:00
``postfix.policyd-spf``
------------------
Installs and configures policyd-spf
``postfix.postgrey``
------------------
Installs and starts Postgrey service
install postfix addons ( Debian Only) - mysql - pcre
2016-05-24 11:49:28 +02:00
``postfix.mysql``
------------------
Installs postfix mysql package ( Debian only)
``postfix.pcre``
------------------
Installs postfix pcre package ( Debian only)
add support for postsrsd
2017-01-08 20:02:57 +01:00
``postfix.postsrsd``
------------------
Installs postfix postsrsd package
Improve services definitions The services definitions for master.cf were previously defined in the services.jinja file. This commit instead moves them into the services.yaml file, as we should not require any jinja parsing inside the services definitions. Drive-By: Add a .gitignore file Drive-By: Set manage_master_config: True for kitchen. We do want to verify that the master.cf file generation is actually working. Drive-By: Add fedora-latest as a kitchen testing target, this helps with verifying the os_family map testing that was added in PR #79 Drive-By: Link to the kitchen-salt getting started guide in the README
2018-10-08 11:07:34 +02:00
Integration testing
===================
A rudimentary test-suite exists to verify basic functionality of the postfix-formula.
Testing is done using the [Kitchen CI Framework](https://kitchen.ci/). Pull-Requests are verified using [Travis CI](https://travis-ci.org/).
A general getting started guide for kitchen-salt can be found at <https://github.com/saltstack/kitchen-salt/blob/master/docs/gettingstarted.md>.