appStack Snapshots

appStack Snapshots provide a powerful versioning system that automatically captures snapshots of every change to your appStack, giving you complete control over your infrastructure evolution with the safety of easy rollbacks.

This feature transforms how you experiment with and manage your appStack configurations, providing a comprehensive change history and the ability to restore to any previous state with confidence. Whether you're testing new configurations, experimenting with infrastructure changes, or need to quickly revert to a previous working state, snapshots eliminate the fear of experimentation by providing a safety net for every change.

This is especially valuable for complex infrastructure changes where the ability to quickly revert can save hours of troubleshooting and prevent costly mistakes.

Key Features

• Automatic Snapshot Capture: Every change to an appStack automatically captures a snapshot, ensuring you never lose your work and can track the complete evolution of your infrastructure.
• View Change History: Access a complete timeline of all changes made to your appStack, making it easy to understand what changed, when, and by whom.
• Label Snapshots: Organize and identify important snapshots by adding custom labels and descriptions, making it easier to find and restore to specific milestones or configurations.
• Restore to Any Previous State: Restore your appStack to any previous snapshot with a single click, perfect for experimentation and rollback safety when testing new configurations.

Why Snapshots Matter

Snapshots provide:

• Safety: Never lose your work—every change is automatically preserved.
• Confidence: Experiment freely knowing you can always roll back.
• Auditability: Complete change history with timestamps and user information.
• Flexibility: Organize and label snapshots to match your workflow.

How Snapshots Work

StackGen provides two ways to create snapshots: automatically when changes are made, or manually when you want to mark a specific milestone.

• Automatic Snapshots: When you make changes to your appStack topology, resources, or configurations, StackGen automatically creates a snapshot of the current state. This happens in the background, so you don't need to manually save your work. Every change is preserved.
• Take a Manual Snapshot: While snapshots are created automatically, you can also create snapshots manually at any time to mark important milestones or before making significant changes.

note

All snapshots, both automatic and manually created, are securely stored on StackGen Cloud. This ensures your snapshot history is preserved and accessible from anywhere, even if you switch devices or browsers.

Take a Manual Snapshot

Click to view

To create a snapshot manually, follow these steps:

1. From your appStack, click the Snapshots icon.

   

2. Click Take Snapshot and you're done.

3. You can also click View Snapshots and click Create Snapshot.

   

   You'll need to enter the following details:

   

   • Label: Enter a descriptive label for the snapshot (e.g., "Before major refactoring", "Production-ready state").
   • Description: Add an optional description to provide context about why this snapshot is important.

4. Click Create Snapshot.

View Snapshots

Click to view

The Snapshots page provides a comprehensive view of all snapshots for your appStack, including automatic and manually created snapshots.

Accessing the Snapshots Page: From your appStack, click the Snapshots icon and select View Snapshots.

Filtering and Searching Snapshots: Use the filter options at the top of the Snapshots table to find specific snapshots:

• Label: Search snapshots by their label name.
• Status: Filter by snapshot status (e.g., Active).
• Created By: Search for snapshots created by a specific user.
• Start Date: Filter snapshots created after a specific date.
• End Date: Filter snapshots created before a specific date.

Click the Refresh button to update the snapshot list with the latest data.

Edit Snapshot Labels and Descriptions

Click to view

You can edit the label and description of any snapshot to better organize and identify important states of your appStack.

To edit a snapshot, follow these steps:

1. From the appStack page, click the Snapshot icon > click View Snapshots > click Edit next to the snapshot you want to edit.
2. The snapshot row becomes editable and you can modify:
   • Labels
   • Descriptions
3. Click Save to apply, or Cancel to discard your changes.

Restore a Snapshot

Click to view

Restoring from a snapshot allows you to revert your appStack to any previous state. This is particularly useful when:

• An experiment didn't work as expected.
• You need to roll back to the last known good state.
• You want to compare current state with a previous configuration.

To restore a snapshot:

1. From the appStack page, click the Snapshot icon.
2. Click View Snapshots and click Restore next to the snapshot you want to restore.

Your appStack state is restored.

warning

Restoring a snapshot will revert all changes made after that snapshot was created. Before proceeding, ensure that you have a backup of your appStack state if you don't want to lose any changes made after the snapshot date.

After restoration, your appStack will return to the exact state it was in when the snapshot was created, including all resources, configurations, and topology.

Best Practices

• Label Important Snapshots: Add descriptive labels to snapshots that represent significant milestones (e.g., "Production deployment", "Before security update").
• Create Manual Snapshots Before Major Changes: Before making significant infrastructure changes, create a manual snapshot with a clear label so you can easily identify and restore to the previous state.
• Use Descriptions for Context: Add descriptions to explain why a snapshot is important, making it easier for your team to understand the purpose of each snapshot.