Allow purging policy files

This change introduces the new purge_config parameter to the policy
class so that any policy rules not managed by puppet manifests can be
cleared.

Co-Authored-By: Martin Schuppert <mschuppert@redhat.com>
Depends-On: https://review.opendev.org/802305
Change-Id: I7e453f3abf08e13d2366ea68af1ce859a88e8448

manifests/policy.pp

@@ -32,11 +32,22 @@
 #   (Optional) Path to the zaqar policy.yaml file
 #   Defaults to /etc/zaqar/policy.yaml
 #
+# [*policy_dirs*]
+#   (Optional) Path to the zaqar policy folder
+#   Defaults to $::os_service_default
+#
+# [*purge_config*]
+#   (optional) Whether to set only the specified policy rules in the policy
+#    file.
+#    Defaults to false.
+#
 class zaqar::policy (
   $enforce_scope        = $::os_service_default,
   $enforce_new_defaults = $::os_service_default,
   $policies             = {},
   $policy_path          = '/etc/zaqar/policy.yaml',
+  $policy_dirs          = $::os_service_default,
+  $purge_config         = false,
 ) {
 
   include zaqar::deps
@@ -44,19 +55,22 @@ class zaqar::policy (
 
   validate_legacy(Hash, 'validate_hash', $policies)
 
-  Openstacklib::Policy::Base {
-    file_path   => $policy_path,
+  $policy_parameters = {
+    policies     => $policies,
+    policy_path  => $policy_path,
     file_user    => 'root',
     file_group   => $::zaqar::params::group,
     file_format  => 'yaml',
+    purge_config => $purge_config,
   }
 
-  create_resources('openstacklib::policy::base', $policies)
+  create_resources('openstacklib::policy', { $policy_path => $policy_parameters })
 
   oslo::policy { 'zaqar_config':
     enforce_scope        => $enforce_scope,
     enforce_new_defaults => $enforce_new_defaults,
-    policy_file          => $policy_path
+    policy_file          => $policy_path,
+    policy_dirs          => $policy_dirs,
   }
 
 }

releasenotes/notes/policy_purge_config-eaa62ca7e22d5af6.yaml

@@ -0,0 +1,6 @@
+---
+features:
+  - |
+    Adds new purge_config parameter. When set to true, the policy file is
+    cleared during configuration process. This allows to remove any existing
+    rules before applying them or clean the file when all policies got removed.

spec/classes/zaqar_policy_spec.rb

@@ -2,11 +2,14 @@ require 'spec_helper'
 
 describe 'zaqar::policy' do
   shared_examples 'zaqar::policy' do
+
+    context 'setup policy with parameters' do
       let :params do
         {
           :enforce_scope        => false,
           :enforce_new_defaults => false,
           :policy_path          => '/etc/zaqar/policy.yaml',
+          :policy_dirs          => '/etc/zaqar/policy.d',
           :policies             => {
             'context_is_admin' => {
               'key'   => 'context_is_admin',
@@ -17,13 +20,48 @@ describe 'zaqar::policy' do
       end
 
       it 'set up the policies' do
-      is_expected.to contain_openstacklib__policy__base('context_is_admin').with({
-        :key         => 'context_is_admin',
-        :value       => 'foo:bar',
+        is_expected.to contain_openstacklib__policy('/etc/zaqar/policy.yaml').with(
+          :policies     => {
+            'context_is_admin' => {
+              'key'   => 'context_is_admin',
+              'value' => 'foo:bar'
+            }
+          },
+          :policy_path  => '/etc/zaqar/policy.yaml',
           :file_user    => 'root',
           :file_group   => 'zaqar',
           :file_format  => 'yaml',
-      })
+          :purge_config => false,
+        )
+        is_expected.to contain_oslo__policy('zaqar_config').with(
+          :enforce_scope        => false,
+          :enforce_new_defaults => false,
+          :policy_file          => '/etc/zaqar/policy.yaml',
+          :policy_dirs          => '/etc/zaqar/policy.d',
+        )
+      end
+    end
+
+    context 'with empty policies and purge_config enabled' do
+      let :params do
+        {
+          :enforce_scope        => false,
+          :enforce_new_defaults => false,
+          :policy_path          => '/etc/zaqar/policy.yaml',
+          :policies             => {},
+          :purge_config         => true,
+        }
+      end
+
+      it 'set up the policies' do
+        is_expected.to contain_openstacklib__policy('/etc/zaqar/policy.yaml').with(
+          :policies     => {},
+          :policy_path  => '/etc/zaqar/policy.yaml',
+          :file_user    => 'root',
+          :file_group   => 'zaqar',
+          :file_format  => 'yaml',
+          :purge_config => true,
+        )
         is_expected.to contain_oslo__policy('zaqar_config').with(
           :enforce_scope        => false,
           :enforce_new_defaults => false,
@@ -31,6 +69,7 @@ describe 'zaqar::policy' do
         )
       end
     end
+  end
 
   on_supported_os({
     :supported_os => OSDefaults.get_supported_os