Nesta seção, você encontra: Referência das novas features da StackSpot & alterações relevantes na documentação.

Features

O que há de novo?

• Novo Menu na documentação. A nova atualização da seção Criar e Usar Conteúdo, a seção Guias foi reorganizada para as seguintes seções:

Em Criar Conteúdo:

• Plugin
• Stack
• Action

Em Usar Conteúdo:

• Aplicação

• Infraestrutura

• Nova seção Exemplos

• Plugin opcional no Starter: a StackSpot traz a possibilidade de tornar um Plugin opcional no Starter e impossibilita a publicação de uma Stack com um Starter vazio (sem Plugins). Confira as páginas de Criar Stack e Criar Starter para saber mais.

STK CLI

• Novos manifestos adicionados:

  • Stack.yaml
  • Starter.yaml

• Adição do arquivo .stkignore para ignorar a publicação de arquivos do seu projeto na StackSpot sem comprometer o versionamento dos arquivos no Git.

• Novos inputs StackSpot adicionados, são variáveis específicas da StackSpot que são utilizadas como valores de entrada para seus Plugins.

• Novo comando stk notify, para melhorar a experiência ao realizar deploys sem o StackSpot Runtime.

• Novas flags --output e --only-code para o comando stk ai, agora é possível obter um código do prompt sem comentários e salvá-lo em um arquivo

Melhorias e Correções

• Melhoria na usabilidade do Portal da StackSpot: o Portal da StackSpot passou por mudanças e melhorias, como a alteração da localização de botões e seções em Estúdios, Workspaces e Contas.

• Atualização da role de Runtime para configurar uma Conta AWS no seu Workspace e depreciação da antiga role.

Nesta seção, você encontra: Referência das novas features da StackSpot & alterações relevantes na documentação.

Features

O que há de novo?

• Novo comando stk show me do STK CLI que permite obter diretamente no terminal os dados da sua Conta StackSpot.

• Novas variáveis stk adicionadas. Elas funcionam como valores para os inputs e podem conter diversas informações sobre a conta, Workspace, Estúdio, Stack entre outras durante o uso de Plugins e criação de Aplicações.

• Novo modelo de Gerenciamento de Acessos: agora são utilizados os sistemas Policy-Based Access Control (PBAC - Controle de Acesso baseado em Políticas), Attribute-Based Access Control (ABAC - Controle de acesso baseado em atributos) e Role-Based Access Control (RBAC - Controle de acessos baseado em papéis) para criar uma estrutura de controle de acessos poderosa e flexível.

Para conhecer o novo modelo de gerenciamento de acessos, papéis e permissões das contas StackSpot, confira a seção Gerenciamento de Acessos.

• Guia de migração de Gerenciamento de acessos: A StackSpot está em processo de migração do modelo de gestão de acessos, papéis e permissões.

O modelo novo será implementado em todas as contas até o dia 02/02/2024. para auxiliar você a entender as mudança, foi criado um guia que explica as diferenças entre o modelo em depreciação e o atual.

Melhorias e Correções

• O nome do alias ao aplicar Plugins de Infraestrutura foi atualizado para o máximo de 50 caracteres.

• Nova seção do arquivo action.yaml. Você encontra todos os campos e configurações para serem utilizadas em suas Actions.

• Foram atualizadas informações sobre a publicação de Stacks pelo STK CLI. Mais detalhes sobre os requisitos e regras de validação para fazer a publicação de uma Stack foram adicionados. Confira o guia.

• Atualização do arquivo plugin.yaml. Foram removidos os campos referentes a documentação do Plugin e adicionado o campo docs.

Nesta seção, você encontra: Referência das novas features da StackSpot & alterações relevantes na documentação.

Features

O que há de novo?

• Nova forma de documentar conteúdo na StackSpot: uma nova funcionalidade permite que os usuários publiquem e atualizem a documentação dos Plugins, Stacks e Actions através do STK CLI, documentações dos conteúdos criados. Há regras de escrita de Markdown para criar as documentações, que podem ser visualizadas na Plataforma da StackSpot.
  • As pastas antigas de documentação agora são centralizadas em um único documento, que pode ter uma versão em Português (docs/pt-br) e outra em Inglês (docs/en-us).

Para mais informações, confira o comando stk update doc.

• Novos comandos do STK CLI:
  • Criar Stack e Starter via STK CLI.
  • Valide usando stk validate stack ou stk validate starter.
  • Publique sua Stack.

Para mais informações, confira o guia de como criar, validar e publicar Stack/Starter via STK CLI.

• FAQ sobre Search Engine na StackSpot: conheça a nova Search Engine da StackSpot. É uma ferramenta que permite que você procure pelo conteúdo que quiser na Plataforma de forma objetiva, por meio de buscas semânticas. O sistema utiliza inteligência artificial para extrair o contexto da sua busca e agrupar informações, mesmo que os resultados não sejam exatamente iguais ao que você pesquisou. Confira no FAQ.

• Erro de 403 de Search Engine adicionado no Troubleshooting.

• Novo Versionamento Semântico. A StackSpot adota o SemVer. Você pode escolher versão específica e range para Action e Plugins. E você pode definir o range na Stack e no Starter.

• Novo comando stk list studio para listar no terminal todos os Estúdios disponíveis na sua conta.

• Execute Actions de uma Stack quando um Plugin é aplicado em uma Aplicação ou Infraestrutura usando o novo Hook Declarativo run-action.

• Adição de Actions no campo requires dos Plugins.

• Contas Personal agora podem executar o deploy de uma Aplicação ou Infraestrutura com a StackSpot, mas com o limite de deploy de 10 Plugins por Aplicação ou Infraestrutura e de 10 execuções por hora.

• Você pode configurar sua conta cloud Azure na StackSpot. Siga os passos na nova seção.

• Novos contratos das Connection Interfaces Types: foram criados 6 contratos e outputs de Connection Interface Types.

Correções e mudanças

• Updates on Event History: The journey of generating the Event History file in StackSpot's EDP Platform has been changed. The documentation has also changed. For more information, see the Event History section.

• Links Dinâmicos: os criadores de conteúdo podem gerar Links que se ajustam automaticamente aos parâmetros de uma Aplicação. Com os Links Dinâmicos você pode referenciar URLs através dos outputs dos connections.

Nesta seção, você encontra: Referência das novas features da StackSpot & alterações relevantes na documentação.

Features

• Você pode criar testes unitários para seus Plugins. Esses testes podem ajudar a alcançar os comportamentos esperados no uso, arquivos gerados e dados corretos. Aprenda como criar testes para os seus Plugins.

• Novo comando stk update plugin para atualizar a versão do Plugin ou reconfigurar a sua infraestrutura. Você pode atualizar seus Plugins de Infraestrutura ou reconfigurar uma Infraestrutura.

Mudanças

• Novos passos para executar o CLI em uma pipeline sem erros. Configure as variáveis de ambiente e os pacotes nos runners da sua pipeline. Siga os passos no guia.

• Atualização de novas roles para fazer rollback, destroy e deploy em Runtime. Confira mais detalhes nas seções:

• Deploy Infraestrutura

• Deploy da infraestrutura de uma Aplicação

Nesta seção, você encontra: Referência das novas features da StackSpot & alterações relevantes na documentação.

Features

• Novos contratos das Connection Interfaces Types: foram criados 9 contratos e outputs de Connection Interface Types.

• Suporte para uso de novas tecnologias em um Plugin: agora é possível usar 24 novos tipos de tecnologias em um plugin.yaml. Confira a lista atualizada.

• Novas regras e possibilidades para aplicação de Plugin: novos atributos de plugin.yaml foram criados para:

1. Um Plugin pode ser aplicado uma só vez em uma Aplicação ou Infraestrutura.
2. Um Plugin só possa ser utilizado em projetos já criados na StackSpot.
3. Determinar se um Plugin será requerido por outro.

Confira mais detalhes na seção, Atributos Opcionais.

• Novo self-hosted Runtime.

Mudanças

• Correção da condição containsAny dos inputs do plugin.yaml.
• Atualização dos comandos create app e infra. Foi adicionado o modo interativo aos comandos e a escolha da versão da Stack na opção - - starter, -s.
• Nova opção single-use para o plugin.yaml, permite limitar o uso de aplicações do Plugin em uma aplicação ou Infraestrutura.
• Novos filtros Jinja regex_replace e from_json.
• Adição de aviso na instalação do MacOS.
• Adição da dependência de Plugins e uso da versão semântica com range em Plugins required.
• Revisão da Action de setup do SCM e novo provedor GitLab.
• Fix no campo inputs-envs. foi atualizado para o novo schema.

Mudanças na documentação

• Nova seção Guias, você confere todos os passos para criar e usar conteúdo na StackSpot.
• Novas seções de Conta e Workspace.

Features

O que há de novo?

• Novo Dashboard de Insights no Estúdio Agora o Dashboard de Insights traz a opção de adicionar ou remover painéis, e navegar por gráficos de entidades como Plugins e Stacks.

• Nova arquitetura de Runtime Engine
  A nova arquitetura facilita o deploy, destroy e rollback, tanto de Aplicações quanto de Infraestruturas. Além disso, agora Runtime disponibiliza a configuração de ambientes durante o deploy e melhora o uso de Connection Interfaces na plataforma. Saiba mais detalhes nas seguintes páginas:

  • Configuração Inicial.
  • Deploy de uma Infraestrutura.
  • Deploy de Aplicação.
  • Usar Repositórios Privados durante o deploy

• Versionamento Semântico de Stacks Agora o versionamento de Stacks é do tipo Semântico. Isso significa que versões pode evoluir de forma independente. Confira mais detalhes na página de Stacks e Versionamento de Stacks.

• Nova versão de Plugins
  Na v2 dos Plugins é possível usar mais de uma Connection Interface do mesmo tipo, Implementação de Alias (apelidos) para as Connection Interfaces e mais. Confira os detalhes no guia de migração de Plugin v1 para v2.

• Criação de app.yaml Ainda na v2 dos Plugins, agora há um novo arquivo yaml: o app.yaml.

• Criação de infra.yaml Outro arquivo yaml também foi criado: o infra.yaml.

Atenção: app.yaml e infra.yaml agora são app-spec.yaml and infra-spec.yaml

• Novos atributos no plugin.yaml
  Com o Deploy por Plugin na v2, novos atributos foram adicionados no plugin.yaml.

• Criação de Links Dinâmicos Os criadores de conteúdo na StackSpot podem gerar Links que se ajustam automaticamente aos parâmetros atuais da Aplicação.

• Criação de feature de gerenciar links em Aplicações e Infraestruturas
  Agora você pode integrar ferramentas externas a uma Aplicação ou Infraestrutura por meio de Links. Podem ser estáticos ou incorporados. Confira mais detalhes na seção sobre Links.

• Nova forma para criar Aplicações e Infraestrutura no Portal. Agora é possível fazer deploy por Plugin na StackSpot. E você pode seguir uma nova jornada de criação de Aplicações e Infraestruturas no Portal.

• Exemplo de criação de Infraestrutura com Deploy por Plugin
  Confira um exemplo do início ao fim para criar uma Infraestrutura fazendo o Deploy por Plugin.

• Atualização no menu da documentação
  Você verá um novo menu de Criar e Usar Conteúdo. A mudança veio para facilitar a navegação na documentação da StackSpot.

• Onboarding guiado de acesso de Parceiros no Catálogo de Serviços Os Parceiros têm acesso a um guia que apresenta todas as seções disponíveis no Catálogo de Serviços.

• Atualização no parâmetro --environment
  O parâmetro --environment foi alterado para --env ou -e.

• Atualizações na página e nos comandos do STK CLI
  A página de comandos passou por uma nova organização, que melhora a visibilidade e rastreabilidade dos comandos. As descrições dos comandos também foram atualizadas para refletirem todas as mudanças realizadas para suportar as novas funcionalidades da plataforma.

Features

O que há de novo?

• Depreciação de Conteúdo Agora é possível depreciar a versão de uma Stack que foi publicada no Estúdio ou Workspace. Você também pode depreciar uma versão de Actions, Starters.

Confira mais detalhes na página de Stacks e Versionamento de Stacks.

• Histórico de Eventos

Quem tem a permissão de Account Holder pode visualizar os dados de todos os eventos relacionados à usuários que foram feitos dentro da conta da StackSpot em um período de tempo.

• Melhorias no Catálogo de Serviços

Novas seções na documentação que detalham e exemplificam as principais funcionalidades do Catálogo de Serviços, tanto para Clientes quanto para Parceiros.

Para mais detalhes, confira as páginas:

• Criar API direto em uma Aplicação: Novo menu para criar APIs no Workspace e publicá-los no Catálogo.

• Criar e Publicar produtos no Catálogo: No Workspace você pode acessar um novo menu e criar/vincular os seus Produtos no Catálogo.

• Adicionar API a partir de uma Aplicação existente: Em uma aplicação que já foi criada, você pode vinculá-la a um Swagger e publicá-la no Catálogo.

• Acesso ao Catálogo de Serviços: Você pode acessar o Catálogo na sua conta.

• FAQ: Nova seção respondendo perguntas sobre o Catálago de Serviço.

Features

O que há de novo?

• Incorporar Links Você pode incorporar links ao seu Workspace para mostrar painéis, como o Grafana, por exemplo. Confira mais detalhes na nova seção.

• Nova seção de Troubleshooting.

• Credenciais de Serviço Se você tem permissão de Account Holder, você pode gerar tokens de serviço para a sua conta Enterprise.

Para mais informações, confira a nova seção de Credenciais de Serviço.

• Catálogo de Serviços A nova funcionalidade da plataforma StackSpot permite clientes criarem APIs e disponibilizarem na sua empresa. E expor um conjunto de APIs que serão produtos para empresas parceiras. Confira mais detalhes na seção de Catálogo de Serviços.

• Novos comandos no STK CLI O STK CLI possui comandos que auxiliam a criação e publicação de APIs:

• stk update app

• stk update infra

• stk publish api

Para mais detalhes, confira a seção de Comandos.

• Deletar Workspaces: Agora você pode deletar Workspaces criados, desde que estejam vazios.

• Você pode editar nome/descrição e apagar:

  • Aplicações.
  • Infraestruturas.

• Você pode acrescentar Tags nas Stacks e Tecnologias em Plugins.

Features

O que há de novo?

• Nova action para auxiliar na integração do seu SCM, confira:

  • GitHub
  • Azure
  • BitBucket

• Agora, você pode remover os conteúdos criados, confira em:

  • Stack
  • Plugin
  • Action
  • Estúdio

• A StackSpot possui dois tipos de Conta:

  • A Enterprise
  • Nova Conta do tipo Personal

• Confira detalhes sobre quem pode configurar a Visibilidade de Estúdio

• A plataforma ainda tem um novo Dashboard de Aplicação/Infraestrutura.

• Você pode editar e apagar Aplicação e Infraestrutura, confira:

  • Como editar nome e descrição de Aplicação no Portal
  • Como apagar Aplicação no Portal
  • Como editar nome e descrição de Infraestrutura no Portal
  • Como apagar Infraestrutura no Portal

Mudanças na documentação

• Nova seção de Usar Conteúdo

  • Exemplo de uso
  • Guia de Uso
  • Atualização na seção ‘Sobre a StackSpot’

• Seção de Exemplos

  • Como criar Plugin
  • Como Publicar Plugin via Pipeline