Usability improvements in studios

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

A new usability was implemented in StackSpot studios to bring more flexibility and clarity to content management.

What are Usability improvements in studios and their benefits?

With this implementation, content creators have a new usability experience in their studios within the StackSpot portal. Therefore, the experience as a whole is objective and direct in terms of content exposure. We brought more intuitive menus and a more targeted organization of information according to feedback received from real customers.

How it works?

When accessing the studio, content creators already have direct access to their studio's content (Stacks, Plugins and Actions). Seeking to facilitate the viewing of this content, we use tabs, filters and a list using cards that already contain the main information for each content.

When accessing each content individually, the user is directed to the respective documentation screen, thus being updated with the main information about that content accessed.

When accessing the stacks, the user is initially directed to the stack's content, and the documentation is found in the next menu. All stack content is organized by tabs, filters and a list of important information.

To access the content versions, the content creator can access their sidebar and no longer the header, seeking to make the header cleaner with information.

Studio settings and visibility have been combined into a single settings menu.

---

Uma nova usabilidade foi implementada nos estúdios da StackSpot visando trazer mais flexibilidade e clareza na gestão dos conteúdos.

O que é Usability improvements in studios e seus benefícios?

A partir dessa implementação, criadores de conteúdo têm uma nova experiência de usabilidade em seus estúdios dentro do portal StackSpot. Com isso, a experiência como um todo está objetiva e direta em termos de exposição do conteúdo. Trouxemos menus mais intuitivos e uma organização mais direcionada das informações de acordo com os feedbacks recebidos de clientes reais.

Como funciona?

Ao acessar o estúdio os criadores de conteúdo já têm acesso direto ao conteúdo do seu estúdio (Stacks, Plugins e Actions). Buscando facilitar a visualização deste conteúdo, utilizamos abas, filtros e uma lista através de cards que já contém as principais informações de cada conteúdo.

Ao acessar cada conteúdo individualmente, o usuário é direcionado para a respectiva tela de documentação, ficando assim atualizado com as principais informações sobre aquele conteúdo acessado.

Ao acessar as stacks, além de o usuário é direcionado inicialmente para o conteúdo da mesma, e no próximo menu se encontra a documentação. Todo conteúdo da stack está organizado por abas, filtros e uma lista de informações importantes.

Para acessar as versões do conteúdo, o criador do conteúdo pode acessar a sua barra lateral e não mais o cabeçalho, buscando deixar o cabeçalho mais limpo de informações.

As configurações e a visibilidade do Studio foram combinadas em um único menu de configurações.

Search

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

EDP users now have a simple and efficient search function available that will present information in an organized manner and offer filters to allow users to easily find what they need.

What is Search and its benefits?

Platforms are designed to offer products or services to customers, and over time, the amount of content available tends to grow exponentially, making it challenging to find relevant solutions to address specific issues quickly. At StackSpot, with the rapid expansion of this content, we understand the importance of providing a seamless search experience for our users. For this reason, we are providing a simple and efficient search function that will present information in an organized way and offer filters to allow users to easily find what they need.

How it works?

• Search by content: The new search filters results on elements such as title, description or any other relevant content associated with what you are looking for.

• Similarity engine in action: Our intelligent search engine analyzes the content you provide and compares it with the vast amount of information stored on the platform. It identifies items that share a high degree of similarity with your search query.

• Relevant Results - Fast: The magic happens behind the scenes! The search engine quickly provides a set of results sorted based on similarity to your search criteria. This means you'll see the most relevant items first, saving you valuable time and effort.

• User Journeys

When accessing the EDP, at the top of the page you will be able to see the new Searc field. Just click, type the keyword and then filter according to the category that comes closest to the result you want.

Recording.2023-10-27.105156.mp4

---

Usuários do EDP agora tem disponível uma função de busca simples e eficiente que apresentará as informações de forma organizada e oferecerá filtros para permitir que os usuários localizem facilmente o que precisam.

O que é Search e seus benefícios?

As plataformas são projetadas para oferecer produtos ou serviços aos clientes, e ao longo do tempo, a quantidade de conteúdo disponível tende a crescer exponencialmente, tornando desafiador encontrar soluções relevantes para abordar questões específicas de forma rápida. Na StackSpot, com a expansão acelerada desse conteúdo, compreendemos a importância de proporcionar uma experiência de busca contínua aos nossos usuários. Por esse motivo, estamos disponibilizando uma função de busca simples e eficiente que apresentará informações de forma organizada e oferecerá filtros para permitir que os usuários encontrem facilmente o que necessitam.

Como funciona?

• Pesquise por conteúdo: A nova pesquisa filtra resultados em elementos como título, descrição ou qualquer outro conteúdo relevante associado ao que procura.

• Mecanismo de similaridade em ação: Nosso mecanismo de pesquisa inteligente analisa o conteúdo que você fornece e o compara com a grande quantidade de informações armazenadas na plataforma. Ele identifica itens que compartilham um alto grau de semelhança com sua consulta de pesquisa.

• Resultados Relevantes - Rápidos: A magia acontece nos bastidores! O mecanismo de pesquisa fornece rapidamente um conjunto de resultados classificados com base na semelhança com seus critérios de pesquisa. Isso significa que você verá os itens mais relevantes primeiro, economizando tempo e esforço valiosos.

• Jornadas do usuário

Ao acessar o EDP, no topo da página será possível ver o novo campo de Searc. Basta clicar, digitar a palavra chave e depois filtrar de acordo com a categoria que mais se aproxime com o resultado que deseja.
https://github.com/stack-spot/stackspot-roadmap/assets/85169866/9340c582-861c-4690-b1cb-755f44f0ed6c

Stack and Starter creation and configuration via the CLI

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

Content creators can now create and configure Stack and Starter via the CLI channel.

What is Stack and Starter creation and configuration via the CLI and its benefits?

From this implementation, content creators can create and configure their stacks and starters through the CLI. For content creators, this new functionality benefits them by allowing them to create and configure stacks and starters through the CLI and not just through the portal as it was before this implementation. With this, we meet the needs of customers who prefer to create their content through lines of code, thus providing an experience where both product channels have the same functionalities.

How it works?

To create a stack via the CLI:

1 - Enter the command:

stk create stack 

2 - Answer the questions on your terminal:

? Name your stack: example-stack ? Version: (0.0.1) ? Do you want to start a git repository? At the ? Add remote? Yes? Git URL to set as remote origin: add the URL? Stack description: (Describe the stack explaining its purpose)

3 - Open the Stack folder. Click on the stack.yaml file and fill in the Stack parameters:

• repository
• docs
• links
• plugins
  -actions
• starters

stack.yaml example:

schema-version: v1
kind: stack
metadata:
  name: my-stack
  display-name: my-stack
  description: My Stack description
  version: 1.0.0
spec:
  repository: git@github.com:GitHub-UserName/my-local-repository.git
  docs:
    en-us: docs/en_us/docs.md
    pt-br: docs/pt_br/docs.md
  links:
    - name: My Stack link
      url: https://github.com/my-github-org/my-stack
      picture: stack-image.png
  plugins:
    app:
      - name: studio-slug/app-plugin-name@1.0.0
    infra:
      - name: studio-slug/infra-plugin-name@1.2.0
  actions:
    - name: studio-slug/action-name1@0.0.1
    - name: studio-slug/action-name2@1.0.1
    - name: studio-slug/action-name3@2.1.0
  starters:
    - name: starter-name
      path: starters/basic-starter 
    - name: java-starter
      path: starters/java-starter  

To create a starter via the CLI:

1 - Run the command:

stk create starter

2 - Answer the questions on your terminal:

? Name your starter: basic-starter ? Do you want to start a git repository? Yes/No? Add remote? Yes/No? Git URL to set as remote origin: add the URL? Description of the starter: (Describe the starter explaining its purpose)

Make sure you have added the Starter name to your stack.yaml file.

3 - Open the Stack folder and then open the Starter folder. Click on the starter.yaml file and fill in the Starter parameters:

• type
• docs
• plugins

Example starter.yaml:

schema-version: v1
kind: starter
metadata:
  name: basic-starter
  description: basic-starter
spec:
  type: app
  docs:
    en-us: docs/en_us/docs.md
    pt-br: docs/pt_br/docs.md
  plugins:
    required:
      - name: my-studio/app-java-plugin  

To publish the stack:

1 - Run the command:

stk publish stack

2 - Select your Studio and click "Enter", or enter the name of the Studio with the option --studio.

stk publish stack --studio <slug studio>

Ready! Your Stack and Starter has been published. You can check out the publication by accessing the stackspot.com portal.

Supporting content

Documentation

---

Os criadores de conteúdo agora podem criar e configurar Stack e Starter pelo canal CLI.

O que é Stack and Starter creation and configuration via the CLI e seus benefícios?

A partir dessa implementação os criadores de conteúdo podem criar e configurar suas stacks e starters por meio da CLI. Para os criadores de conteúdo, esta nova funcionalidade os beneficia por permitir criar e configurar stacks e starter por meio da CLI e não apenas por meio do portal como era antes dessa implementação. Com isso, atendemos às necessidades dos clientes que preferem criar seus conteúdos através de linhas de código, proporcionando assim uma experiência onde ambos os canais do produto possuem as mesmas funcionalidades.

Como funciona?

Para criar uma stack pela CLI:

1 - Insira o comando:

stk create stack 

2 - Responda as perguntas no seu terminal:

? Nomeie sua stack: exemplo-stack ? Versão: (0.0.1) ? Você deseja iniciar um repositório git? No ? Adicionar remote? Yes ? Git URL para definir como remote origin: adicione a URL ? Descrição da stack: (Descreva a stack explicando o seu propósito)

3 - Abra a pasta da Stack. Clique no arquivo stack.yaml e preencha os parâmetros da Stack:

• repository
• docs
• links
• plugins
• actions
• starters

Exemplo stack.yaml:

schema-version: v1
kind: stack
metadata:
  name: my-stack
  display-name: my-stack
  description: My Stack description
  version: 1.0.0
spec:
  repository: git@github.com:GitHub-UserName/my-local-repository.git
  docs:
    en-us: docs/en_us/docs.md
    pt-br: docs/pt_br/docs.md
  links:
    - name: My Stack link
      url: https://github.com/my-github-org/my-stack
      picture: stack-image.png
  plugins:
    app:
      - name: studio-slug/app-plugin-name@1.0.0
    infra:
      - name: studio-slug/infra-plugin-name@1.2.0
  actions:
    - name: studio-slug/action-name1@0.0.1
    - name: studio-slug/action-name2@1.0.1
    - name: studio-slug/action-name3@2.1.0
  starters:
    - name: starter-name
      path: starters/basic-starter 
    - name: java-starter
      path: starters/java-starter  

Para criar um starter pela CLI:

1 - Execute o comando:

stk create starter

2 - Responda as perguntas no seu terminal:

? Nomeie seu starter: basic-starter ? Você deseja iniciar um repositório git? Yes/No ? Adicionar remote? Yes/No ? Git URL para definir como remote origin: adicione a URL ? Descrição da starter: (Descreva o starter explicando o seu propósito)

Certifique-se de ter adicionado o nome do Starter ao seu arquivo stack.yaml.

3 - Abra a pasta da Stack e, em seguida, abra a pasta do Starter. Clique no arquivo starter.yaml e preencha os parâmetros do Starter:

• type
• docs
• plugins

Exemplo starter.yaml:

schema-version: v1
kind: starter
metadata:
  name: basic-starter
  description: basic-starter
spec:
  type: app
  docs:
    en-us: docs/en_us/docs.md
    pt-br: docs/pt_br/docs.md
  plugins:
    required:
      - name: my-studio/app-java-plugin  

Para publicar a stack:

1 - Execute o comando:

stk publish stack

2 - Selecione seu Estúdio e clique em "Enter", ou informe o nome do Estúdio com a opção --studio.

stk publish stack --studio <slug studio>

Pronto! Sua Stack e seu Starter foi publicado. Você pode conferir a publicação acessando o portal stackspot.com.

Conteúdos de apoio

Documentação

Doc Engine

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

In addition to creating documentation for plugins and actions, content creators can now document stacks and starters.

What is Doc Engine and its benefits?

From this implementation, content creators documents plugins, actions, sctaks and starters through a single file generated in the content creator's local directory as soon as they give the command to create one of these contents via CLI. For content creators, the evolution of the documentation feature brings benefits in terms of keeping documentation close to the code of the created content. Just as it will no longer be necessary to create a new version of a plugin, action or stack whenever you need to update the documentation, as we have a command in the CLI that makes it possible to update the documentation. Another perceived benefit is the possibility of creating documentation for the stack and starter, where it was not possible before this feature.

How it works?

Create documentation

1 - Enter any of the commands below:

stk create plugin

stk create action

stk create stack

stk create starter

2 - Answer the terminal's questions.

3 - Check the folders /docs/pt_br and /docs/en_us with their respective .md files generated in your local directory:

4 - Edit the generated files as you wish to document.

5 - Enter the publication command for your respective content, which could be:

stk publish plugin --studio <studio-slug>

stk publish action --studio <studio-slug>

stk publish stack --studio <studio-slug>

Ready! Its contents were published together with written documentation.

Note: Files must be written in .md format and will be rendered for display on the stackspot.com portal.

Update documentation

If you need to update your documentation, follow these steps:

1 - Say login to the STK CLI:

stk login

2 - Write the changes you want to make in the .md file;

3 - Run the command below:

stk update doc --studio <studio-slug>

Ready! The changes were signed in the documentation.

Supporting content

Documentation

---

Além de criar documentação para plugins e actions, agora os criadores de conteúdo podem documentar stacks e starters.

O que é Doc Engine e seus benefícios?

A partir dessa implementação, criadores de conteúdo documentos para plugins, actions, sctaks e starters através de um único arquivo gerado no diretório local do criador de conteúdo assim que derem o comando para criar um desses conteúdos via CLI. Para os criadores de conteúdo, a evolução do recurso de documentação traz benefícios em termos de manutenção da documentação próxima ao código do conteúdo criado. Assim como não será mais necessário criar uma nova versão de um plugin, action ou stack sempre que precisar atualizar a documentação, pois temos um comando na CLI que possibilita a atualização da documentação. Outro benefício percebido é a possibilidade de criação de documentação para o stack e starter, onde não era possível antes dessa feature.

Como funciona?

Criar documentação

1 - Inserir qualquer um dos comandos abaixo:

stk create plugin

stk create action 

stk create stack 

stk create starter

2 - Responder as perguntas do terminal.

3 - Confira as pastas /docs/pt_br e /docs/en_us com seus respectivos arquivos .md geradas no seu diretório local:

4 - Edite os arquivos gerados conforme deseja documentar.

5 - Insira o comando de publicação do seu respectivo conteúdo, podendo ser:

stk publish plugin --studio <studio-slug>

stk publish action --studio <studio-slug>

stk publish stack --studio <studio-slug>

Pronto! Seu conteúdo foi publicado juntamente com a documentação escrita.

Observação: os arquivos devem ser escritos no formato .md e serão renderizados para exibição no portal da stackspot.com.

Atualizar documentação

Caso necessite atualizar sua documentação, siga os passos:

1 - Fala login no STK CLI:

stk login

2 - Escreva as mudanças que você quer fazer no arquivo .md;

3 - Execute o comando abaixo:

stk update doc --studio <studio-slug>

Pronto! As mudanças foram subscritas na documentação.

Conteúdos de apoio

Documentação

Personal account with Runtime capability

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

Stackspot now enables personal accounts to utilize the Runtime Engine.

What is Personal account with Runtime capability and their benefits?

This new capability empowers users not only to connect their AWS cloud account to their workspace but also to leverage all the benefits of infrastructure plugins. The Runtime Engine assists in deploying these plugins to create the necessary infrastructure components, reducing the cognitive load on developers dealing with the cloud. Moreover, it orchestrates the dependencies among these components, simplifying the overall process.

How It Works?

Customers can connect a cloud account to their Workspace within Stackspot, granting necessary permissions and setting up a deployment step in their pipeline. For further details, refer to our documentation
Additionally, to ensure healthy and sustainable usage of this feature, there's a limit on personal accounts. Each deployment can have a maximum of 10 infrastructure plugins and can execute 10 deployments per hour.

Stackspot agora permite que contas pessoais utilizem o Motor de Runtime.

O que é Personal account with Runtime capability e seus benefícios?

Essa nova capacidade permite aos usuários não apenas conectar sua conta na nuvem AWS ao seu espaço de trabalho, mas também aproveitar todos os benefícios dos plugins de infraestrutura. O Motor de Runtime auxilia no deploy desses plugins para criar os componentes de infraestrutura necessários, reduzindo a carga cognitiva dos desenvolvedores ao lidar com a nuvem. Além disso, orquestra as dependências entre esses componentes, simplificando o processo como um todo.

Como Funciona?

Os clientes podem conectar uma conta na nuvem ao seu Espaço de Trabalho dentro do Stackspot, concedendo as permissões necessárias e configurando uma etapa de implantação em seu pipeline. Para mais detalhes, consulte nossa documentação
Além disso, para garantir um uso saudável e sustentável desta funcionalidade, há um limite nas contas pessoais. Cada implantação pode ter no máximo 10 plugins de infraestrutura e pode executar 10 implantações por hora.

AWS Marketplace Integration to Enterprise Development Portal

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

StackSpot Enterprise Developer Platform now listed on AWS Marketplace.

Summary

StackSpot’s debut on AWS Marketplace elevates brand visibility and streamlines customer acquisition. The EDP is listed and accessible to U.S. customers, expanding platform global reach. Now, AWS users can sign up to StackSpot seamlessly via the marketplace.

How does it work?

The product listing is public on AWS Marketplace website. AWS users based in the United States are able to accept the terms and conditions of the public offer by fulfilling the purchase seamlessly -- while AWS handles billing and invoicing with an integration with the user’s AWS account. End customers can also submit a request for a private offer that can be customized according to their needs.

Check out our product listing on AWS Marketplace!

---

Lançamento da StackSpot Enterprise Developer Platform no AWS Marketplace.

Visão Geral

O lançamento da StackSpot no AWS Marketplace abre caminhos de adoção para novos clientes. A plataforma é listada e acessível para usuários de AWS baseados nos Estados Unidos, contribuindo para seu alcance global. Agora, usuários de AWS podem contratar a StackSpot de forma fácil via marketplace.

Como funciona?

O anúncio do produto é público no site do AWS Marketplace. Usuários da AWS nos Estados Unidos podem realizar a compra aceitando os termos e condições apresentados de forma transparente -- enquanto a AWS cuida de faturamento de forma integrada com a conta AWS do usuário. A customização de ofertas também é possível por meio de uma solicitação de contrato privado que pode ser personalizada de acordo com as necessidades do cliente final.

Confira o nosso produto no AWS Marketplace!

Actions Required in the Plugin yaml

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

Content creators can now add required action in the plugin's yaml configuration.

What are Actions Required in the Plugin yaml and their benefits?

From this implementation, content creators have the possibility of having an action hook that allows them to pass parameters, determine when it will be executed and the version of the action. As well as having a new required action field in the plugin manifest for indexing.
For content creators, this new functionality allows you to work on some use cases, such as, for example, passing functions through plugins without having to change this function within each plugin whenever there is a change in them, this makes the use of resources more reusable.

How it works?

To have an action hook that allows parameters to be passed, the content creator can follow the following steps:

1 - First you need to add an action to the list of actions required by the plugin in the plugin.yaml file

requires:
    actions:
      - cli-studio/cli-stack@0.0.1/action-name

2 - Then you need to add the new run-action hook in the plugin.yaml file.

hooks:
    - type: enforcement action
      trigger: post-render
      name: cli-studio/cli-stack@0.0.1/action-name
      Appetizer:
        user_name: user with {{ resource }}

Therefore, the plugin will perform this action when the plugin is applied, right after rendering the template files.

Supporting content

Documentation

---

Os criadores de conteúdo agora podem adicionar action requerida na configuração do yaml do plugin.

O que são Actions Required in the Plugin yaml e seus benefícios?

A partir dessa implementação realizada, os criadores de conteúdo têm a possibilidade de ter um hook de action que permita passar parâmetros, determinar quando vai ser executado e a versão da action. Assim como, ter um novo campo de required action no manifesto do plugin para indexação.
Para os criadores de conteúdo, esta nova funcionalidade permite trabalhar em alguns casos de uso, como, por exemplo, passar funções através de plugins sem precisar alterar esta função dentro de cada plugin sempre que houver uma alteração nos mesmos, isso torna o uso de recursos mais reutilizáveis.

Como funciona?

Para ter um hook de action que permita passar parâmetros, o criador de conteúdo pode seguir os seguintes passos:

1 - Primeiro você precisa adicionar a action na lista de actions requeridas pelo plugin no arquivo plugin.yaml

requires:
    actions:
      - cli-studio/cli-stack@0.0.1/action-name

2 - Depois você precisa adicionar o novo hook do tipo run-action no arquivo plugin.yaml.

hooks:
    - type: run-action
      trigger: after-render
      name: cli-studio/cli-stack@0.0.1/action-name
      inputs:
        user_name: User with {{ resource }}

Com isso o plugin irá executar essa action quando plugin for aplicado, logo após renderizar os arquivos de template.

Conteúdos de apoio

Documentação

Semantic Version Range Support for Plugins and Actions

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

Now your experience as a content creator has become more flexible by inserting a semantic version range of Plugins and Actions in your Stacks, so it is not necessary to create new Stack versions every time new content is published and is within the range.

What is semantic version range support for plugins and actions and its benefits?

Content creators have the possibility of inserting a range of plugin versions within Stacks and Starters and a range of action versions within Stacks that will allow greater flexibility in relation to the work of creating new stack versions.
This new capability brings benefits to customers in terms of automatically updating a stack that has a range of versions of a plugin or action, as well as automatically updating the workspace. This way, using a semantic version range of plugins and/or actions, it will not be necessary to create new versions of the stack, insert a new version of a plugin or a new version of an action and carry out this entire process in the workspaces where the changes are reflected. . For content creators, this new functionality brings convenience and better use of the platform.

How it works?

To insert a semantic version range of a plugin within a stack, the content creator can follow the following steps:

1 - Access the StackSpot Platform;
2 - Access a Studio;
3 - Access a Stack;
4 - Click on "App" or "Infra" in the left menu;
5 - Click on the "Add App Plugin" or "Add Infra Plugin" button (depending on the choice in the previous step);
6 - Choose a plugin and click on the versions combobox;
7 - Enter a version range using the semver pattern (^ou~);
8 - Click on Add Plugins.

Ready! Your plugin was added to the Stack considering that new versions within this range are included.

To insert a semantic version range of an action within a stack, the content creator can follow the following steps:

1 - Access the StackSpot Platform;
2 - Access a Studio;
3 - Access a Stack;
4 - Click on "Actions" in the left menu;
5 - Click on the "Add action" button;
6 - Choose an action and click on the versions combobox;
7 - Enter a version range using the semver pattern (^ou~);
8 - Click on Add Action.

Ready! Your action was added to the Stack considering that new versions within this range are included.

To insert a semantic version range of a plugin within a starter, the content creator can follow the following steps:

1 - Access the StackSpot Platform;
2 - Access a Studio;
3 - Access a Stack;
4 - Access a Starter;
5 - Click on the "Add App Plugins" button;
6 - Choose a plugin and click on the versions combobox;
7 - Enter a version range using the semver pattern (^ou~);
8 - Click on Add Plugins.

Ready! Your plugin was added to the Starter, and automatically to the Stack, considering that new versions within this range are included.

Whenever an application is created through a starter that has a semantic version range of a given plugin, the last published version of the plugin within the range inserted in the Stack will be considered.

Considering that a semantic version range of a plugin or action has been inserted within a stack, a new version does not need to be created as soon as new plugins or corresponding actions are published in the range. The same rule applies to workspaces that have these stacks.

Supporting content

Documentation - Add Action to an Infra Plugin
Documentation - Add, Deprecate or Delete Action to Studio
Documentation - Version, Deprecate or Delete Plugin in Studio
Documentation - Add, Deprecate or Delete Action to Stacks
Documentation - Version, Deprecate or Delete Plugin in Stack

---

Agora sua experiência como criador de conteúdo ficou mais flexível ao inserir um range de versão semântica de Plugins e Actions em suas Stacks, assim não é necessário criar novas versões de Stack sempre que um novo conteúdo é publicado e está dentro do range.

O que é suporte ao range de versões semânticas para plugins e actions e seus benefícios?

Os criadores de conteúdo têm a possibilidade de inserir um range de versões de plugins dentro de Stacks e Starters e um range de versões de actions dentro de Stacks que permitirão maior flexibilidade em relação ao trabalho de criação de novas versões de stacks.
Essa nova capacidade traz benefícios aos clientes em termos de atualização automática de uma stack que possui um range de versões de um plugin ou action, bem como atualização automática do workspace. Desta forma, utilizando um range de versão semântica de plugins e/ou actions não será necessário criar novas versões da stack, inserir uma nova versão de um plugin ou uma nova versão de uma action e realizar todo esse processo nos workspaces onde as alterações são refletidas. Para os criadores de conteúdo, essa nova funcionalidade traz praticidade e melhor aproveitamento da plataforma.

Como funciona?

Para inserir um range de versão semântica de um plugin dentro de uma stack, o criador de conteúdo pode seguir os seguintes passos:

1 - Acessar a Plataforma StackSpot;
2 - Acessar um Estúdio;
3 - Acessar uma Stack;
4 - Clicar em "App" ou "Infra" do menu esquerdo;
5 - Clicar no botão "Add App Plugin" ou "Add Infra Plugin" (dependendo da escolha da etapa anterior);
6 - Escolher um plugin e clicar no combobox de versões;
7 - Digitar um range de versão utilizando o padrão semver (^ou~);
8 - Clicar em Add Plugins.

Pronto! Seu plugin foi adicionado na Stack considerando que novas versões dentro desse range sejam contempladas.

Para inserir um range de versão semântica de uma action dentro de uma stack, o criador de conteúdo pode seguir os seguintes passos:

1 - Acessar a Plataforma StackSpot;
2 - Acessar um Estúdio;
3 - Acessar uma Stack;
4 - Clicar em "Actions" do menu esquerdo;
5 - Clicar no botão "Add action";
6 - Escolher uma action e clicar no combobox de versões;
7 - Digitar um range de versão utilizando o padrão semver (^ou~);
8 - Clicar em Add Action.

Pronto! Sua action foi adicionada na Stack considerando que novas versões dentro desse range sejam contempladas.

Para inserir um range de versão semântica de um plugin dentro de um starter, o criador de conteúdo pode seguir os seguintes passos:

1 - Acessar a Plataforma StackSpot;
2 - Acessar um Estúdio;
3 - Acessar uma Stack;
4 - Acessar um Starter;
5 - Clicar no botão "Add App Plugins";
6 - Escolher um plugin e clicar no combobox de versões;
7 - Digitar um range de versão utilizando o padrão semver (^ou~);
8 - Clicar em Add Plugins.

Pronto! Seu plugin foi adicionado no Starter, e automaticamente na Stack, considerando que novas versões dentro desse range sejam contempladas.

Sempre que for criada uma aplicação através de um starter que possui um range de versão semântica de um determinado plugin, será considerada a última versão publicada do plugin dentro do range inserido na Stack.

Considerando que foi inserido um range de versão semântica de um plugin ou action dentro de uma stack, não precisa ser criada nova versão desta assim que houver publicação de novos plugins ou actions correspondentes no range. A mesma regra se aplica para workspaces que possui essas stacks.

Conteúdos de apoio

Documentação - Associar Action a Plugin de Infra
Documentação - Adicionar, Depreciar ou Deletar Action no Estúdio
Documentação - Versionar, Depreciar ou Deletar Plugin no Estúdio
Documentação - Adicionar, Depreciar ou Deletar Action na Stack
Documentação - Versionar, Depreciar ou Deletar Plugin na Stack

STK IAM

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

Description

This feature is about Stackspot having advanced Role-Based Access Control (RBAC) capabilities, this system empowers companies to exercise precise control over sensitive information access. Administrators can create custom roles and assign permissions, facilitating scalable access management while ensuring security and compliance. With a user-friendly interface, robust analytics, and comprehensive reporting, it represents a significant milestone for Stackspot and an industry advancement, poised to enhance access control and security for businesses of all sizes.

How It Will Work

Admin will be able manage access control in a granular level of permissions.
Admin will be able to organize user and groups with roles and assossianting the right resource to be handled

Descrição

Recursos avançados de Controle de Acesso Baseado em Funções (RBAC), este sistema capacita empresas a exercer controle preciso sobre o acesso a informações sensíveis. Administradores podem criar funções personalizadas e atribuir permissões, facilitando o gerenciamento de acesso escalável, garantindo segurança e conformidade. Com uma interface amigável, análises robustas e relatórios abrangentes, representa um marco significativo para a Stackspot e um avanço notável na indústria, pronto para melhorar o controle de acesso e a segurança para empresas de todos os tamanhos.

Preview Feature

Plugin tests

This release note is written in English and Portuguese, scroll to the end to access both languages.

Esta release note está escrita em Inglês e Português, role a página até o final para ter acesso às duas linguagens.

---

Content creators now have the ability to create plugin test cases in the CLI.

What is Plugin testing and its benefits?

Content creators have the possibility to test the plugins created to validate the generated templates. The content creator can create test cases exclusively for the plugin, where it is possible to insert the project content in the destination folder, simulating the application of the plugin in projects that were not created with StackSpot, thus ensuring complete coverage of the generated templates.

How it works?

To add test cases to an existing plugin, the content creator must follow the following steps:
1 – Create a folder in the root of the plugin;
2 - Create a subfolder that contains the name of the test scenario;
3 - Create the following items in the subfolder:

• Expected folder: folder that contains the expected files to validate the plugin application.
• Target folder: folder containing an app/infra, in which the plugin will be applied.
• test-case.yaml file: file that contains the test case manifest (inputs, inputs-envs, required connection, generated connection)

4 - Run the test cases with the stk test plugin command.

You can run the tests in the following ways:

• stk test plugin: will run all test scenarios in application and deployment, with the exception of skipped scenarios.
• stk test plugin: will run the test scenario containing the entered name.
• stk test plugin --mode apply: Will run all test scenarios in apply mode, with the exception of skipped scenarios.
• stk test plugin --mode deploy: Will run all test scenarios in deploy mode, with the exception of skipped scenarios.

Supporting content

Documentation

---

Os criadores de conteúdo agora têm a capacidade de criar casos de testes para plugin na CLI.

O que é Plugin tests e seus benefícios?

Os criadores de conteúdo tem a possibilidade de testar os plugins criados para validar os templates gerados. O criador de conteúdo consegue criar casos de teste exclusivamente para plugin, onde é possível inserir o conteúdo do projeto na pasta de destino, simulando a aplicação do plugin em projetos que também não foram criados com StackSpot, garantindo assim cobertura completa dos templates gerados.

Como funciona?

Para adicionar casos de teste a um plugin existente, o criador de conteúdo deve seguir os seguintes passos:
1 – Crie uma pasta na raiz do plugin;
2 - Crie uma subpasta que contenha o nome do cenário de teste;
3 - Crie os seguintes itens na subpasta:

• Expected folder: pasta que contém os arquivos esperados para validar a aplicação do plugin.
• Target folder: pasta que contém um app/infra, na qual o plugin será aplicado.
• Arquivo test-case.yaml: arquivo que contém o manifesto do caso de teste (entradas, inputs-envs, connections requeridas, connections geradas)

4 - Execute os casos de teste com o comando stk test plugin.

Você pode executar os testes das seguintes maneiras:

• stk test plugin: executará todos os cenários de teste em aplicação e implantação, com exceção de cenários ignorados.
• stk test plugin: executará o cenário de teste que contém o nome inserido.
• stk test plugin --mode apply: Executará todos os cenários de teste no modo de aplicação, com exceção dos cenários ignorados.
• stk test plugin --mode deploy: Executará todos os cenários de teste no modo de implantação, com exceção dos cenários ignorados.

Conteúdos de apoio

Documentação