Skip to content

Commit

Permalink
Stack list content
Browse files Browse the repository at this point in the history
  • Loading branch information
jakubabrzy committed Dec 17, 2024
1 parent 46deb8d commit 87f70ee
Show file tree
Hide file tree
Showing 8 changed files with 8 additions and 12 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/screenshots/stack/list/page-view.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/concepts/stack/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ _Stack_ is one of the core concepts in Spacelift. A stack is an isolated, indepe

Unless you're using Spacelift only to host and test private [Terraform modules](../../vendors/terraform/module-registry.md), your account should probably contain one or more stacks to be of any use. For example:

![](<../../assets/screenshots/Screen Shot 2022-06-29 at 2.47.11 PM.png>)
![](<../../assets/screenshots/stack/list/page-view.png>)

Here's a few helpful articles about stacks:

Expand All @@ -18,6 +18,6 @@ Similar to [runs](../run/README.md) and [tasks](../run/task.md), stacks also hav
A stack's state is the last state of its most recently processed [tracked run](../run/README.md#where-do-runs-come-from) that has progressed beyond the [queued](../run/README.md#queued) state and which was not [canceled](../run/README.md#canceled).
Only if the stack has no runs yet a special state "None" is applied:

![](<../../assets/screenshots/Stacks_·_spacelift-io (1).png>)
![](<../../assets/screenshots/stack/list/none-state-item.png>)

Stack states allow users to see at a glance the overall health of their infrastructure, and the level of development activity associated with it.
16 changes: 6 additions & 10 deletions docs/concepts/stack/organizing-stacks.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,39 +10,35 @@ Depending on the complexity of your infrastructure, the size of your team, your

Historically the first tool we offered was the search bar:

![](../../assets/screenshots/Screen Shot 2022-06-29 at 3.06.42 PM.png)
![](../../assets/screenshots/stack/list/search-highlight.png)

The search bar allows you to search and filter by the following stack properties:

- name;
- ID (slug);
- any of its [labels](stack-settings.md#labels);

Note how the search phrase is highlighted, and irrelevant stacks are filtered out:
## Filtering by state

![](<../../assets/screenshots/Screen Shot 2022-06-29 at 3.07.29 PM.png>)
Filtering stacks by state is a very useful mechanism for identifying action items like plans pending confirmation ([unconfirmed](../run/tracked.md#unconfirmed) state) or [failed](../run/README.md#failed) jobs that require fixing. For that, use the _State_ section on the sidebar to the left. If you click on any of the statuses, the list of stacks will be filtered to only include stacks with a given status:

## Filtering by status

Filtering stacks by status is a very useful mechanism for identifying action items like plans pending confirmation ([unconfirmed](../run/tracked.md#unconfirmed) state) or [failed](../run/README.md#failed) jobs that require fixing. For that, use the _Filter stacks by status_ section on the sidebar to the left. If you click on any of the statuses, the list of stacks will be filtered to only include stacks with a given status:

![](<../../assets/screenshots/Screen Shot 2022-06-29 at 3.09.29 PM.png>)
![](<../../assets/screenshots/stack/list/finished-filter.png>)

Note that if no stacks in the account have a particular status at the moment, that status is missing from the list.

## Label-based folders

Probably the most useful way of grouping stacks is by attaching folder labels to them. You can read more about [labels](stack-settings.md#labels) here, including how to set them, and folder labels are just regular labels, prefixed with `folder:`. In order to make it more obvious in the GUI and save some screen real estate, we replace the `folder:` prefix by the folder icon...

![](<../../assets/screenshots/Screen Shot 2022-06-29 at 5.21.20 PM.png>)
![](<../../assets/screenshots/stack/list/labels-folders-highlight.png>)

...but once you start editing labels, the magic is gone:

![](../../assets/screenshots/stack/settings/stack-details_set-folder-label.png)

For every folder label, a sidebar section is included in the _Folders_ menu, allowing you to search by that label. The number to the right hand side indicates that number of stacks with that label:

![](<../../assets/screenshots/Screen Shot 2022-06-29 at 5.24.06 PM.png>)
![](<../../assets/screenshots/stack/list/folder-section-highlight.png>)

### Nesting and multiple folder labels

Expand Down

0 comments on commit 87f70ee

Please sign in to comment.