Pular para o conteúdo principal

Criar Aplicação via STK CLI

Visão Geral

Na StackSpot, uma Aplicação é qualquer código fonte que implementa regras de negócio, trechos de código como classes, métodos e importações de bibliotecas ou um código de uma Aplicação minimamente funcional. As Aplicações são desenvolvidas dentro dos Workspaces, utilizando ferramentas como Plugins, Stacks, Starters ou os Workflows disponíveis, que tornam o desenvolvimento e a entrega de soluções mais rápidos e simples.

Na StackSpot, você pode criar Aplicações de duas formas:

Para criar uma Aplicação, é necessário utilizar uma Stack e um Starter ou um Workflow.

A seguir, você confere o passo a passo para criar Aplicações pelo STK CLI utilizando Workflows.

Pré-requisitos


Cuidado!

Se você não atender a algum dos pré-requisitos mencionados, pause este guia e acesse o link correspondente ao requisito pendente para resolvê-lo antes de continuar.


Passo a Passo para Criar Aplicação pelo STK CLI com um Workflow

Passo 1. No seu terminal, selecione o Workspace que você quer utilizar para criar a Aplicação. Execute o comando:


stk use workspace

Os Workspaces da sua conta serão listados no terminal. Selecione o Workspace e pressione Enter.

Dica!

Confira a lista de Workspaces disponíveis pelo seu terminal, execute o comando stk list workspace. O Workspace que você está tem um asterisco.

Você também pode conferir no Portal da StackSpot na seção de 'Workspaces'.

Passo 2. Para criar a Aplicação, execute o comando:

Dica!

Para os nomes de Estúdio, Stack, e Workflow. Use sempre o slug, o slug é o nome que está registrado no Portal da StackSpot EDP. Pode ocorrer do nome utilizado ter alguma diferença do nome registrado no Portal, o que pode causar erros ao criar a Aplicação pelo STK CLI.

stk create app [NOME-APP] --workflow [NOME-ESTUDIO(slug)/NOME-STACK(slug)/NOME-WORKFLOW(slug)]

Exemplo:

stk create app app-com-workflow --workflow nome-stack/nome-estudio/nome-workflow-create-app
Atenção!
  • Se o argumento --workflow for fornecido, a CLI executará o Workflow especificado do tipo create ou starter.
  • O Workflow será responsável por todas as etapas, incluindo aplicação de Plugins, configuração de inputs e qualquer lógica adicional definida no Workflow.
  • Caso ambos os argumentos --starter e --workflow sejam fornecidos, a CLI retornará um erro, pois eles são mutuamente exclusivos.

Responda às perguntas do Workflow no terminal e sua Aplicação será criada.

Dica!

Se você quiser nomear a Aplicação com um nome diferente da pasta (diretório), use o parâmetro --target ou -o.

Confira um exemplo de como o comando deveria ficar a seguir:

stk create app app-com-workflow --workflow nome-stack/nome-estudio/nome-workflow-create-app --target home/user/Applications/my-app

Passo 3. Agora, registre sua Aplicação na conta. Para isso, primeiro acesse o diretório da Aplicação:

cd <nome-da-aplicação>

Em seguida execute o comando para registrar:

stk register app

Responda as perguntas:

  • URL do repositório: Informe o repositório que irá armazenar o código da sua aplicação;
  • Base branch: Informe a branch para ser utilizada no repositório.

Agora você pode conferir os dados da sua Aplicação dentro do seu Workspace no portal da StackSpot na seção 'Aplicações' e a execução do Workflow na seção Atividades.

Pronto, você criou e registrou sua Aplicação!

Cuidado!