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

Features 

Arquivamento e depreciação de conteúdo

O mecanismo de depreciação e arquivamento de conteúdo na StackSpot já está disponível. O processo de arquivamento para Stacks publicadas em Estúdios e o novo Workflow (versão beta) segue uma sequência clara de etapas para descontinuar efetivamente uma versão de conteúdo. Confira mais nas seções a seguir:

• Stacks
• Workflow

Secrets Management

Agora você pode proteger e gerenciar informações sensíveis, como senhas, chaves de acesso e tokens de autenticação, diretamente na StackSpot EDP. O Gerenciador de Secrets permite centralizar e garantir a segurança desses dados em três níveis:

• Organização
• Workspace
• Pessoal

Essa funcionalidade assegura a integridade e a proteção dos seus sistemas de forma eficiente. Confira mais detalhes para cada nível:

• Como cadastrar Secrets Externas em nível de Organização.
• Como cadastrar Secrets Externas em nível de Workspace
• Como cadastrar Secrets Externas em nível de Perfil Pessoal

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

Features 

Alterar foto de perfil

Agora você pode adicionar ou atualizar sua foto de perfil no Portal da StackSpot.
Para mais detalhes, consulte o guia de Informações Pessoais.

Extensões Customizáveis

Agora a StackSpot disponibiliza Extensões Customizáveis no Portal EDP, permitindo maior flexibilidade e integração com ferramentas externas. Confira as principais funcionalidades:

1. Criação de Extensões:

   • Criação de extensões customizáveis para Organização ou Workspace.
   • Suporte para upload de arquivos .zip com varredura de segurança.

2. Ativação e desativação:

   • Extensões que podem ser ativadas ou desativadas diretamente no Portal.

3. Edição de Extensões:

   • Possibilidade de editar Nome, Nível, Descrição e substituir o arquivo.
   • O slug da extensão é imutável após a criação.

4. Deleção de Extensões:

   • Extensões podem ser deletadas, incluindo todas as suas versões.

5. Visualização e uso no Workspace:

   • Extensões ativas podem ser visualizadas e utilizadas por membros da Organização.

6. Integração com a StackSpot EDP:

   • Uso de uma biblioteca específica no npm para facilitar a integração: @stack-spot/portal-extension.

Para mais informações, consulte a guia da Conta ou o guia do Workspace

Fork do Plugin de Infraestrutura

A StackSpot EDP trouxe mais flexibilidade com o Fork de Plugins. Agora é possível fazer uma cópia dos arquivos de um Plugin de Infraestrutura para ter acesso aos arquivos Terraform, para que você tenha liberdade para editá-los e adicioná-los em seus projetos.

• Adição do mecanismo de “Fork” de Plugins, que cria uma cópia dos arquivos Terraform dos Plugins de Infraestrutura.
• Adição dos novos comandos para usar o Fork de Plugins:
  • stk fork plugin e stk unfork plugin;

Para mais informações, consulte a documentação de Fork de Plugin de Infraestrutura.

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

Features 

Nova página inicial do Portal StackSpot EDP

Confira as mudanças da nova página inicial do Portal StackSpot EDP:

Pensando em melhorar a sua experiência como pessoa usuária, a página inicial do Portal StackSpot EDP foi reformulada! Agora, você pode:

Visualizar seus principais itens de forma organizada:

• Acesse diretamente seus Estúdios, Aplicações e Workspaces na página inicial.
• Utilize filtros como Favoritos, Meus [itens] e Todos [itens] para encontrar rapidamente o que precisa.

Personalizar a página inicial:

• Reorganize a ordem dos grupos de itens.
• Escolha quais grupos deseja exibir na Home.

Aproveitar atalhos rápidos:

• Acesse facilmente o download da CLI, a documentação e o suporte.

Além disso, o menu principal foi revisado para tornar a navegação mais intuitiva, facilitando o acesso às funcionalidades para desenvolvedores e criadores.

Confira como utilizar e personalizar sua homepage

Novo Portal de Conta da StackSpot

Agora, a gestão de contas da StackSpot possui um novo domínio: https://myaccount.stackspot.com. Essa mudança visa melhorar a experiência do usuário, centralizando as configurações de perfil e organização em um ambiente mais intuitivo e organizado.

Principais mudanças:

• Novo domínio: após o login no StackSpot EDP ou AI, ao clicar na foto do perfil, o usuário será redirecionado para o novo domínio myaccount.stackspot.com em uma nova aba.

• Menu lateral simplificado: o menu foi reorganizado para facilitar a navegação, com dois itens principais:

  1. Meu Perfil: exibe informações do usuário logado, incluindo:

  • Roles (papéis);

  • Grupos de permissão;

  • Recursos acessíveis.

  2. Organização: exibe as configurações da organização, agora organizadas em três categorias:
  • Products: configurações específicas para os produtos EDP, Cloud Service e AI.
  • Identity & Security: inclui SSO, Histórico de Eventos e Credenciais de Serviço.
  • Access Management: gerenciamento de Usuários, Grupos de Permissão e Roles/Permissions.

Impacto na documentação:

O menu da documentação foi atualizado para refletir a nova organização do portal, garantindo consistência entre a interface do usuário e os guias disponíveis.

Para mais detalhes sobre as mudanças, confira as seções:

• Configurações de Perfil;
• Configurações da Organização.

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

STK CLI: v6.24.0

Nesta atualização, o STK CLI trouxe algumas novidades:

• Agora é possível usar um arquivo de especificação ao aplicar Plugins. A opção --spec foi adicionada ao comando stk apply plugin, onde você pode informar um arquivo YAML com todos os dados do Plugin, além de dados para os inputs e connections que o Plugin utiliza. Para saber mais detalhes de como usar o arquivo de especificação para Plugins, confira a documentação sobre o arquivo de especificação (spec file).

• Novo tipo de input textarea. Este novo input é uma semelhante ao tipo text (texto), mas permite que você use textos extensos sem comprometer a visualização dos espaçamentos e quebras de linhas. Esta novidade traz uma melhora na experiência do preenchimento de inputs que recebem valores mais estruturados como trechos de código.

• Melhoria no comando stk deploy plan. O comando agora valida se as Connections Interfaces selecionadas ou geradas existem no ambiente escolhido e na conta StackSpot utilizada. Esta melhoria evita que a pessoa desenvolvedora receba erros inesperados sobre Connections Interfaces indisponíveis no seu ambiente ou Conta.

• Atualização das versões suportadas do MacOS pelo STK CLI. Para mais informações, confira a página de Instalação com as novas versões do MacOS suportadas pelo STK CLI.

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

Features 

Remoção da Conta Personal da Plataforma StackSpot

O acesso à plataforma pelo login via GitHub (Conta Personal) foi descontinuado. A partir de agora, a StackSpot EDP oferece apenas o acesso à contas Enterprise.

Para mais informações, consulte a seção sobre como configurar e acessar uma conta Enterprise

Novo Tipo de Connection Interface: aws-vpc-endpoint-conn

Um novo Tipo de Connection Interface para VPC Endpoints foi adicionado: aws-vpc-endpoint-conn. Esse recurso permite conexões privadas entre serviços da AWS e recursos em uma VPC, sem a necessidade de um gateway de Internet.

Campos Principais:

• vpc_endpoint_id: O ID exclusivo do VPC Endpoint.
• vpc_endpoint_name: O nome do VPC Endpoint.
• dns_entry: A entrada DNS associada ao VPC Endpoint.

Para mais detalhes, consulte a seção de Connection Interface Type.

Atualização de versão de Stack no Workspace

Agora, é possível atualizar a versão de uma Stack no Workspace através de um botão. Ao clicar nele, uma nova versão de Stack é disponibilizada para ser utilizada no Workspace. Confira mais detalhes nesta página.

STK CLI: v6.21.0

• Suporte adicionado para Java na funcionalidade de Code Transformation.
• Agora é possível criar uma Stack a partir de outra usando um intervalo (range).
• Novos comandos para criação, listagem, validação, publicação e execução de workflows na StackSpot;
• Adicionado um novo tipo de input: generated-connection;
• Correções de bugs e melhorias internas.

STK CLI: v6.22.0

Nesta atualização o STK CLI trouxe algumas novidades:

• Agora é possível gerar arquivos Terraform de Plugins de Infraestrutura localmente, usando as informações de Connections do seu Workspace. Foi adicionada a opção --deploy que permite que você teste o que o seu Plugin de Infraestrutura vai renderizar. Veja mais informações sobre como aplicar um Plugin de Infraestrutura.

• Foi implementado o aviso de quebra de versão para Actions e Plugins com a adição do parâmetro --studio. Este parâmetro recebe o slug do Estúdio (Nome do registro do Estúdio) onde o conteúdo será publicado e emite um alerta caso ocorra alguma quebra de versão. Os seguintes comandos receberam este parâmetro:

  • stk validate action
  • stk validate plugin

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

Features 

Variáveis de Contexto agora se chamam Variáveis da Conta: confira as diferenças e novidades

As Variáveis de Contexto agora são chamadas de Variáveis da Conta, com mudanças que simplificam o uso e a configuração de respostas para Inputs dentro da StackSpot.

O que são as Variáveis da Conta?

Na StackSpot, as Variáveis da Conta foram criadas para facilitar o trabalho dos desenvolvedores ao reduzir a repetição de respostas para Inputs durante a configuração de Stacks, Plugins e Actions. Essas Variáveis são criadas e pré-configuradas pelos Account Holders ou Administradores da Conta para que as respostas repetitivas para Inputs não precisem ser inseridas manualmente toda vez.

Por que usar Variáveis da Conta?

Essas variáveis permitem a criação de um nome amigável para referenciar valores reutilizáveis em várias partes da StackSpot, como Plugins, Actions, Aplicações e Infraestruturas. Isso centraliza a gestão desses valores, tornando atualizações rápidas e eficientes.

Como as Variáveis da Conta funcionam?

As Variáveis da Conta são interpoladas em ações como a aplicação de Plugins, execução de Actions, criação de Infraestruturas e Workflows, simplificando e automatizando as operações dentro da StackSpot. Essa melhoria visa proporcionar mais flexibilidade e evitar erros, permitindo que você configure respostas de maneira rápida e eficiente em toda a sua StackSpot.

Para mais detalhes, confira as seções:

• Como criar Variáveis da Conta
• Como gerenciar Variáveis da Conta
• Como configurar Contexto a nível de Conta utilizando Variáveis
• Como configurar Contexto a nível de Workspace utilizando Variáveis
• Como preencher inputs com Variáveis na criação de Plugins e Actions
• Como preencher inputs com Variáveis na criação de Aplicações e Infraestruturas via Portal StackSpot EDP
• Como preencher inputs com Variáveis na Criação de Aplicações via STK CLI
• Como preencher inputs com Variáveis na Criação de Infraestruturas via STK CLI

Suporte a Nunjucks para Expressões Jinja

Agora o Portal da StackSpot suporta Nunjucks, uma engine de templates que amplia as capacidades das expressões Jinja. Isso permite maior flexibilidade na criação de Plugins e Actions, mantendo a familiaridade com a sintaxe Jinja ({{ ... }} para variáveis e {% ... %} para controle de fluxo). No entanto, Nunjucks não oferece todos os recursos do Jinja, especialmente aqueles que dependem de funcionalidades nativas do Python.

• Exemplo de uso: computed-inputs no Portal durante a criação de Aplicações ou Infraestruturas.

• Compatibilidade: funciona tanto na CLI quanto no Portal da StackSpot.

Para verificar possíveis incompatibilidades, utilize este codepen. Para mais detalhes, confira o FAQ oficial do Nunjucks.

Nova forma de configurar Single Sign-On (SSO) e nova funcionalidade de Mapeamento de Grupos:

A configuração do SSO na sua conta foi atualizada. Entre as mudanças, estão o preenchimento dos formulários e a configuração do Mapeamento de Grupos.

Confira mais detalhes sobre as mudanças e a nova funcionalidade em:

• Configurar SSO
• Mapeamento de Grupos

STK CLI: v6.20.0

• Suporte adicionado para variáveis de conta.
• Nova feature para testar Starters, agora com suporte ao input do tipo required-connection;.
• Correções de bugs e melhorias internas.

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

Features 

Insights de Uso

Visualize o uso de Plugins, Stacks e Starters em suas Aplicações e Infraestruturas. Acesse dados sobre versões, conteúdos vinculados, Workspaces onde as versões estão em uso e aqueles em que não estão mais sendo utilizadas e mais.

Para mais detalhes, confira as seções abaixo:

• Visualizar uso de Plugins
• Visualizar uso de Stacks

Possibilidade de configurar Contexto para inputs complexos

Agora você pode configurar Contexto para inputs do tipo required-connection, liste object.

Confira mais detalhes nas seções:

• Configurar Contexto de Conta
• Configurar Contexto de Workspace
• Inputs

STK CLI: v6.19.0

• Novos comandos para registrar o deploy e o destroy de um app fora da StackSpot.
• Adicionado o comando stk diff state, que exibe as diferenças entre o estado atual de um app/infra e o último deploy realizado;
• Suporte adicionado para novos tipos de input: list, object e required-connection;
• Correções de bugs e melhorias internas.

Para quem cria Conteúdo

• Nova Estrutura de Inputs e Connection Interface: agora você pode adicionar a nova estrutura de inputs e a Connection Interface requerida em um novo manifesto v3. Para mais detalhes, confira as seções:

  • Migrar v2 para v3
  • Novos tipos de inputs:
    • list
    • object
    • required-connection (antigo spec.requires.connection)

• Confira as seções que também foram alteradas:

• Criar Plugin

• Criar Actions

• Arquivos yaml

• Inputs Avançados

• Usar Jinja

Para quem usa o Conteúdo

• Novas Telas de Inputs no Portal: se você utiliza o conteúdo para criar Aplicações ou Infraestruturas, agora verá novas telas de inputs nos campos do Portal. Confira mais detalhes nas seções:
  • Como criar Aplicação no Portal
  • Como criar uma Infraestrutura no Portal

Novos comandos stk register-deploy e stk register-destroy para acompanhar workflows

Agora você pode acompanhar os workflows de deploy e destroy de Aplicações realizados via pipeline na Plataforma StackSpot.

Para mais detalhes, confira as seções:

• Registrar Deploy de uma Aplicação
• Registrar Destroy de uma Aplicação

STK CLI: v6.18.0

• Adição de novos tipos de inputs: list, object e required-connection.
• Adição do guia de migração para o novo esquema v3 para suportar o uso de inputs required-connection.
• Novas atualizações no tipo de input de senha.
• Adição de etiqueta deprecta nos guias de migração antigos.
• Novos exemplos complexos dos novos inputs.
• Novo exemplo de required-connection no novo guia de migração (v3).
• Correção dos exemplos com o uso obsoleto de text+items (lista de texto).
• Novos comandos de registro de atividades da Aplicação, como deploys e rollbacks.
• Novo comando de deletar a Aplicação.

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

Features

• Nova forma de configuração de Workflows e criação de Workflow Padrão: A forma de configurar Workflows no Portal StackSpot mudou. Agora você pode configurar:

  • Workflow Default (padrão) para toda a Conta;
  • Workflows para Stacks específicas, que não utilizarão o Workflow padrão da Conta;

Além disso, você pode criar Workflows para os diferentes fluxos feitos dentro do Workspace, sendo eles:

• Criar Aplicação;
• Criar Infraestrutura;
• Criar APIs.

Confira detalhes nas páginas:

• Configurar Workflow

• Configurar Contexto de Workflow na Stack dentro da Conta

• Configurar Contexto de Workflow na Stack dentro do Workspace

• Alteração de versão de conteúdo na Stack: agora é possível alterar a versão de um Plugin e Action em uma Stack não publicada, sem que seja necessário despublicar a versão atual e publicá-la novamente. Para mais detalhes, confira um exemplo.

• Autenticação via OTP no Portal StackSpot: Agora, para acessar o Portal StackSpot, é necessário não apenas uma senha, mas também um código de autenticação gerado por um OTP (one-time-password) Authenticator. OTP é uma senha com data de validade limitada gerada automaticamente por um sistema, como o Google Authenticator.

Esta segunda camada de autenticação fortalece a segurança da sua Conta.

Para mais detalhes, confira a seção de Autenticação via OTP.

• API de Sistema de Gerenciamento de Identidade entre Domínios (System for Cross-domain Identity Management - SCIM): esta nova feature, você pode executar as atividades de Gerenciamento de Acessos feitas dentro do Portal StackSpot EDP, porém por meio de métodos HTTP (GET, POST, PUT, PATCH, DELETE).

Confira detalhes na seção SCIM Provider API.

• Visualização de erros no deployment: agora é possível inspecionar os logs de erro do deploy de um Plugin no Portal da StackSpot. Para usuários do Self-hosted, essa visualização será feita na pipeline do GitHub. Os demais usuários podem visualizar os logs nas seções de Atividades e Infraestrutura, disponíveis no Workspace. Para mais detalhes, confira as páginas:

  • Página de Infraestrutura
  • Visualização dos logs em Atividades
  • Acompanhar o status do deploy em Self-Hosted

Melhorias e Correções

• Acessibilidade na documentação: adição de mais regras de acessibilidade em documentações de conteúdos publicados na StackSpot. Para mais detalhes, confira a seção da documentação.
• Recomendação de retries em no Self-Hosted de Runtime: devido ao não funcionamento de retries parciais de Workflow do GitHub Actions na pipeline do Self-Hosted, agora a recomendação é fazer retries do Workflow completo. Para mais detalhes, confira a seção da documentação.

STK CLI: v6.16.0

• Introduzido o novo comando stk diff state para comparar alterações de deployment entre ambientes.
• Atualização da engine do code-transformation para a versão 0.2.0. Esta nova versão introduz suporte a html, operadores de match de identificadores, strings e suporte ao escopo de snippet.
• Download de imagens da Stack usando o parâmetro --from.
• Adição de novas respostas de código à Action de publicação do Plugin.
• Adição do novo status "aborting" para melhorar o gerenciamento de processos.
• Adição da validação para Stacks sem Starters.
• Adição da verificação para todos os Plugins opcionais por padrão na criação de Aplicação ou Infraestrutura.
• Validação das dependências de Connections antes de remover o Plugin.
• Melhoria para que os Plugins com o mesmo nome não apareçam durante a remoção.
• Melhoria a manipulação de erros para external items.
• Correção de problema relacionados à prioridade de contexto obrigatório para Actions de workflow.
• Correção do comportamento padrão das opções de multiselect.
• Correção do processo de confirmação antes de destruir uma Aplicação ou Infraestrutura.
• Removido o parâmetro picture do plugin.yaml inicial.
• Adicionado suporte para selecionar uma Base de Conhecimento (Knowledge Source) no comando stk ai.
• Renomeada a entidade Infraestrutura Compartilhada (Shared Infrastructure) para Infraestrutura (Infrastructure).

STK CLI: v6.15.0

• Novo modo interativo para o comando stk show plugin.
• Atualização do comando stk show plugin para buscar a versão mais recente.
• Correção do Multi Select, permitindo valores em branco.
• Correção do comando update plugin para lidar corretamente com cancelamentos de usuários.
• Correção do suporte para valores padrão de entradas de seleção.

STK CLI: v6.14.0

Atualize seu STK CLI executando o comando stk upgrade

• Possibilidade de listar Plugins, Actions, Stacks e Starter dentro ou fora do Workspace.
• Você pode fazer Teste de Starters

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

Features

• Criação de Variáveis de Contexto: Agora é possível criar Variáveis de contexto de forma simples e intuitiva através do Portal StackSpot EDP. Com acesso facilitado através de um menu na barra lateral, os usuários com as permissões adequadas podem criar Variáveis diretamente nos Workspaces.

  Benefícios:

  • Reduz a carga cognitiva ao automatizar processos de input;
  • Aumenta a produtividade ao permitir o aproveitamento eficiente de informações cotidianas; e
  • Controle inteligente de permissões, garantindo segurança e privacidade dos dados.

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

Features

• Novos contratos de Connection Interface Types: foram criados 4 contratos e outputs de Connection Interface Types. Para conferir quais são, acesse a página de Connection Interface.

• Troubleshooting do STK CLI: agora é possível conferir os principais erros do CLI e as respectivas soluções deles.

• Teste de Starter: Nova adição na ferramenta de testes da StackSpot. Agora além do teste de Plugins, é possível criar e executar testes unitários para os seus Starters

• Nova página com guias para utilizar Plugins com requisitos em seu projeto: Nova funcionalidade implementada e com um conteúdo mais detalhado sobre como usar Plugins com requisitos.

• Novos comandos para o STK CLI:

  • stk config locale: novo comando para configurar o idioma exibido pelo STK CLI no seu terminal.
  • stk show plugin: novo comando para detalhar as informações de um Plugin, como o nome, descrição, inputs, actions e connections utilizadas.

• Convidar membros para compartilhar conteúdo no Portal StackSpot AI: esta nova função permite que você convide novos membros para se juntarem à StackSpot diretamente da plataforma. Além disso, você também pode convidar outros usuários para colaborar na mesma conta. Confira todas as informações sobre convidar membros na documentação da StackSpot AI.

• Possibilidade de reexecutar Workflow de criação de Aplicações e Infraestruturas em caso de erro: Agora, se ocorrer um erro durante a criação de sua Aplicação ou Infraestrutura no Workspace, você pode corrigi-lo e reexecutar o Workflow através do Portal StackSpot. Confira detalhes nas seções:

  • Criar Aplicação;
  • Criar Infraestruturas.

• Atualização de Contexto automática: se alguém publicar uma nova versão da Stack adicionada à sua Conta ou Workspace, o contexto deve ser configurado novamente. Você pode fazer isso de forma automática, apenas importando os valores da versão da Stack que você já tinha configurado previamente. Confira como fazer isso nas seguintes seções:

  • Configurar Contexto na Conta
  • Configurar Contexto no Workspace

• Criação de Starters com Plugin de Infraestrutura: agora, além de Plugins do tipo App, é possível criar Starters com Plugins de Infraestrutura. Confira mais detalhes na página de Starter.

• Você pode editar parâmetros de Connection Interface criada manualmente: Agora, você pode editar os parâmetros das Connection Interfaces manuais mesmo depois de criá-las.

• Possibilidade de deletar Connection Interface criada manualmente: Agora, você pode deletar completamente uma Connection Interface que você criou manualmente.

• Possibilidade de criar Infraestrutura utilizando Starter de Infra via Portal EDP da StackSpot: Agora, existe a possibilidade de criar Starters de Infra, com isso, você também pode utilizá-los para criar Infraestruturas.

STK CLI

• Adição do tipo infra no arquivo starter.yaml.
• Adição da capacidade de criar Aplicações e Infraestruturas através de um Starter local em sua máquina utilizando o STK CLI.
• Revisão das etapas de criação da Stack e Starter pelo STK CLI

Melhorias e Correções

• Atualização dos comandos stk update app e stk update infra: Agora é possível atualizar de forma mais simples as informações de Aplicações e Infraestruturas. Confira mais detalhes nas páginas dos respectivos comandos, stk update app e stk update infra.

• Melhoria do comado stk remove plugin: Agora a remoção dos Plugins de uma Infraestrutura respeitam as regras de Plugins que dependem de outros. Caso você remova um Plugin que dependa de outro, o STK CLI irá avisá-lo.

• Acesso ao SCM renomeado para Conexões Externas:

  • A seção "Acesso ao SCM" foi renomeada para "Conexões Externas" para maior clareza e consistência.
  • Agora você encontrará configurações individuais relacionadas ao SCM na seção "Conexões Externas".

• Remoção da Configuração do Token de Perfil Pessoal:

  • A opção de configuração para tokens de perfil pessoal dentro da seção "Token de Acesso" foi removida.

• Correções nas descrições das flags dos comandos de criação de Stack, Plugin, Action, Aplicação e Infraestrutura.

• Novo parâmetro local-exec no Self-Hosted: o novo parâmetro local-exec indica, através de true ou false, se o Self-Hosted de Runtime será liberado para uso. Confira a página da funcionalidade.