Criar Stack
Nesta seção, você encontra um guia de como criar Stacks.
Pré-requisitos
- Estar dentro de um Estúdio.
- Ter feito login no Portal da StackSpot EDP.
- 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
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.
Dentro de cada tipo de Plugin é possível selecionar Plugins que estão:
- No seu Estúdio
- Na sua Conta
- Inserir um Qualifier
- E uma versão específica do Plugin.
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. Ainda dentro da aba 'Plugins', clique no botão 'Adicionar Plugin';
Dentro de cada tipo de Plugin é possível selecionar Plugins que estão:
- No seu Estúdio
- Na sua Conta
- Inserir um Qualifier
-
Se um Plugin tiver outros Plugins requeridos, você precisará adicioná-los na Stack. Para isso, clique no botão 'Adicionar conteúdo requerido' e selecione os Plugins dentro da aba lateral direita da tela.
-
É possível um Plugin requerer outro de um Estúdio diferente, mas você precisa ter permissão para acessar o Estúdio em questão.
Passo 2. Na página exibida, escolha o range de versões do Plugin ou uma versão específica que você quer adicionar à sua Stack.
Depois disso, 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.
Starter é como uma "receita pronta", porque traz as especificações do conjunto de Plugins já predefinidas e aplicadas, 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 ou Infra 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.
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'.
Verifique a ordem que os Plugins são adicionados ao Starter. Isso define a ordem de aplicação dos Plugins durante a criação de uma Aplicação e Infraestrutura e só pode ser alterada enquanto a Stack está em
Draft
. No caso de Plugins que têm outros Plugins requeridos, os menos dependentes vêm primeiro na ordenação e os que dependem deles vêm depois.
Passo 4. Confira a ordem dos Plugins no Starter e clique no botão 'Próximo'.
Passo 5 Em 'Resumo', confira as informações e clique no botão 'Concluir'.
Pronto, você adicionou um Starter na sua Stack.
Adicionar Actions na Stack
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 e '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.
Você somente pode usar a sua Stack depois de adicioná-la ao Workspace.