Micro, manifiesto y stack
Microservicio (micro)
Sección titulada «Microservicio (micro)»Un micro es un repositorio arrancable. En MicroLab lo añades una vez —eligiendo su carpeta o clonándolo desde Git— y a partir de ahí se describe con un manifiesto que MicroLab genera por ti.
Manifiesto
Sección titulada «Manifiesto»El manifiesto es la descripción de cómo arrancar un micro: su tecnología, sus
puertos, la infraestructura que necesita, sus dependencias a otros cores y su receta
de arranque. MicroLab lo autodetecta al añadir el micro (a partir de ficheros como
pom.xml, application.yml o package.json); tú solo lo revisas.
El manifiesto es portable: la ruta al repo se guarda relativa al espacio de trabajo, no absoluta, para que valga entre máquinas. Se puede editar desde la app (sección Micros) o desde el CLI.
Si cambias de rama en el repo, sus puertos o dependencias pueden variar; MicroLab lo detecta (drift) y ofrece actualizar el manifiesto desde el repositorio conservando lo que hayas curado a mano. Ver Cambiar de rama y drift.
El stack es la tecnología del micro. Hoy MicroLab soporta:
quarkus · spring-boot · node · angular · python
El stack determina tres cosas: cómo se arranca el micro (su comando), dónde
está su health (para saber cuándo está sano) y cómo se le inyecta la
configuración (propiedades de sistema -D en la familia JVM, variables de entorno
en Node/Python, etc.).
Ese conocimiento vive en un registro de perfiles por tecnología dentro de
MicroLab, no en el manifiesto: el manifiesto solo declara stack.kind (quarkus,
node…) y, si hace falta, algún ajuste puntual. Añadir soporte para una tecnología
nueva es añadir un perfil, no reescribir nada de tus micros.