Merge pull request #117 from nickanderson/CFE-3635/master

CFE-3635: Prototyped dnf_appstream custom promise type

Author: nickanderson

.github/workflows/ci.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [master]
   pull_request:
-    branches: [master]
+    types: [opened, reopened, synchronize]
 
 jobs:
   unit_tests:
@@ -31,3 +31,7 @@ jobs:
       run: cfbs --check pretty ./cfbs.json
     - name: Linting
       run: ./ci/linting.sh
+    - name: Install pytest
+      run: pip install pytest
+    - name: Run promise type tests
+      run: python3 -m pytest promise-types/ -v

cfbs.json

@@ -282,6 +282,15 @@
         "append enable.cf services/init.cf"
       ]
     },
+    "promise-type-appstreams": {
+      "description": "Promise type to manage AppStream modules.",
+      "subdirectory": "promise-types/appstreams",
+      "dependencies": ["library-for-promise-types-in-python"],
+      "steps": [
+        "copy appstreams.py modules/promises/",
+        "append init.cf services/init.cf"
+      ]
+    },
     "promise-type-git": {
       "description": "Promise type to manage git repos.",
       "subdirectory": "promise-types/git",

promise-types/appstreams/README.md

@@ -0,0 +1,100 @@
+# AppStreams Promise Type
+
+A CFEngine custom promise type for managing AppStream modules on compatible systems.
+
+## Overview
+
+The `appstreams` promise type allows you to manage AppStream modules, which are a key feature of RHEL 8+ and compatible systems. AppStreams provide multiple versions of software components that can be enabled or disabled as needed.
+
+## Features
+
+- Enable, disable, install, and remove AppStream modules
+- Support for specifying streams and profiles
+
+## Installation
+
+To install this promise type, copy the `appstreams.py` file to your CFEngine masterfiles directory and configure the promise agent:
+
+```
+promise agent appstreams
+{
+  interpreter => "/usr/bin/python3";
+  path => "$(sys.workdir)/modules/promises/appstreams.py";
+}
+```
+
+## Usage
+
+### Ensure a module is enabled
+
+```
+bundle agent main
+{
+  appstreams:
+      "nodejs"
+        state => "enabled",
+        stream => "12";
+}
+```
+
+### Ensure a module is disabled
+
+```
+bundle agent main
+{
+  appstreams:
+      "nodejs"
+        state => "disabled";
+}
+```
+
+### Ensure a module is installed with a specific profile
+
+```
+bundle agent main
+{
+  appstreams:
+      "python36"
+        state => "installed",
+        stream => "3.6",
+        profile => "minimal";
+}
+```
+
+### Ensure a module is removed
+
+```
+bundle agent main
+{
+  appstreams:
+      "postgresql"
+        state => "removed";
+}
+```
+
+### Reset a module to default
+
+```
+bundle agent main
+{
+  appstreams:
+      "nodejs"
+        state => "default";
+}
+```
+
+## Attributes
+
+The promise type supports the following attributes:
+
+- `state` (optional) - Desired state of the module: `enabled`, `disabled`, `installed`, `removed`, `default`, or `reset` (default: `enabled`)
+- `stream` (optional) - Specific stream of the module to use. Set to `default` to use the module's default stream.
+- `profile` (optional) - Specific profile of the module to install. Set to `default` to use the module stream's default profile.
+
+## Requirements
+
+- CFEngine 3.18 or later
+- Python 3
+- DNF Python API (python3-dnf package)
+- DNF/YUM package manager (RHEL 8+, Fedora, CentOS 8+)
+- AppStream repositories configured