Pular para o conteúdo principal

Versionar, Depreciar ou Deletar Stack

Nesta seção, você encontra um guia sobre como versionar, depreciar ou deletar uma Stack no Portal da StackSpot.


Versionar uma Stack

Na StackSpot, você pode aplicar o Versionamento Semântico em Stacks. Ao criar uma nova versão, você faz uma cópia de uma versão publicada.

O versionamento semântico permite que diferentes versões de uma Stack evoluam de forma independente. Por exemplo, você pode ter uma Stack "Web" na versão 1.0.0 com Angular v13 e outra Stack "Web" na versão 2.0.0 com Angular v14. Cada versão pode evoluir separadamente, com incrementos como 1.0.1, 1.0.2, 2.0.1, 2.1.0 e assim por diante.

Ao publicar uma nova versão da Stack, você precisa:

  • Indicar a versão base para a nova versão.
  • Informar o tipo de modificação.

Os tipos de versão são:

  • PATCH (correção): Corrige erros sem impactar serviços, contratos, APIs ou interfaces. O incremento ocorre na última casa do número semântico. Exemplo: copiar a versão 1.0.2 gera a versão 1.0.3.
  • MINOR (menor): Adiciona funcionalidades sem afetar a compatibilidade com versões anteriores. O incremento é na casa intermediária e o PATCH é zerado. Exemplo: copiar a versão 1.0.2 gera a versão 1.1.0.
  • MAJOR (maior): Introduz mudanças incompatíveis com versões anteriores. O incremento é na primeira casa e tanto o PATCH quanto o MINOR são zerados. Exemplo: copiar a versão 1.0.2 gera a versão 2.0.0.
  • PERSONALIZÁVEL: Você escolhe o número da versão, desde que não exista uma versão igual. Exemplo: copiar a versão 1.0.2 pode gerar a versão 1.5.0.
Informação Adicional

Se você criou uma Stack, mas não publicou nenhuma versão (a Stack está em Draft), é possível apagá-la. Ao apagar a versão Draft, a Stack também será removida.

Para criar uma versão da sua Stack, siga os passos:

Passo 1. Na seção 'Visão Geral' da Stack, clique no botão 'Nova Versão'.

Passo 2. Selecione a versão que será copiada e clique em 'Criar nova versão'.

Passo 3. A nova versão ficará em rascunho. Para publicá-la, clique em 'Publicar'.

Passo 4. No modal exibido, escolha o tipo da versão e o número da versão. Os tipos disponíveis são:

  • Principal: Nova evolução da Stack, sem compatibilidade com versões anteriores.
  • Minor: Melhoria ou novo recurso, mantendo compatibilidade.
  • Correção: Correções de erro ou melhorias sem impacto na funcionalidade.
  • Personalizado: Defina manualmente o número da versão semântica.

Clique em 'Publicar nova versão de Stack'.

GIF demonstrando o processo de publicação de uma nova versão de Stack. O conteúdo do GIF está em inglês.

Pronto, você criou uma nova versão da Stack. A Stack ainda está em Draft. Para publicá-la, adicione um Plugin e/ou um Starter. Consulte os links abaixo para saber mais:

Após publicar a nova versão, escolha qual versão da Stack utilizar. Basta selecioná-la no Dashboard da Stack.

Atenção!

Você não pode ter mais de uma versão da mesma Stack em Draft.

Você pode conferir a versão de uma Stack na página publicada no Estúdio.

Informação Adicional

Após a publicação da versão, não é possível editá-la. Só é possível adicionar ou remover conteúdo enquanto a versão está em Draft.

Depreciar uma Stack

Dica!

Para mais informações, acesse as regras de depreciação.

Você pode depreciar uma versão publicada de Stack em um Estúdio ou Workspace. Para isso, siga as regras:

  1. Tenha permissão para depreciar conteúdo.
  2. Você deve pertencer ao Estúdio onde a versão da Stack será descontinuada.

Para depreciar uma versão da sua Stack, siga os passos:

Passo 1. No Estúdio, clique na seção 'Stacks'.

Passo 2. Clique em 'Gerenciar Versão'.

Passo 3. Em 'Gerenciamento de versão', na aba 'Ativa', clique em 'Mais opções'.

Passo 4. Clique em 'Depreciar versão'.

Passo 5. Na tela exibida, selecione um motivo para a depreciação:

  • Falta de manutenção
  • Falta de segurança
  • Bugs
  • Outros

Passo 6. Para confirmar, digite "DEPRECIAR" e clique em 'Depreciar Versão'.

Você depreciou a versão da Stack.

GIF demonstrando o processo de depreciação de uma versão da Stack. O conteúdo do GIF está em inglês.

Deletar uma versão

Dica!

Para mais informações, acesse as regras de deleção.

Você pode deletar apenas versões de Stack que estejam em Draft. Para deletar, siga as regras:

  1. A Stack não pode estar em uso ou associada a nenhum Plugin, Starter, Workspace ou Estúdio da StackSpot.
  2. Tenha perfil com permissão de remoção de conteúdo.
Atenção!

A remoção de uma versão é definitiva e não tem rollback. Para restaurar, crie e publique uma nova versão.

Para deletar uma versão da Stack, siga os passos:

Passo 1. No Estúdio, clique na seção 'Stacks'.

Passo 2. Clique em 'Gerenciar Versão'.

Passo 3. Em 'Gerenciamento de versão', na aba 'Ativa', clique em 'Mais opções'.

Passo 4. Clique em 'Deletar versão'.

Passo 5. Para confirmar, digite "DELETAR" e clique em 'Deletar Versão'.

Depois, clique em 'Deletar Stack' para remover a Stack.

Pronto, você deletou uma versão da Stack.