feat(itam): Ability to add device configuration

!43 fixes #44

app/itam/forms/device/device.py

@@ -23,6 +23,7 @@ class Meta:
             'device_type',
             'organization',
             'model_notes',
+            'config',
         ]
 
 

app/itam/migrations/0002_device_config.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.0.7 on 2024-07-17 07:17
+
+import itam.models.device
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('itam', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='device',
+            name='config',
+            field=models.JSONField(blank=True, default=None, help_text='Configuration for this device', null=True, validators=[itam.models.device.Device.validate_config_keys_not_reserved], verbose_name='Host Configuration'),
+        ),
+    ]

app/itam/models/device.py

@@ -44,6 +44,20 @@ def __str__(self):
 class Device(DeviceCommonFieldsName, SaveHistory):
 
 
+    reserved_config_keys: list = [
+        'software'
+    ]
+
+    def validate_config_keys_not_reserved(self):
+
+        value: dict = self
+
+        for invalid_key in Device.reserved_config_keys:
+
+            if invalid_key in value.keys():
+                raise ValidationError(f'json key "{invalid_key}" is a reserved configuration key')
+
+
     def validate_uuid_format(self):
 
         pattern = r'[0-9|a-f]{8}\-[0-9|a-f]{4}\-[0-9|a-f]{4}\-[0-9|a-f]{4}\-[0-9|a-f]{12}'
@@ -113,6 +127,15 @@ def validate_hostname_format(self):
     )
 
 
+    config = models.JSONField(
+        blank = True,
+        default = None,
+        null = True,
+        validators=[ validate_config_keys_not_reserved ],
+        verbose_name = 'Host Configuration',
+        help_text = 'Configuration for this device'
+    )
+
     inventorydate = models.DateTimeField(
         verbose_name = 'Last Inventory Date',
         null = True,
@@ -254,6 +277,10 @@ def get_configuration(self, id):
 
             config['software'] = merge_software(group_software, host_software)
 
+            if self.config:
+
+                config.update(self.config)
+
         return config
 
 

app/itam/templates/itam/device.html.j2

@@ -184,6 +184,13 @@
       <input type="submit" name="{{operating_system.prefix}}" value="Submit" />
     </div>
 
+    <div style="display: block; width: 100%;">
+      <h3>Device Config</h3>
+      <br>
+      <textarea cols="90" rows="30" readonly>{{ device.config }}</textarea>
+    </div>
+
+    <input type="button" value="Edit" onclick="window.location='{% url 'ITAM:_device_change' device.id %}';">
     {% if not tab %}
     <script>
       // Get the element with id="defaultOpen" and click on it

docs/projects/centurion_erp/user/itam/device.md

@@ -69,6 +69,8 @@ This tab displays in `JSON` format configuration that is ready for use. Config f
 
 This configuration can also be obtained from API endpoint `/api/config/<machine-slug>` where `<machine-slug>` would match the Ansible `inventory_hostname`.
 
+The device can also have configuration defined. this configuration is intended to replicate Ansible `hostvars`. After all of the configuration has been rendered from the other modules that contain config, the devices configuration is applied last. In essence the devices configuration will always override any duplicated configuration.
+
 
 ### Inventory