Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

postfix-dovecot (9) Versions 1.0.0

Installs and configures a mail server using Postfix, Dovecot, PostfixAdmin and SpamAssassin, including Amazon SES support.

Berkshelf/Librarian
Policyfile
Knife
cookbook 'postfix-dovecot', '= 1.0.0'
cookbook 'postfix-dovecot', '= 1.0.0', :supermarket
knife cookbook site install postfix-dovecot
knife cookbook site download postfix-dovecot
README
Dependencies
Changelog
Quality

Description

Cookbook Version Dependency Status Build Status

Installs and configures a mail server using Postfix, Dovecot, PostfixAdmin and SpamAssassin, including Amazon SES support.

Requirements

Supported Platforms

This cookbook has been tested on the following platforms:

  • Amazon Linux
  • CentOS >= 6.0
  • Debian >= 7.0
  • Fedora >= 17.0
  • Ubuntu >= 12.04

Please, let us know if you use it successfully on any other platform.

Required Cookbooks

Required Applications

  • Dovecot >= 2: requires this version of dovecot to be available by the distribution's package manager
  • Ruby >= 1.9.3
  • Chef >= 11.14.2

Attributes

<table> <tr> <th>Attribute</th> <th>Description</th> <th>Default</th> </tr> <tr> <td><code>node['postfix-dovecot']['postmaster_address']</code></td> <td>Postmaster mail address.</td> <td><code>"postmaster@foo.bar"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['hostname']</code></td> <td>Hostname.</td> <td><code>node["fqdn"]</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['database']['type']</code></td> <td>Database type. Possible values are: <code>"mysql"</code>, <code>"postgresql"</code> (Please, see <a href="#postgresql-support">below<a/>)</td> <td><code>"mysql"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['sieve']['enabled']</code></td> <td>Whether to enable sieve.</td> <td><code>true</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['sieve']['global_path']</code></td> <td>Sieve global path.</td> <td><code>"#{default["dovecot"]["conf_path"]}/sieve/default.sieve"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['spamc']['enabled']</code></td> <td>Whether to enable SpamAssassin</td> <td><code>true</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['spamc']['recipe']</code></td> <td>Spamc recipe name to use.</td> <td><code>"onddo-spamassassin"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['vmail']['user']</code></td> <td>Virtual mail system user name.</td> <td><code>"vmail"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['vmail']['group']</code></td> <td>Virtual mail system group name.</td> <td><code>node["postfix-dovecot"]["vmail"]["user"]</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['vmail']['uid']</code></td> <td>Virtual mail system user id.</td> <td><code>5000</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['vmail']['gid']</code></td> <td>Virtual mail system group id.</td> <td><code>node["postfix-dovecot"]["vmail"]["uid"]</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['vmail']['home']</code></td> <td>Virtual mail user home path.</td> <td><code>"/var/vmail"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['ses']['enabled']</code></td> <td>Whether to enable <a href="http://aws.amazon.com/ses/">Amazon SES</a>.</td> <td><code>false</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['ses']['username']</code></td> <td>Amazon SES SMTP username. See the <a href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html"><em>Obtaining Your Amazon SES SMTP Credentials</em> documentation</a>.</td> <td><code>"USERNAME"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['ses']['password']</code></td> <td>Amazon SES SMTP password.</td> <td><code>"PASSWORD"</code></td> </tr> <tr> <td><code>node['postfix-dovecot']['ses']['servers']</code></td> <td>Amazon SES SMTP servers.</td> <td><code>[<br/>   'email-smtp.us-east-1.amazonaws.com:25',<br/>   'ses-smtp-prod-335357831.us-east-1.elb.amazonaws.com:25'<br/> ]</code></td> </tr> </table>

The HTTPS Certificate

This cookbook uses the ssl_certificate cookbook to create the HTTPS certificate. The namespace used is node['postfix-dovecot']. For example:

node.default['postfix-dovecot']['common_name'] = 'mail.example.com'
include_recipe 'postfix-dovecot'

See the ssl_certificate namespace documentation for more information.

Recipes

postfix-dovecot::default

Installs and configures everything.

postfix-dovecot::vmail

Creates vmail user.

postfix-dovecot::spam

Installs and configures SpamAssassin.

postfix-dovecot::postfix

Installs and configures Postfix.

postfix-dovecot::postfix_mysql

Installs Postfix package with MySQL support. Used by the postfix-dovecot::postfix recipe.

postfix-dovecot::postfix_postgresql

Installs Postfix package with PostgreSQL support. Used by the postfix-dovecot::postfix recipe.

postfix-dovecot::postfixadmin

Installs and configures PostfixAdmin.

postfix-dovecot::dovecot

Installs and configures Dovecot 2.

Usage Example

Including in a Cookbook Recipe

Running it from a recipe:

node['postfix-dovecot']['postmaster_address'] = 'postmaster@foobar.com'
node['postfix-dovecot']['hostname'] = 'mail.foobar.com'

include_recipe 'postfix-dovecot::default'

postfixadmin_admin 'admin@admindomain.com' do
  password 'sup3r-s3cr3t-p4ss'
  action :create
end

postfixadmin_domain 'foobar.com' do
  login_username 'admin@admindomain.com'
  login_password 'sup3r-s3cr3t-p4ss'
end

postfixadmin_mailbox 'bob@foobar.com' do
  password 'alice'
  login_username 'admin@admindomain.com'
  login_password 'sup3r-s3cr3t-p4ss'
end

postfixadmin_alias 'billing@foobar.com' do
  goto 'bob@foobar.com'
  login_username 'admin@admindomain.com'
  login_password 'sup3r-s3cr3t-p4ss'
end

Don't forget to include the postfix-dovecot cookbook as a dependency in the metadata.

# metadata.rb
[...]

depends 'postfix-dovecot'

Including in the Run List

Another alternative is to include the default recipe in your Run List.

{
  "name": "mail.onddo.com",
  [...]
  "run_list": [
    [...]
    "recipe[postfix-dovecot]"
  ]
}

PostgreSQL Support

PostgreSQL support should be considered experimental at the moment. Use at your own risk.

Any feedback you can provide regarding the PostgreSQL support will be greatly appreciated.

PostgreSQL Support on Debian and Ubuntu

Due to postgresql cookbook issue #108, you should configure your system locale correctly for PostgreSQL to work. You can use the locale cookbook to fix this. For example:

ENV['LANGUAGE'] = ENV['LANG'] = node['locale']['lang']
ENV['LC_ALL'] = node['locale']['lang']
include_recipe 'locale'
# ...
node.default['postfix-dovecot']['database']['type'] = 'postgresql'
include_recipe 'postfix-dovecot'

PostgreSQL Support on CentOS and Fedora

Tha lastest CentOS and Fedora versions come without PostgreSQL support in their Postfix package. So we need to recompile it using the SRPM, enabling the PostgreSQL support.

The postfix-dovecot::postfix_postgresql recipe takes care of it transparently. This recipe has been tested using test-kitchen, but it may not work for all cases. This code has been tested in the following platforms:

  • CentOS 6.5 and 7.0
  • Fedora 19 and 20.

Please, let us know if you use PostgreSQL support successfully on any other platform.

PostgreSQL Support on Amazon Linux

Support for PostgreSQL on Amazon Linux is still not finished because of the need to patch the provided SRPM. Its implementation would require a little monkey-patching.

Please, open an issue if you need the support of PostgreSQL on Amazon Linux.

PostgreSQL Versions < 9.3

If you are using PostgreSQL version < 9.3, you may need to adjust the shmmax and shmall kernel parameters to configure the shared memory. You can see the example used for the integration tests.

Some cookbook attributes are used internally to add PostgreSQL support. They can make your journey smoother if you need to improve PostgreSQL support.

<table> <tr> <th>Attribute</th> <th>Description</th> <th>Default</th> </tr> <tr> <td><code>node['postfix-dovecot']['yum']</code></td> <td>A list of yum repositories to add to include the source SRPMs.</td> <td><em>calculated</em></td> </tr> <tr> <td><code>node['postfix-dovecot']['postfix']['srpm']['packages']</code></td> <td>Packages required for compiling Postfix from sources.</td> <td><em>calculated</em></td> </tr> <tr> <td><code>node['postfix-dovecot']['postfix']['srpm']['rpm_regexp']</code></td> <td>An array with two values, a pattern and a replacement. This Regexp is used to get the final Postfix RPM name from the SRPM name.</td> <td><em>calculated</em></td> </tr> <tr> <td><code>node['postfix-dovecot']['postfix']['srpm']['rpm_build_args']</code></td> <td>A string with the arguments to pass to <em>rpmbuild</em> application. Normally contains the required option to enable PostgreSQL in the Postfix SRPM.</td> <td><em>calculated</em></td> </tr> </table>

See the attributes/postfix_postgresql.rb file for default examples.

Please do not hesitate to make a PR if you improve the PostgreSQL support ;-)

Testing

See TESTING.md.

Contributing

Please do not hesitate to open an issue with any questions or problems.

See CONTRIBUTING.md.

TODO

See TODO.md.

License and Author

Author: Xabier de Zuazo (xabier@onddo.com)
Copyright: Copyright (c) 2013-2014 Onddo Labs, SL. (www.onddo.com)
License: Apache License, Version 2.0
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

yum ~> 3.0
ssl_certificate ~> 0.2
postfix-full ~> 0.1
postfixadmin ~> 1.0
onddo-spamassassin ~> 0.2
dovecot ~> 1.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

CHANGELOG for postfix-dovecot

This file is used to list changes made in each version of postfix-dovecot.

1.0.0 (2014-10-07):

  • Update Warnings::

    • Ruby >= 1.9.3 required.
    • Chef >= 11.14.2 required.
    • Rename ::postfix_full recipe to ::postfix.
  • Update to work with postfixadmin cookbook 1.0.0.

  • Integrate with ssl_certificate cookbook.

  • Fix hostname attribute default value when FQDN is not set.

  • Move test/kitchen/cookbooks directory to test/cookbooks.

  • Fix all RuboCop offenses.

  • README:

    • Separate README file in multiple files.
    • Add some badges.
    • Some small documentation fixes.
    • TESTING: replace old DIGITALOCEAN_CLIENT_ID with DIGITALOCEAN_ACCESS_TOKEN.
  • Add some basic ChefSpec recipe tests and a Rakefile.

  • Add .travis.yml file.

  • Improve Postfix chroot file creation, based on postfix-full master code.

  • Set common_name for PostfixAdmin and Postfix SSL certs.

  • kitchen.yml:

    • Images update.
    • kitchen.cloud.yml: remove all DIGITAL_OCEAN_ env variables.
    • Add minitest-handler again.
    • Fix minitest test mail template.
  • Add PostgreSQL support.

  • metadata: use pessimistic version constraints.

  • Gemfile:

    • Replace vagrant by vagrant-wrapper.
    • Berkshelf update to 3.1.
  • Berkfile: use a generic Berksfile template.

  • Add Guardfile.

  • Vagrantfile:

    • Update to work properly.
    • Document it in TESTING.
  • Use #default_unless instead of #set_unless.

  • ::postfixadmin recipe: remove #set_unless usage.

  • Add Serverspec tests and more bats tests.

  • Define PATH in some integration tests, recommended to use lsof.

  • Integration tests improvement to support more platforms.

  • Fix Debian/Ubuntu PostgreSQL support using the locale cookbook.

  • Improve PostgreSQL support in RPM platforms including tests.

  • Add rubocop.yml file: include some ruby files related with Chef.

0.3.0 (2014-09-14):

  • .kitchen.local.yml.example renamed to .kitchen.ses.yml.
  • Ensure /etc/mailname file creation.
  • Gemfile: some gem versions updated.
  • kitchen.yml: updated to support latest test-kitchen format.
  • README: Amazon SES Tests section: KITCHEN_LOCAL_YAML variable value fixed.
  • Added Fedora and Amazon Linux support.
  • Added kitchen.cloud.yml file.
  • postfix-dovecot_test metadata: added name.
  • kitchen.yml: Added forwarded port and recipe[apt] to the runlist.
  • Depends on postfixadmin cookbook version < 1.0.0.

0.2.0 (2013-08-09):

  • Added Amazon SES support.
    • Added SES tests.
  • Fixed resolv.conf inside chroot in CentOS.

0.1.0 (2013-06-16):

  • Initial release of postfix-dovecot.

Foodcritic Metric
            

1.0.0 passed this metric