Pular para o conteúdo principal

Criar Stack

Nesta seção, você encontra um guia de como criar Stacks.


Pré-requisitos

Atenção!
  • O limite do nome da Stack é de 60 caracteres.

Para criar uma Stack acesse o Dashboard do seu Estúdio no Portal da StackSpot EDP e siga os passos a seguir:

Passo 1. Clique no botão 'Criar Stack';

Selecione o Estúdio e preencha os seguintes campos:

  • Nome da Stack: adicione um nome para a sua Stack.
  • Identificação (Slug): Adicione um slug para a Stack. Depois que a Stack é publicada, este campo não pode ser alterado.
  • Descrição: descreva brevemente sobre o objetivo da sua Stack.
  • Tags: adicione as tags que classificam a sua Stack, como por exemplo: Web, Infra, Back-end etc.
  • Logo da Stack (opcional)

É possível editar os campos acima, com exceção do Slug, só enquanto a Stack está em Draft.


Passo 2. Revise as informações e clique no botão 'Criar Stack';


O GIF está em inglês.


Pronto, você criou uma Stack!

Para documentar uma Stack ou um Starter criados no Portal da StackSpot EDP, você precisa gerar pastas localmente. Para isso, siga os passos para documentar

Atenção

A primeira versão da sua Stack foi gerada, mas ainda não está publicada. Você precisa adicionar um Plugin ou um Starter na Stack. Confira as duas possibilidades:

Adicionar Plugins na sua Stack

Para visualizar os Plugins disponíveis, clique na aba 'Plugins', dentro do seu Estúdio.


Se você ainda não tem Plugins publicados na sua Conta, em outra Stack (com visibilidade pública) ou no seu Estúdio, siga os passos para Criar e Publicar um Plugin.


Passo 1. Na aba 'Plugins', clique no botão 'Adicionar Plugin';

Você pode selecionar Plugins de diferentes fontes:

  • Estúdio: Plugins disponíveis no seu Estúdio.
  • Conta: Plugins disponíveis na sua Conta.
  • Inserir um Qualifier: identifica o Plugin de forma única.
  • Escolher uma versão específica do Plugin.
Atenção!

  • Se o Plugin depender de outros Plugins, será necessário adicioná-los à Stack. Para isso, clique no botão 'Adicionar conteúdo requerido' e selecione os Plugins dentro da aba lateral da tela.

  • Caso o Plugin dependa de outro Plugin de um Estúdio diferente, você precisará de permissão para acessá-lo.

Passo 2. Escolha o range de versões do Plugin ou uma versão específica que você deseja adicionar à sua Stack.

Clique no botão 'Adicionar Plugins'.

Pronto, o Plugin foi adicionado na Stack. Você pode encontrá-lo no Dashboard da sua Stack.

Criar um Starter na sua Stack

Os Starters são úteis para que os criadores de Stack definam dentro da própria Stack combinações comuns de Plugins, e definam "receitas prontas" para as combinações mais comuns dentro da Stack. Nele, você consegue adicionar quantos Plugins quiser.

Um Starter funciona como uma "receita pronta" porque já possui um conjunto de Plugins predefinidos e configurados, mas isso acontece somente quando você executa o comando stk create app.

Você pode criar um projeto que já tem um conjunto de Plugins, através de um único comando.

Para adicionar um Starter na sua Stack, siga os passos a seguir:

Passo 1. No Dashboard da sua Stack, clique na aba 'Starters';

Passo 2. Clique no botão 'Criar starter';

Passo 3. Selecione o tipo do Starter: App Starter ou Infra Starter e, em seguida, clique no botão 'Próximo';

Passo 4. Em 'Informações básicas' preencha as seguintes informações:

  • Slug (Nome do starter): adicione um nome para o seu Starter.
  • Descrição: descreva o objetivo do seu Starter.

Clique em 'Próximo'.

Passo 5. Em 'Plugins', adicione os Plugins que você quer incluir no Starter. Para isso, clique no botão 'Adicionar Plugins';

Você pode selecionar Plugins que estão no Estúdio, na Conta ou Inserir um Qualifier.


Dica!

Se um Plugin que será adicionado ao Starter tiver outros Plugins requeridos, você precisará adicioná-los na Stack e no Starter antes de continuar.

Depois de selecionar os Plugins, clique no botão 'Adicionar Plugins'.

Atenção!

Confira a ordem em que os Plugins são adicionados ao Starter, pois isso determina a sequência de aplicação durante a criação de uma Aplicação ou Infraestrutura.

  • Essa ordem só pode ser ajustada enquanto a Stack estiver no estado Draft.
  • Para Plugins com dependências, adicione primeiro os menos dependentes e, em seguida, os que dependem deles.

Passo 6. Confira a ordem dos Plugins no Starter e clique no botão 'Próximo'.

Passo 7 Em 'Resumo', confira as informações e clique no botão 'Concluir'.

Pronto, você adicionou um Starter na sua Stack.

Adicionar Actions na Stack

Atenção!

Para adicionar Actions na Stack você precisa ter uma Action criada e publicada.

Para adicionar uma ou mais Actions na sua Stack, siga os passos a seguir:

Passo 1. Dentro da sua Stack, clique na aba 'Actions'. Em seguida, clique no botão 'Adicionar action';

Passo 2. Na tela exibida, você pode adicionar as Actions que estão com o filtro:

  • 'Disponível no Estúdio'
  • Actions da conta
  • 'Inserir Qualifier';

Passo 3. Depois de selecionar as Actions, clique no botão 'Adicionar Action'.

Se uma Action for requerida por um Plugin na Stack, você precisará adicioná-la na Stack antes de continuar.

Pronto, você adicionou Actions na sua Stack.

Dica!

Você somente pode usar a sua Stack depois de adicioná-la ao Workspace.

Próximo passos

  • Clique no botão 'Publicar' para tornar sua Stack disponível no seu Estúdio. Siga os passos no guia Publicar sua Stack.

Para adições, alterações ou exclusões, publique uma nova versão da sua Stack.

Plugins

Actions