Versionamento de Cápsulas

Saiba mais sobre como as Cápsulas são versionadas na Digibee Integration Platform.

As Cápsulas possuem um controle de versão composto por 3 níveis representados por: 1.0.0. O primeiro número é denominado “Major”, o segundo número é denominado “Minor” e o terceiro número é denominado “Fix”.

Quando as versões precisam ser atualizadas, a Digibee Integration Platform analisa automaticamente a Cápsula após cada alteração para determinar os níveis da versão.

Veja como são determinados os níveis:

• Fix: versão da Cápsula quando a alteração não afetar os pipelines que a utilizam. Incrementa o valor do Fix em 1 (0.0.1).

• Minor: versão da Cápsula quando um item de configuração (entrada ou saída) é adicionado ou se torna opcional. Incrementa o valor do Minor em 1 (0.1.0).

• Major: versão da Cápsula quando um item de configuração (entrada ou saída) é excluído ou se torna obrigatório. Esta versão também é aplicável quando o contrato da Cápsula for completamente alterado. Incrementa o valor do Major em 1 (1.0.0).

Estas alterações só são feitas se a versão alterada já tiver sido publicada. Por exemplo, se você criar uma Cápsula, ela receberá inicialmente a versão "1.0.0". Se você não publicar, esta versão nunca será alterada, independentemente de você fazer atualizações na Cápsula ou não.

Depois de publicar a Cápsula, a versão “1.0.0” é definida como não editável. Quando uma nova atualização é feita na mesma Cápsula, a plataforma verifica o que foi alterado para determinar se o número da versão deve ser incrementado em Major, Minor ou Fix.

O número da versão é exibido próximo ao nome da Cápsula.

Version diff viewer (Comparação de versões de Cápsulas)

Uma mudança significativa em uma cápsula pode afetar dezenas de pipelines dependentes. Para facilitar o troubleshooting e code review, a ferramenta Visual Diff permite comparar duas versões publicadas de uma cápsula lado a lado.

1. Acesse a página de Build, abra a aba Cápsulas e localize a cápsula que deseja comparar versões.

2. No menu de três pontos, selecione Abrir diff de versões.

Esta opção está disponível apenas para cápsulas publicadas.

1. Selecione as versões da Cápsula que você deseja comparar:

   • A versão mais recente fica no lado esquerdo.

   • A versão mais antiga fica no lado direito.

Cápsulas em desenvolvimento (não publicadas) também estão disponíveis como opções selecionáveis.

1. Clique em cada etapa individualmente para visualizar as mudanças nas configurações. Etapas adicionadas ou removidas são destacadas por cores: verde para adições, vermelho para remoções e amarelo para modificações.

Cada etapa individual exibe as alterações de configuração da Cápsula, de acordo com cada aba na parte superior da página:

• Fluxo: Mostra as modificações nas etapas do fluxo.

• Configuração: Mostra as alterações de parâmetros para cada conector no fluxo.

• Saída: Destaca os campos adicionados/removidos, as alterações de tipo e as alterações de campos obrigatórios no JSON Schema.

• Documentação: Mostra as modificações de texto no conteúdo da documentação interna mantida pelo construtor da Cápsula.