-
Notifications
You must be signed in to change notification settings - Fork 20
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs(changelog): version 1.5.0 [citest skip]
Update changelog and .README.html for version 1.5.0 Signed-off-by: Rich Megginson <[email protected]>
- Loading branch information
Showing
2 changed files
with
67 additions
and
38 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -59,7 +59,7 @@ | |
| <style type="text/css">code{white-space: pre;}</style> | ||
| <style type="text/css"> | ||
| pre > code.sourceCode { white-space: pre; position: relative; } | ||
| pre > code.sourceCode > span { display: inline-block; line-height: 1.25; } | ||
| pre > code.sourceCode > span { line-height: 1.25; } | ||
| pre > code.sourceCode > span:empty { height: 1.2em; } | ||
| .sourceCode { overflow: visible; } | ||
| code.sourceCode > span { color: inherit; text-decoration: inherit; } | ||
|
|
@@ -70,7 +70,7 @@ | |
| } | ||
| @media print { | ||
| pre > code.sourceCode { white-space: pre-wrap; } | ||
| pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; } | ||
| pre > code.sourceCode > span { display: inline-block; text-indent: -5em; padding-left: 5em; } | ||
| } | ||
| pre.numberSource code | ||
| { counter-reset: source-line 0; } | ||
|
|
@@ -143,6 +143,8 @@ <h1 class="toc-title">Contents</h1> | |
| <li><a href="#role-variables" id="toc-role-variables">Role Variables</a> | ||
| <ul> | ||
| <li><a href="#postfix_conf" id="toc-postfix_conf">postfix_conf</a></li> | ||
| <li><a href="#postfix_files" | ||
| id="toc-postfix_files">postfix_files</a></li> | ||
| <li><a href="#postfix_check" | ||
| id="toc-postfix_check">postfix_check</a></li> | ||
| <li><a href="#postfix_backup" | ||
|
|
@@ -217,15 +219,27 @@ <h2 id="postfix_conf">postfix_conf</h2> | |
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_conf</span><span class="kw">:</span></span> | ||
| <span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">previous</span><span class="kw">:</span><span class="at"> replaced</span></span> | ||
| <span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relayhost</span><span class="kw">:</span><span class="at"> example.com</span></span></code></pre></div> | ||
| <h2 id="postfix_check">postfix_check</h2> | ||
| <h2 id="postfix_files">postfix_files</h2> | ||
| <div class="sourceCode" id="cb4"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_check</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span></code></pre></div> | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_files</span><span class="kw">:</span></span> | ||
| <span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> sasl_passwd</span></span> | ||
| <span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">content</span><span class="kw">:</span><span class="at"> example.com user:password</span></span> | ||
| <span id="cb4-4"><a href="#cb4-4" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postmap</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> | ||
| <span id="cb4-5"><a href="#cb4-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> sender_canonical_maps</span></span> | ||
| <span id="cb4-6"><a href="#cb4-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">content</span><span class="kw">:</span><span class="at"> /.+/ [email protected]</span></span></code></pre></div> | ||
| <p>This is a list of files that will be placed in /etc/postfix and that | ||
| can be converted into Postfix Lookup Tables if needed.</p> | ||
| <p>It's meant as a simple mechanism to configure things such as SASL | ||
| credentials and other small snippets.</p> | ||
| <h2 id="postfix_check">postfix_check</h2> | ||
| <div class="sourceCode" id="cb5"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_check</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span></code></pre></div> | ||
| <p>This is a boolean which determines if <code>postfix check</code> is | ||
| run before starting Postfix if the configuration has changed. The | ||
| default is <code>true</code>.</p> | ||
| <h2 id="postfix_backup">postfix_backup</h2> | ||
| <div class="sourceCode" id="cb5"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_backup</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span></code></pre></div> | ||
| <div class="sourceCode" id="cb6"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_backup</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span></code></pre></div> | ||
| <p>This is a boolean which determines if the role will make a single | ||
| backup copy of the configuration - for example, | ||
| <code>cp /etc/postfix/main.cf /etc/postfix/main.cf.backup</code>, thus | ||
|
|
@@ -234,8 +248,8 @@ <h2 id="postfix_backup">postfix_backup</h2> | |
| you must also set <code>postfix_backup_multiple: false</code> - see | ||
| below.</p> | ||
| <h2 id="postfix_backup_multiple">postfix_backup_multiple</h2> | ||
| <div class="sourceCode" id="cb6"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_backup_multiple</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span></code></pre></div> | ||
| <div class="sourceCode" id="cb7"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="fu">postfix_backup_multiple</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span></code></pre></div> | ||
| <p>This is a boolean which determines if the role will make a | ||
| timestamped backup copy of the configuration - for example, | ||
| <code>cp /etc/postfix/main.cf /etc/postfix/main.cf.$(date -Isec)</code>, | ||
|
|
@@ -273,52 +287,52 @@ <h1 id="example-playbook">Example Playbook</h1> | |
| <p>Install and enable postfix. Configure | ||
| <code>relay_domains=$mydestination</code> and | ||
| <code>relayhost=example.com</code>.</p> | ||
| <div class="sourceCode" id="cb7"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span> | ||
| <span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix</span></span> | ||
| <span id="cb7-3"><a href="#cb7-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">hosts</span><span class="kw">:</span><span class="at"> all</span></span> | ||
| <span id="cb7-4"><a href="#cb7-4" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">vars</span><span class="kw">:</span></span> | ||
| <span id="cb7-5"><a href="#cb7-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_conf</span><span class="kw">:</span></span> | ||
| <span id="cb7-6"><a href="#cb7-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relay_domains</span><span class="kw">:</span><span class="at"> $mydestination</span></span> | ||
| <span id="cb7-7"><a href="#cb7-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relayhost</span><span class="kw">:</span><span class="at"> example.com</span></span> | ||
| <span id="cb7-8"><a href="#cb7-8" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb7-9"><a href="#cb7-9" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <p>Install and enable postfix. Do not run 'postfix check' before | ||
| restarting postfix:</p> | ||
| <div class="sourceCode" id="cb8"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span> | ||
| <span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix with no check</span></span> | ||
| <span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix</span></span> | ||
| <span id="cb8-3"><a href="#cb8-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">hosts</span><span class="kw">:</span><span class="at"> all</span></span> | ||
| <span id="cb8-4"><a href="#cb8-4" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">vars</span><span class="kw">:</span></span> | ||
| <span id="cb8-5"><a href="#cb8-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_check</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span> | ||
| <span id="cb8-6"><a href="#cb8-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb8-7"><a href="#cb8-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <p>Install and enable postfix. Do single backup of main.cf (older backup | ||
| will be rewritten) and configure <code>relayhost=example.com</code>:</p> | ||
| <span id="cb8-5"><a href="#cb8-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_conf</span><span class="kw">:</span></span> | ||
| <span id="cb8-6"><a href="#cb8-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relay_domains</span><span class="kw">:</span><span class="at"> $mydestination</span></span> | ||
| <span id="cb8-7"><a href="#cb8-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relayhost</span><span class="kw">:</span><span class="at"> example.com</span></span> | ||
| <span id="cb8-8"><a href="#cb8-8" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb8-9"><a href="#cb8-9" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <p>Install and enable postfix. Do not run 'postfix check' before | ||
| restarting postfix:</p> | ||
| <div class="sourceCode" id="cb9"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span> | ||
| <span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix with relayhost</span></span> | ||
| <span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix with no check</span></span> | ||
| <span id="cb9-3"><a href="#cb9-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">hosts</span><span class="kw">:</span><span class="at"> all</span></span> | ||
| <span id="cb9-4"><a href="#cb9-4" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">vars</span><span class="kw">:</span></span> | ||
| <span id="cb9-5"><a href="#cb9-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_conf</span><span class="kw">:</span></span> | ||
| <span id="cb9-6"><a href="#cb9-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relayhost</span><span class="kw">:</span><span class="at"> example.com</span></span> | ||
| <span id="cb9-7"><a href="#cb9-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_backup</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> | ||
| <span id="cb9-8"><a href="#cb9-8" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb9-9"><a href="#cb9-9" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <p>Install and enable postfix. Do timestamped backup of main.cf and | ||
| configure <code>relayhost=example.com</code> (if | ||
| <code>postfix_backup_multiple</code> is set to true | ||
| <code>postfix_backup</code> is ignored):</p> | ||
| <span id="cb9-5"><a href="#cb9-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_check</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span> | ||
| <span id="cb9-6"><a href="#cb9-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb9-7"><a href="#cb9-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <p>Install and enable postfix. Do single backup of main.cf (older backup | ||
| will be rewritten) and configure <code>relayhost=example.com</code>:</p> | ||
| <div class="sourceCode" id="cb10"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span> | ||
| <span id="cb10-2"><a href="#cb10-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix with multiple backups</span></span> | ||
| <span id="cb10-2"><a href="#cb10-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix with relayhost</span></span> | ||
| <span id="cb10-3"><a href="#cb10-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">hosts</span><span class="kw">:</span><span class="at"> all</span></span> | ||
| <span id="cb10-4"><a href="#cb10-4" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">vars</span><span class="kw">:</span></span> | ||
| <span id="cb10-5"><a href="#cb10-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_conf</span><span class="kw">:</span></span> | ||
| <span id="cb10-6"><a href="#cb10-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relayhost</span><span class="kw">:</span><span class="at"> example.com</span></span> | ||
| <span id="cb10-7"><a href="#cb10-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_backup_multiple</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> | ||
| <span id="cb10-7"><a href="#cb10-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_backup</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> | ||
| <span id="cb10-8"><a href="#cb10-8" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb10-9"><a href="#cb10-9" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <p>Install and enable postfix. Do timestamped backup of main.cf and | ||
| configure <code>relayhost=example.com</code> (if | ||
| <code>postfix_backup_multiple</code> is set to true | ||
| <code>postfix_backup</code> is ignored):</p> | ||
| <div class="sourceCode" id="cb11"><pre | ||
| class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span> | ||
| <span id="cb11-2"><a href="#cb11-2" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> Manage postfix with multiple backups</span></span> | ||
| <span id="cb11-3"><a href="#cb11-3" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">hosts</span><span class="kw">:</span><span class="at"> all</span></span> | ||
| <span id="cb11-4"><a href="#cb11-4" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">vars</span><span class="kw">:</span></span> | ||
| <span id="cb11-5"><a href="#cb11-5" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_conf</span><span class="kw">:</span></span> | ||
| <span id="cb11-6"><a href="#cb11-6" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">relayhost</span><span class="kw">:</span><span class="at"> example.com</span></span> | ||
| <span id="cb11-7"><a href="#cb11-7" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">postfix_backup_multiple</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> | ||
| <span id="cb11-8"><a href="#cb11-8" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="fu">roles</span><span class="kw">:</span></span> | ||
| <span id="cb11-9"><a href="#cb11-9" aria-hidden="true" tabindex="-1"></a><span class="at"> </span><span class="kw">-</span><span class="at"> linux-system-roles.postfix</span></span></code></pre></div> | ||
| <h1 id="rpm-ostree">rpm-ostree</h1> | ||
| <p>See README-ostree.md</p> | ||
| <h1 id="license">License</h1> | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters