Revisions
Revisions track the configuration history of entities over time. Every time you modify an entity, InfraKitchen creates a new revision, allowing you to view changes and compare configurations.
Overview
A revision is a snapshot of an entity’s configuration at a specific point in time. Revisions are automatically created whenever you update an entity, providing complete change history without manual intervention.
Viewing Revisions
Open the entity whose history you want to inspect, click the Activity button, and switch to the Revisions tab to view and compare the revision history.
Revision Interface
The revisions interface has three main sections:
1. Revision List
Displays all revisions for the entity:
| Info | Description |
|---|---|
| Version | Revision number (e.g., v1, v2, v3) |
| Timestamp | When the revision was created |
| Name | Optional human-readable name (from entity name field) |
| Description | Optional description (from entity description field) |
Revisions are listed in descending order (newest first).
2. Compare Section
Select two revisions to compare:
- Left revision dropdown — Choose the older/base version
- Right revision dropdown — Choose the newer/modified version
- Defaults to comparing the two most recent revisions
3. Diff Viewer
Diff viewer showing:
- Highlighted changes — Additions, deletions, and modifications
- Line numbers — For precise change identification
- JSON formatting — Pretty-printed for readability
Comparing Revisions
The diff viewer highlights changes between revisions:
- Green — Added fields or modified values (new state)
- Red — Removed fields or previous values (old state)
- White — Unchanged fields