Criar Stack
Nesta seção, você encontra um guia de como criar Stacks.
Pré-requisitos
- Estar dentro de um Estúdio.
- Ter feito login na plataforma da StackSpot.
- O limite do nome da Stack é de 60 caracteres.
Para criar uma Stack acesse o Dashboard do seu Estúdio na plataforma da StackSpot e siga os passos:
Passo 1. Clicar no botão 'Criar > Stack', no canto superior direito da tela.
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.
É possível editar os campos acima, com exceção do Slug, só enquanto a Stack está em Draft.
É opcional adicionar uma logo para a Stack.
Passo 2. Revise as informações e clique no botão 'Criar';
Pronto! Você criou uma Stack!
Para documentar uma Stack ou um Starter criados pela Plataforma da StackSpot, 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', selecione o tipo de Plugin que você quer adicionar à sua Stack:
- Aplicação (App)
- Infraestrutura (Infra)
-
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. Clique no botão 'Adicionar Plugins' e, em seguida, escolha entre 'App Plugin' ou 'Infra Plugin'.
Passo 3. Na aba lateral direita da página, será exibida uma página para você selecionar quais Plugins você quer adicionar. Escolha o range de versões dos Plugins que você quer adicionar à sua Stack.
Depois disso, clique no botão 'Adicionar Plugins na Stack'.
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:
Passo 1. No Dashboard da sua Stack, clique no botão 'Criar um novo starter';
Passo 2. Selecione o tipo do Starter: App ou Infra. Em 'Starter info' preencha as seguintes informações:
- Slug (Nome do starter): adicione um nome para o seu Starter.
- Descrição: descreva brevemente sobre o seu Starter.
Confira um exemplo:
Gif está em inglês.
Clique em 'Próximo'.
Passo 3. Em 'Adicionar Plugins', adicione os Plugins que você quer incluir no Starter.
Você pode selecionar Plugins que estão no Estúdio e na Conta.
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 no Starter'.
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 Revise as informações do Starter na parte de 'Review' e clique em '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:
Passo 1. Dentro da sua Stack, clique na subseção 'Actions'. Em seguida, clique no botão 'Adicionar action', no canto direito da tela;
Passo 2. Na tela que será exibida no lado direto, você pode adicionar as Actions que estão com o filtro 'Disponível no Estúdio' e 'Explore';
Dentro da aba 'Explore', você pode agrupar as Actions por Estúdio e escolher o range de versões das Actions que você quer adicionar à sua Stack.
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.
Adicionar Links na Stack
Você pode adicionar Links úteis na sua Stack para redirecionar para ambientes externos.
Podem ser adicionados de duas formas:
-
Links de Plugins: Ao criar Plugins, você pode adicionar Links neles. Quando você cria uma Stack e adiciona um Plugin com link, eles não poderão ser editados ou excluídos da sua Stack.
-
Adicionar Links diretamente na Stack: Você pode adicionar Links na Stack e não podem ser alterados depois de serem adicionados. Mas quando você editar a Stack, é preciso publicar uma nova versão da Stack.
Siga os passos para adicionar um Link na sua Stack:
Acesse o Dashboard do seu Estúdio na plataforma da StackSpot.
Passo 1. Acesse a Stack que você deseja adicionar um Link.
Passo 2. Dentro dela, clique na subseção 'Links'. Em seguida, clique no botão 'Adicionar Link', no canto esquerdo da tela;
Se o Plugin que você adicionou na sua Stack tem Links, você verá nesta tela.
Passo 3. Preencha os campos com as seguintes informações, confira o exemplo:
- Nome do link: Service Now
- URL:
https://www.servicenow.com.br
- Logo: Uma imagem demonstrativa. É opcional
Passo 4. Clique no botão 'Adicionar Link';
Pronto! Você adicionou um Link à sua Stack.
Se você adicionar, alterar um Link ou excluí-lo, você precisa publicar uma nova versão da sua Stack.