Pular para o conteúdo principal

Criar Stack

Este guia apresenta como criar, configurar e gerenciar Stacks no Portal da StackSpot EDP.


Pré-requisitos

Atenção!

O nome da Stack deve ter no máximo 60 caracteres.

Como criar uma Stack

Para criar uma Stack, siga as etapas no Dashboard do seu Estúdio no Portal da StackSpot EDP.

Passo 1. Iniciar a criação da Stack

Clique em 'Criar Stack'.

Preencha os campos obrigatórios:

  • Nome da Stack: insira um nome para sua Stack.
  • Identificação (Slug): defina um slug exclusivo para a Stack. Após a publicação, o slug não pode ser alterado.
  • Descrição: descreva brevemente o objetivo da Stack.
  • Tags: adicione tags para classificar sua Stack (exemplo: Web, Infra, Back-end).
  • Logo da Stack (opcional).

É possível editar todos os campos, exceto o slug, enquanto a Stack estiver como rascunho (Draft).

Passo 2. Finalizar a criação

Revise as informações e clique em 'Criar Stack'.


Animação mostrando o fluxo para criar uma Stack no Portal StackSpot EDP.

O GIF está em inglês.


Pronto! Sua Stack foi criada.

Para documentar uma Stack ou Starter criados no Portal, é necessário gerar as pastas localmente. Veja como documentar sua Stack.

Atenção!

A Stack está criada, mas ainda não está publicada. Você precisa adicionar ao menos um Plugin ou um Starter na Stack antes de publicar. Veja as opções a seguir.

Adicionar Plugins à sua Stack

Para adicionar Plugins à Stack, siga as instruções.

Passo 1. Visualizar Plugins disponíveis

Clique na aba 'Plugins' do seu Estúdio.

Caso não tenha Plugins publicados na sua Conta, em outra Stack (com visibilidade pública) ou no seu Estúdio, siga os guias para Criar e Publicar Plugins.

Passo 2. Adicionar Plugin

Na aba 'Plugins', clique em '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 em 'Adicionar conteúdo requerido' e selecione os Plugins na aba lateral.

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

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

Clique em 'Adicionar Plugins'.

O Plugin foi adicionado à Stack. Você pode encontrá-lo no Dashboard da sua Stack.

Criar um Starter na sua Stack

Os Starters permitem definir combinações comuns de Plugins dentro da Stack, funcionando como “receitas prontas” para criação de Aplicações ou Infraestruturas com o comando stk create app.

Você pode criar um projeto que já tenha um conjunto de Plugins pré-configurados, por meio de um único comando.

Para adicionar um Starter na sua Stack, siga as etapas.

Passo 1. Acessar a aba de Starters

No Dashboard da Stack, clique na aba 'Starters'.

Passo 2. Criar o Starter

Clique em 'Criar starter'.

Passo 3. Selecionar o tipo de Starter

Selecione o tipo do Starter:

  • App Starter
  • Infra Starter

Clique em 'Próximo'.

Passo 4. Preencher informações básicas

Em 'Informações básicas', preencha:

  • 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. Adicionar Plugins ao Starter

Em 'Plugins', clique em 'Adicionar Plugins' e selecione os Plugins que você quer incluir no Starter.

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 Plugins requeridos, adicione-os na Stack e no Starter antes de continuar.

Depois de selecionar os Plugins, clique em '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. Revisar Plugins do Starter

Confira a ordem dos Plugins no Starter e clique em 'Próximo'.

Passo 7. Concluir o Starter

Em 'Resumo', confira as informações e clique em '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 as etapas.

Passo 1. Acessar a aba de Actions

Dentro da sua Stack, clique na aba 'Actions'. Depois, clique em 'Adicionar action'.

Passo 2. Selecionar Actions

Na tela exibida, você pode adicionar Actions filtrando por:

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

Passo 3. Confirmar inclusão das Actions

Depois de selecionar as Actions, clique em '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óximos Passos