Pular para o conteúdo
Aseptic Aseptic

Partilhar um cenário com um colega

Objetivo: passar um cenário reproduzível a outra pessoa sem sobrepor o seu catálogo.

Exportar

Seção intitulada “Exportar”

A partir do menu do cenário (ou Definições para o catálogo completo), Exportar gera um ficheiro autónomo <cenário>.aseptic.yml com:

  • O cenário.
  • Os manifestos dos seus micros (com o ramo em que está cada repo).
  • Os mocks referenciados.
  • Opcionalmente, a configuração de arranque de cada micro (ative o interruptor «Incluir a configuração de arranque»), saneada: as credenciais viajam como referência ${creds.x} e os caminhos absolutos são omitidos.

O seu settings.local.yml e o estado de .runtime/ não viajam.

Importar

Seção intitulada “Importar”

Na outra máquina, Importar cenários abre um diálogo de reconciliação: a importação nunca sobrepõe a bruto, resolve conflito a conflito com a opção recomendada pré-selecionada.

O diálogo avança por passos —Cenário, Serviços, Mocks e arranque, Ambiente e Resumo— e salta os que não têm nada para decidir. Os passos já feitos podem reabrir-se; o botão de importar está no último.

  • Um cenário que já existe entra como cópia (nunca é sobreposto).
  • Um manifesto que difere: conservar local (predefinido), usar o entrante, ou ver o diff.
  • Os mocks: união por endpoint+variante.

Se faltarem repos referenciados no espaço de trabalho, o Aseptic avisa: o cenário é importado, mas não arrancará até os clonar.

Se o cenário precisar de infraestrutura que o docker-compose.yml desta máquina não declara (um Redis, um Kafka), o passo Ambiente também o diz, com o excerto de YAML que a cobre pronto a colar. O Aseptic não escreve o compose: costuma ser da equipa e viver noutro repositório.

A partir do CLI

Seção intitulada “A partir do CLI”

aseptic scenario export <nome> [--include-run] e aseptic scenario import <ficheiro> [--apply] [políticas] (sem --apply imprime o plano de conflitos).

Quando se partilha muitas vezes, o ficheiro atrapalha

Seção intitulada “Quando se partilha muitas vezes, o ficheiro atrapalha”

Passar um ficheiro serve para uma vez. Se a equipa troca cenários com regularidade, o que faz falta é um catálogo de equipa: o cenário publica-se uma vez e cada um adota-o quando precisa, vendo antes o que falta na sua máquina.

Ver também

Seção intitulada “Ver também”