Recycle Bin & Resource Recovery
Safeguard infrastructure definitions against accidental deletion with project-level soft-deletion, audit metadata, and one-click resource restoration.
Accidental deletion of server definitions, playbooks, or inventory scopes can disrupt deployment schedules and break automated tasks. To prevent operational disruption, CIEL implements project-level soft deletion across core automation resources.
When an operator removes a resource from a project, CIEL deactivates the asset from active views and routes it to the Trash Bin (/trash). Trashed resources cannot be targeted by ad-hoc runs or automated cron schedules, but all underlying configurations, variable associations, and credentials remain intact until permanently purged.
1. Supported Resource Types
The Trash workspace manages four primary resource categories within an active project:
A. Hosts
Remote server nodes and connection parameters:
- Deactivation: Trashed hosts are excluded from ad-hoc playbook launches and scheduled inventory sweeps.
- Restoration: Restoring a host returns it to the active Hosts table, preserving its assigned IP address, port settings, connection variables (
ciel_user,ciel_port), and assigned SSH keys.
B. Playbooks
Automation playbooks and workflow files:
- Deactivation: Trashed playbooks are removed from the Studio workbench, Saved Runs selectors, and schedule triggers.
- Restoration: Restoring a playbook restores the file to the active playbook directory and re-enables AST inspection in Studio.
C. Inventories
Host groupings and environmental scopes:
- Deactivation: Trashed inventories are hidden from execution options and API execution routes.
- Restoration: Restoring an inventory re-establishes all host memberships, child group assignments, and scope-level variables.
D. Variable Sets
Plain YAML configuration files and encrypted secret sets:
- Deactivation: Trashed variable sets are unlinked from playbook runs to prevent uncommitted configurations from executing.
- Restoration: Restoring a variable set recovers the complete parameter payload, keeping encrypted vault credentials intact.
2. Navigating the Trash Workspace (/trash)
The Trash Bin interface is located under Project Workspace in the sidebar navigation (/trash). It provides an audit view of all soft-deleted assets across the selected project.
Summary Metric Cards
The top header displays quick-count cards to help operators review deleted items by category:
- Hosts: Total soft-deleted server nodes.
- Playbooks: Total soft-deleted playbook definitions.
- Inventories: Total soft-deleted inventory scopes.
- Variable Sets: Total soft-deleted configuration sets.
Filter & Search Bar
Operators can narrow down deleted assets using the toolbar controls:
- Category Filter Pills: Toggle between
All,Hosts,Playbooks,Inventories, andVariable Setswith live item counts. - Real-Time Search: Search through deleted items by resource name, host IP address, playbook file path, or inventory identifier.
Table Metadata Columns
Each trashed resource is displayed with full audit details:
| Column | Description |
|---|---|
| Resource Name | Friendly name accompanied by category icon (Server, Playbook, Inventory, Variable). |
| Type | Color-coded category badge (Host, Playbook, Inventory, Variable Set). |
| Technical Reference | Operational identifier, such as host IP address, relative playbook path, or encryption status. |
| Deleted By | Username or email of the team member who initiated the deletion. |
| Deleted Time | Relative deletion timestamp (e.g. 10 minutes ago) with exact UTC timestamp in the tooltip. |
| Actions | Quick-action buttons to restore or permanently purge the resource. |
3. Restoration and Purge Operations
Operators with sufficient project permissions can recover or permanently remove items from the Trash workspace:
A. Individual Restoration
- Navigate to Trash in the active project sidebar.
- Locate the resource in the table or filter by category.
- Click the Restore button on the right side of the row.
- The resource is immediately returned to its primary workspace tab with all parameters, variables, and historical links intact.
B. Individual Permanent Purge
If an asset was deleted intentionally or needs to be purged for security compliance:
- Click the Purge button on the resource row.
- Confirm the action in the confirmation dialog.
- CIEL permanently deletes the resource record and associated file attachments. This action cannot be undone.
C. Bulk Operations
When cleaning up multiple test resources:
- Select the checkboxes on individual rows, or use the header checkbox to select all visible items.
- The batch operations bar appears above the table, showing the count of selected items.
- Click Bulk Restore to recover all selected assets simultaneously, or click Bulk Purge to permanently delete them in a single batch.
D. Empty Trash Bin
To clear all deleted items across the entire project at once:
- Click Empty Trash Bin in the top page header.
- Confirm the purge warning in the dialog window.
- CIEL permanently purges all soft-deleted resources in the active project.
4. Role Permissions & Safeguards
Access to recovery and permanent purge controls is governed by CIEL project role-based access control (RBAC):
| Action | Project Owner | Project Admin | Project Member | Project Viewer |
|---|---|---|---|---|
| View Trash Items | Allowed | Allowed | Allowed | Allowed |
| Restore Resource | Allowed | Allowed | Restricted | Restricted |
| Purge Resource | Allowed | Allowed | Restricted | Restricted |
| Bulk Operations | Allowed | Allowed | Restricted | Restricted |
| Empty Trash Bin | Allowed | Allowed | Restricted | Restricted |
This permission hierarchy ensures that junior team members or automated CI runners cannot accidentally destroy soft-deleted assets without administrator oversight.