Ir al contenido
mikroscope

Versiones

La versión actual de mikroscope es la 1.6.1, publicada el . Las dos se leen al compilar del fichero VERSION del repositorio y del encabezado con fecha que esa versión tiene en CHANGELOG.md, y el sitio no compila si falta ese encabezado. La versión va compilada en los dos binarios y es lo que devuelve mikroscope version, y la llevan las órdenes de instalación de todas las páginas.

Historial de versiones

Sección titulada «Historial de versiones»
  • CHANGELOG.md tiene una sección por versión, la más reciente primero, en el formato de Keep a Changelog, en inglés. Sus encabezados llevan fecha desde la 1.1.0.
  • Las versiones de GitHub tienen las notas, los archivos, los tar de imagen, las sumas de comprobación, las firmas y los SBOM de cada etiqueta.
  • El feed de versiones es la misma lista en Atom, para un lector de feeds.

Los números de versión siguen Semantic Versioning 2.0.0, como dice el changelog. Las guías describen la versión actual; qué cambió entre versiones, y cuándo, está en el changelog.

No todos los números tienen release propia:

Versión Etiqueta y release Sus cambios salen en Sección en el changelog
1.0.5 nunca se etiquetó v1.0.7 sí
1.0.6 se etiquetó; su ejecución de release falló v1.0.7 sí
1.0.8 nunca se etiquetó v1.0.9 sí
1.0.10 nunca se etiquetó v1.1.0 ninguna

Ficheros publicados

Sección titulada «Ficheros publicados»

Una etiqueta v* lanza la configuración de GoReleaser, .goreleaser.yaml, que publica:

  • Archivos de la CLI para linux y freebsd en amd64, arm64 y arm (ARMv7), y para darwin y windows en amd64 y arm64: .tar.gz, y .zip en Windows, cada uno con la licencia MIT, LICENSE, y README.md.
  • Archivos del agente para linux en amd64, arm64, armv5 y armv7, para quien quiera el binario pelado en lugar de una imagen.
  • Tar de imagen del agente para cargar a mano, cuatro: mikroscope-agent-arm64.tar, mikroscope-agent-armv5.tar, mikroscope-agent-armv7.tar y mikroscope-agent-amd64.tar. El ARM de 32 bits son dos porque las placas EN7562CT solo aceptan v5. install --agent-tar sube uno al router.
  • La imagen del agente en dos registros, jmrplens/mikroscope-agent:1.6.1 en Docker Hub y ghcr.io/jmrplens/mikroscope-agent:1.6.1 en GHCR (también con la etiqueta latest), cada una un único manifiesto sobre linux/amd64, linux/arm64, linux/arm/v7 y linux/arm/v5, que install --remote-image hace descargar al router. mikroscope envía la referencia entera, con el host del registro incluido (registry-1.docker.io/… para Docker Hub), así que el ajuste global /container/config registry-url ni hace falta ni se escribe, y Docker Hub sirve la imagen sin login de registro. Hasta la 1.2.2 el host se dejaba a registry-url, cuyo valor por defecto en RouterOS no siempre ha sido Docker Hub.
  • La imagen del colector, desde la 1.1.0, jmrplens/mikroscope:1.6.1 en Docker Hub y ghcr.io/jmrplens/mikroscope:1.6.1 en GHCR (también con la etiqueta latest), sobre linux/amd64 y linux/arm64, para los stacks de compose de la carpeta deploy/.
  • checksums.txt, que cubre todos los archivos y todos los tar de imagen del agente, una firma cosign sin claves sobre él y un SBOM SPDX por archivo, firmado a su vez. Verificar la descarga tiene las órdenes.

Instalar desde una versión publicada no necesita ni toolchain de Go ni copia del repositorio. Con una copia del repositorio y Go 1.27 se instala en cambio un agente compilado desde tu propio árbol: make build para la CLI y make build-agent para el agente, que install e image compilan también por su cuenta. Métodos de instalación compara las maneras de llevar el agente a un router y lo que necesita cada una.

Las compilaciones para linux/arm/v5, linux/arm/v7 y linux/amd64 son cruzadas y se comprueban en CI. Qué compilaciones se han ejecutado en hardware, y en qué router, está en Probado en.

Escrito y mantenido por José Manuel Requena Plens (jmrplens)GitHub