Pular para o conteúdo principal

Criar Aplicação via Portal

Confira como criar uma Aplicação utilizando um Workflow no Portal da StackSpot EDP.

Visão Geral

Na StackSpot, uma Aplicação é qualquer código fonte que implementa regras de negócio ou infraestrutura como código (IaC). IaC significa Infrastructure as Code, e se refere ao gerenciamento e provisionamento de recursos em nuvem por meio de código.

As Aplicações são desenvolvidas dentro dos Workspaces, utilizando ferramentas como Plugins, Stacks, Starters ou Workflows disponíveis. Essas ferramentas tornam o desenvolvimento e a entrega de soluções mais rápidos e simples.

Por exemplo, em um banco, uma Aplicação pode ser um sistema para gerenciar contas correntes, incluindo funcionalidades como consulta de saldo, transferências, emissão de extratos e pagamento de boletos. Essa abordagem garante uma experiência completa e eficiente para as pessoas clientes.

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

  • STK CLI
  • Portal StackSpot EDP

Para criar uma Aplicação, utilize uma Stack em conjunto com um Starter ou um Workflow.

Atenção!

Não é possível criar uma Aplicação utilizando um Starter depreciado.

A seguir, confira o passo a passo para criar Aplicações no Portal utilizando Workflows.

Pré-Requisitos

Atenção!

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

Criar Aplicação pelo Portal da StackSpot

Siga os passos abaixo:

Passo 1. Faça login no Portal StackSpot EDP.

Passo 2. Selecione o botão ‘Criar’ e escolha a opção ‘Aplicação’.

Atenção!
  • Se a pessoa administradora da sua conta não configurou o SCM (Source Code Management), não será possível continuar. Para mais informações, veja a seção de configuração do SCM.
  • Se a pessoa administradora definiu que cada usuário deve gerenciar o acesso ao SCM via PAT (Personal Access Token), você precisa configurá-lo em Conexões Externas.

Passo 3. Escolha o Workspace onde deseja criar a Aplicação.

Passo 4. Em seguida:

  • Selecione uma Stack para criar a Aplicação.
  • Escolha a versão da Stack.
  • Em Selecione um Starter, é possível escolher entre Starters ou Workflows. Para utilizar um Workflow, escolha as opções identificadas com "Criando App com".

Tela exibindo a seleção de Workflow durante a criação da aplicação

Passo 5. Na tela Detalhes da Aplicação, preencha as informações da sua Aplicação:

  • Nome: limite de 60 caracteres.
  • Descrição: insira uma breve descrição sobre a Aplicação.

Selecione o botão ‘Próximo’.

Passo 6. Na tela Configurações, preencha todos os campos do formulário. Os campos podem variar de acordo com o Workflow selecionado.

Selecione o botão ‘Próximo’.

Atenção!
  • Durante a criação de uma Aplicação via Workflow, não é possível adicionar novos Plugins à Aplicação. Após a criação, você pode adicionar e aplicar Plugins.
  • Em caso de dúvidas, consulte a documentação da Stack, Starter ou Workflow utilizado.
  • Se existirem contextos já configurados, algumas ou todas as variáveis podem ser preenchidas automaticamente. Você não poderá editar variáveis obrigatórias.

Passo 6.1 (Opcional) Se você configurou uma Extensão no arquivo workflow.yaml e selecionou um Starter que possui Workflow do tipo create, preencha os campos referentes à Extensão que deseja adicionar à Aplicação.

Passo 7. Revise as informações da sua Aplicação. Se necessário, selecione o botão ‘Editar’ para realizar ajustes.

Passo 8. Selecione o botão ‘Executar’ para enviar a Aplicação para o repositório.

Pronto! Sua Aplicação foi criada pelo Portal StackSpot EDP.

Informação Adicional

Acompanhar a Execução do Workflow de Criação da Aplicação

Após selecionar ‘Executar’, você será direcionado para a tela de acompanhamento do Workflow de criação da Aplicação. Nessa tela, é possível visualizar e monitorar todos os jobs e steps do Workflow diretamente na plataforma.

Tela exibindo os passos do Workflow de criação da aplicação

  • Os jobs e steps são interativos.
  • Para acessar os logs, selecione "View log" no respectivo step do Workflow.

Aprovação de Steps do Workflow

Alguns Workflows incluem steps de aprovação, que precisam ser aceitos para que o deploy da Aplicação prossiga. Esses steps aparecem na tela de acompanhamento do Workflow com status como "Check Approval" ou "Approval Response".

Tela mostrando o passo de aprovação destacado no Workflow de criação da aplicação

Como Realizar a Aprovação

A aprovação deve ser feita por uma pessoa com permissão de aprovação no Workspace. Essa pessoa precisa acessar a tela de acompanhamento do Workflow da Aplicação e aceitar os steps de aprovação necessários.

Informação Adicional

Um Workflow pode conter múltiplos steps de aprovação. Cada step deve ser aceito individualmente para que o Workflow avance para as próximas etapas.

Detalhes da Execução

Após criar a Aplicação, é possível acompanhar a execução dos steps do Workflow de forma visual. Além da visualização dos steps, uma seção chamada Detalhes da execução exibe as etapas realizadas no Workflow, por exemplo:

  • Baixando CLI
  • Instalando CLI
  • Executando login na StackSpot

Se algum step do Workflow for pausado, a execução é interrompida e retomada após a aprovação, mostrando novamente os detalhes. Quando a criação da Aplicação for concluída, a seção Detalhes da execução será fechada automaticamente.

Próximos Passos