Stratus5

​Applications

Sites, often referred to as containers, are running instances of your applications deployed from Blueprints on the Stratus5 platform. They represent the live environment for your services. This guide covers managing Sites through the Admin Console.

​Introduction to Sites

A Stratus5 Site is a running container instantiated from a selected Blueprint.

  • Deployed Instances: Each Site is a live, running application or service.
  • Blueprint-Based: Created from a specific Blueprint, inheriting its base configuration.
  • Resource Allocation: Sites have defined resources (CPU, Memory, Storage, Bandwidth).
  • Accessible: Can be accessed via defined routes (domains/subdomains).
  • Manageable: Offer features like logging, terminal access, snapshots, and resource scaling.

Sites are the core operational units within Stratus5, where your applications execute and serve users.

​Listing Sites

View all Sites running within your Workspace in the "Sites" or "Containers" section of the Admin Console. The list displays key information like name, status, and associated Blueprint, along with search and filtering options.

​Creating Sites

Deploy new Sites from the "Sites" list page:

  1. Click the "New Site" or "Add Site" button.
  2. Select the desired Blueprint to base the Site on.
  3. Configure the Site's Name and optionally adjust resource limits or other initial settings.
  4. Click the "Create Site" button to confirm deployment.

​Viewing Site Details

Inspect a Site's configuration, status, and resources by clicking its name in the Sites list. The detail page uses tabs or sections for different management areas:

  • Overview: General status, resource summary, and power actions (Start, Stop, Restart).
  • Container/Environment: Container details and environment variables.
  • Resources: View and edit CPU, Memory, Storage, and Bandwidth allocations.
  • Routes: Manage domain names pointing to the Site.
  • Logs: Access application and system logs.
  • Terminal: Open a command-line interface within the container.
  • Snapshots: Manage backups/snapshots.
  • SSH: Configure SSH access.
  • Tags: View and manage Site tags.
  • Events: View a log of recorded system actions performed on the Site (e.g., "Snapshot created", "Site started").
  • Monitoring/Insights: View performance metrics.

​Editing Site Resources & Settings

Modify a Site's resource allocation (CPU, Memory, Storage, Bandwidth) or other settings like environment variables directly from its detail page. Find the relevant section (e.g., "Resources") and use the "Edit" actions. Save any changes, noting that some may require a Site restart.

​Managing Site Power State (Start/Stop/Restart)

Control the running state of your Site using the "Start", "Stop", or "Restart" buttons available on the Site's detail page (often on the "Overview" tab) or directly from the Sites list view. Confirmation may be required.

​Accessing Logs

View your Site's application and system logs by navigating to the "Logs" tab on its detail page. Logs can typically be streamed in real-time or viewed historically, with options for filtering and searching.

​Accessing Terminal

Gain command-line access to the Site's container by selecting the "Terminal" tab on its detail page. This opens an interactive web-based terminal.

​Managing Snapshots

Manage backups (snapshots) of your Site's persistent storage from the "Snapshots" tab on its detail page:

  • Create: Use the "Create Snapshot" button.
  • List: View existing snapshots.
  • Restore: Select a snapshot and use the "Restore" action to replace the Site's data (requires confirmation and stops the Site).
  • Clone: Create a copy of an existing snapshot. This cloned snapshot can potentially be used as a base for other Blueprints or restored to different Sites (verify application workflow). It does not automatically launch a new Site.
  • Delete: Remove unwanted snapshots.

​Managing Routes

Configure domain names and paths directing traffic to your Site from the "Routes" tab on its detail page:

  • List: View existing routes.
  • Add: Click "Add Route", enter the domain/subdomain and path, configure options (e.g., HTTPS), and confirm.
  • Edit/Delete: Modify or remove existing routes using the available actions.

​Tagging Sites

Apply tags for organization or filtering from the "Tags" tab on the Site's detail page:

  • View: See currently applied tags.
  • Add: Click "New Tag", enter the tag name (and optional value), and confirm.
  • Delete: Remove tags using the delete action next to each tag.

​Deleting Sites

Permanently remove a Site by finding the "Delete" action on its detail page or the Sites list (often under an ellipsis menu). Confirm the action carefully, possibly by typing the Site's name, as this is typically irreversible.

​Transferring Sites Between Workspaces

You can move a Site from one child workspace to another (e.g., from child1.my-workspace.net to child2.my-workspace.net).

  1. Navigate to the Site's detail page.
  2. Locate and initiate the "Transfer" action (the exact location may vary).
  3. Select the target child workspace from the available options.
  4. Confirm the transfer operation. Note any potential implications, such as changes in access permissions or network configuration.
← Previous page
Product Workspace Setup
Next page →
Blueprints