Skip to main content

Version, Deprecate or Delete Stack

In this section, you will find a guide on how to version, deprecate, or delete a Stack on the StackSpot Portal.


Version a Stack

In StackSpot, you use Semantic Versioning for Stacks. When you create a new version, you make a copy of a published version.

Semantic versioning allows each Stack version to evolve independently. For example, you can have a "Web" Stack in version 1.0.0 with Angular v13 and another "Web" Stack in version 2.0.0 with Angular v14. Each version can evolve separately, with increments like 1.0.1, 1.0.2, 2.0.1, 2.1.0, and so on.

When publishing a new Stack version, you need to:

  • Indicate the base version for the new version.
  • Specify the type of modification.

The version types are:

  • PATCH (correction): Fixes errors without impacting services, contracts, APIs, or interfaces. It increments the last position of the semantic number. Example: copying version 1.0.2 generates version 1.0.3.
  • MINOR: Adds features without affecting compatibility with previous versions. It increments the middle position and sets PATCH to zero. Example: copying version 1.0.2 generates version 1.1.0.
  • MAJOR: Introduces changes that are not backward-compatible. It increments the first position and sets both PATCH and MINOR to zero. Example: copying version 1.0.2 generates version 2.0.0.
  • CUSTOMIZABLE: You choose the version number, as long as it does not already exist. Example: copying version 1.0.2 can generate version 1.5.0.
info

If you created a Stack but have not published any version (the Stack is in Draft), you can delete it. Deleting the Draft version will also remove the Stack.

To create a version of your Stack, follow these steps:

Step 1. In the 'Overview' section of your Stack, click the 'New Version' button.

Step 2. Select the version you want to copy and click 'Create new version'.

Step 3. The new version is now in draft. To publish it, click 'Publish'.

Step 4. In the displayed modal, choose the version type and version number. The available types are:

  • Major: New Stack evolution, not compatible with previous versions.
  • Minor: Improvement or new feature, maintaining compatibility.
  • Patch: Bug fixes or improvements without impacting functionality.
  • Customizable: Manually set the semantic version number.

Click 'Publish new Stack version'.

GIF showing the process of publishing a new Stack version. The GIF content is in English.

You have created a new version of the Stack. The Stack is still in Draft. To publish it, add a Plugin and/or a Starter. See the links below for more details:

After publishing the new version, select which Stack version you want to use by choosing it in the Stack Dashboard.

danger

You cannot have more than one version of the same Stack in Draft.

You can check the Stack version on the published page in the Studio.

info

After you publish a Stack version, you cannot edit it. You can only add or remove content while the version is in Draft.

Deprecate a Stack

tip

For more information, see the deprecation rules.

You can deprecate a published Stack version in a Studio or Workspace. Follow these rules:

  1. You must have permission to deprecate content.
  2. You must belong to the Studio where the Stack version will be deprecated.

To deprecate a version of your Stack, follow these steps:

Step 1. In the Studio, click the 'Stacks' section.

Step 2. Click 'Manage Version'.

Step 3. In 'Version Management', under the 'Active' tab, click 'More options'.

Step 4. Click 'Deprecate version'.

Step 5. On the displayed screen, select a reason for deprecation:

  • Lack of maintenance
  • Lack of security
  • Bugs
  • Other

Step 6. To confirm, type "DEPRECATE" and click 'Deprecate Version'.

You have deprecated the Stack version.

GIF showing the process of deprecating a Stack version. The GIF content is in English.

Delete a Version

tip

For more information, see the deletion rules.

You can delete only Stack versions that are in Draft. To delete, follow these rules:

  1. The Stack must not be in use or associated with any Plugin, Starter, Workspace, or Studio in StackSpot.
  2. You must have permission to remove content.
danger

Deleting a version is permanent and cannot be rolled back. To restore, you must create and publish a new version.

To delete a Stack version, follow these steps:

Step 1. In the Studio, click the 'Stacks' section.

Step 2. Click 'Manage Version'.

Step 3. In 'Version Management', under the 'Active' tab, click 'More options'.

Step 4. Click 'Delete version'.

Step 5. To confirm, type "DELETE" and click 'Delete Version'.

Then, click 'Delete Stack' to remove the Stack.

You have deleted a version of the Stack.