Merge pull request #285 from richm/cl-20240405

docs(changelog): version v0.23.4 [citest skip]

.README.html

@@ -173,6 +173,8 @@ <h1 class="toc-title">Contents</h1>
 id="toc-sshd_sysconfig_use_strong_rng">sshd_sysconfig_use_strong_rng</a></li>
 <li><a href="#sshd_config_file"
 id="toc-sshd_config_file">sshd_config_file</a></li>
+<li><a href="#sshd_main_config_file"
+id="toc-sshd_main_config_file">sshd_main_config_file</a></li>
 <li><a href="#sshd_config_namespace"
 id="toc-sshd_config_namespace">sshd_config_namespace</a></li>
 <li><a href="#sshd_config_owner-sshd_config_group-sshd_config_mode"
@@ -445,6 +447,19 @@ <h3 id="sshd_config_file">sshd_config_file</h3>
 configuration file (defined with the variable
 <code>sshd_main_config_file</code>) is checked to contain a proper
 <code>Include</code> directive.</p>
+<h3 id="sshd_main_config_file">sshd_main_config_file</h3>
+<p>When the system is using drop-in directory, this option can be used
+to set a path to the main configuration file and let you configure only
+the drop-in configuration file using <code>sshd_config_file</code>. This
+is useful in cases when you need to configure second independent sshd
+service with different configuration file. This is also the file used in
+the service file.</p>
+<p>On systems without drop-in directory, it defaults to
+<code>None</code>. Otherwise it defaults to
+<code>/etc/ssh/sshd_config</code>. When the
+<code>sshd_config_file</code> is set outside of the drop in directory
+(its parent directory is not <code>sshd_main_config_file</code> ~ '.d'),
+this variable is ignored.</p>
 <h3 id="sshd_config_namespace">sshd_config_namespace</h3>
 <p>By default (<em>null</em>), the role defines whole content of the
 configuration file including system defaults. You can use this variable

CHANGELOG.md

@@ -1,6 +1,13 @@
 Changelog
 =========
 
+[v0.23.4] - 2024-04-05
+--------------------
+
+### Bug Fixes
+
+- fix: Document and streamline the sshd_main_config_file (#281)
+
 [v0.23.3] - 2024-04-03
 --------------------
 
@@ -66,7 +73,6 @@ Changelog
   Issue Tracker Tickets (Jira or BZ if any):
   #259 #260 #261
 
-
 [v0.21.0] - 2023-09-12
 --------------------
 
@@ -222,7 +228,6 @@ Changelog
 
   This removes the `defaults/Debian.yml` file and moves it to the `defaults/Debian_7.yml` file. This prohibits rolling out ancient config on new Debian-Systems which aren't supported by this role.
 
-
 [v0.19.0] - 2023-04-27
 --------------------