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 Portal.


Version a Stack

In StackSpot, you can employ Semantic Versioning for Stacks. When creating a new version, select whether it's a copy of a published version.

Semantic versioning allows for independent evolution. For instance, a "Web" Stack in version 1.0.0 with Angular v13 can exist alongside another "Web" Stack in version 2.0.0 with Angular v14. Each version can progress independently, accommodating increments like 1.0.1, 1.0.2, 2.0.1, 2.1.0, etc.

When publishing a new Stack version, state the base version and specify the type of modification:

  • PATCH (correction): Fixes errors without impacting services, contracts, APIs, or interfaces. It increments the last part of the semantic number (e.g., copying 1.0.2 generates version 1.0.3).

  • The copy of 1.0.2 Stack version generates the 1.0.3 version.

  • MINOR: Evolves features without affecting compatibility with the previous version. Increment the middle part of the semantic number and set PATCH to zero (e.g., copying 1.0.2 generates version 1.1.0).

For example:

  • The Stack copy of the 1.0.2 version will generate the 1.1.0 version.

  • MAJOR: Introduces a new change with no backward compatibility. Contracts change, requiring users to adapt their code. Increment the first part of the semantic number and set PATCH and MINOR to zero.

For example:

  • The Stack copying 1.0.2 version generates the 2.0.0.

  • CUSTOMIZABLE: Choose the version to generate, ensuring no duplicates. For example:

  • The copy of the Stack 1.0.2 version can generate 1.5.0. version.

info
  • If your Stack is still in draft, delete it before publishing to avoid duplication.
caution

Ensure your Team is associated with the Studio containing the Stack; otherwise, you won't have permission to perform actions.

To create a version of your Stack, follow the steps below:

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

Step 2: Select the version to copy and click 'Create new version';

Step 3. The new version is in draft. To publish, click on the 'Publish' button;

Step 4. In the modal displayed at the center of the screen, choose the version type and the version number you want to create. The version type can be:

  • Major: New Stack evolution, no compatibility with other versions.
  • Minor: Adds new improvements with compatibility with other versions.
  • Patch: Fixes bugs or improves performance without altering the Stack’s functionality.
  • Customizable: The user selects the semantic version.

Click on the 'Publish new Stack version' button.

You published a new version of your Stack. Now, the Stack is still in draft. You need to add a Plugin and a Starter to Publish it. See it below:

After publishing the new version of your Stack, you can choose which version you want to use. To do this, select it in the Stack Dashboard.

danger

Drafting more than one version of the same Stack is impossible.

Check the version on the Studio's published page.

info

After publishing a Stack version, you can't edit it. You can only add or remove content while in Draft.

Deprecate a version

tip

For more information, access the deprecation rules page.

Deprecate a published Stack version in a Studio or Workspace by following these rules:

  1. You must have permission to deprecate content;
  2. You must belong to the Studio where the Stack version is.

To deprecate a version of your Stack, follow the steps below:

Step 1. Go to your Studio and click on the 'Stacks' section;

Step 2. Click on the 'Manage Version' button;

Step 3. In the 'Version Management' section, go to the 'Active' tab and click on the 'More options' button;

Step 4. Click on the 'Deprecate version' button;

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

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

Step 6. To confirm, type the word "DEPRECATE". Then click on the 'Deprecate version' button.

You have deprecated a version of a Stack.

Delete a version

tip

For more information, access the deletion rules page.

You can delete a version of a Stack in draft. To delete it, you need to follow the rules below:

  1. The Stack must not be in use or connected to any StackSpot space: Plugin, Starter, Workspace, or Studio;

  2. You need permission to remove content. Check Roles & Permissions.

info

You cannot roll back a version you remove. After deleting a version, you have to create a new one and publish it again.

To delete a version of your Stack, follow the steps below:

Step 1. Inside your Studio, click on the 'Stacks' section;

Step 2. Then, click on the 'Manage Version' button;

Step 3. In 'Version Management', navigate to the 'Active' tab and click on the 'More options' button;

Step 4. Click on the 'Delete version' button;

Step 5. To confirm, type the word "DELETE" and then click on the 'Delete Version' button.

Now, click on the 'Delete Stack' button.

You deleted a version of the Stack.