Maintenance & License•5 min read•Safety

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.

Project Trash Bin and Soft-Deleted Resource Recovery

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.

Operators can narrow down deleted assets using the toolbar controls:

  • Category Filter Pills: Toggle between All, Hosts, Playbooks, Inventories, and Variable Sets with 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:

ColumnDescription
Resource NameFriendly name accompanied by category icon (Server, Playbook, Inventory, Variable).
TypeColor-coded category badge (Host, Playbook, Inventory, Variable Set).
Technical ReferenceOperational identifier, such as host IP address, relative playbook path, or encryption status.
Deleted ByUsername or email of the team member who initiated the deletion.
Deleted TimeRelative deletion timestamp (e.g. 10 minutes ago) with exact UTC timestamp in the tooltip.
ActionsQuick-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

  1. Navigate to Trash in the active project sidebar.
  2. Locate the resource in the table or filter by category.
  3. Click the Restore button on the right side of the row.
  4. 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:

  1. Click the Purge button on the resource row.
  2. Confirm the action in the confirmation dialog.
  3. CIEL permanently deletes the resource record and associated file attachments. This action cannot be undone.

C. Bulk Operations

When cleaning up multiple test resources:

  1. Select the checkboxes on individual rows, or use the header checkbox to select all visible items.
  2. The batch operations bar appears above the table, showing the count of selected items.
  3. 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:

  1. Click Empty Trash Bin in the top page header.
  2. Confirm the purge warning in the dialog window.
  3. 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):

ActionProject OwnerProject AdminProject MemberProject Viewer
View Trash ItemsAllowedAllowedAllowedAllowed
Restore ResourceAllowedAllowedRestrictedRestricted
Purge ResourceAllowedAllowedRestrictedRestricted
Bulk OperationsAllowedAllowedRestrictedRestricted
Empty Trash BinAllowedAllowedRestrictedRestricted

This permission hierarchy ensures that junior team members or automated CI runners cannot accidentally destroy soft-deleted assets without administrator oversight.