 |
This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Introducción
Los paquetes de extensiones de Checkmk (MKP ) pueden empaquetar extensiones funcionales y para la interfaz gráfica de usuario (GUI), es decir, dashboards, vistas o informes. La ventaja de esta función es que, en las ediciones comerciales, puedes crear estos MKP directamente desde la interfaz web, sin necesidad de archivos ni herramientas externas. Por supuesto, la línea de comandos también está disponible para este fin, también exclusivamente en las ediciones comerciales.
A continuación, los MKP pueden compartirse internamente con otros usuarios e instalaciones de Checkmk y, por supuesto, a través de Checkmk Exchange. Pero incluso sin la participación de la comunidad o de otros sites, puede ser útil poder empaquetar creaciones complejas.
Por ejemplo, si se crea un dashboard utilizando la opción Make this dashboard available for other users, también estará disponible para todos los usuarios o para los seleccionados. Si los usuarios borran sus dashboards en algún momento, por supuesto se pierden para todos los demás, a menos que otros ya hayan hecho copias personales. Por eso tiene sentido que los usuarios con los derechos adecuados hagan que los dashboards estén disponibles como una extensión.
Esto también permite versionar los dashboards, lo que resulta útil para actualizarlos sin problemas.
El procedimiento para crear MKPs es idéntico para todos los tipos de extensiones GUI, por lo que nos limitaremos al ejemplo del dashboard descrito a continuación.
Requisitos previos: Los usuarios necesitan el permiso Manage Extension Packages (MKPs).
2. Interfaz web
2.1. Crear GUI-MKP
Empecemos en la lista de dashboards en Customize > Visualization > Dashboards. Si ya has creado tu propio dashboard, puedes trabajar con él. Si no, crea una copia privada de cualquier dashboard integrado. En ambos casos, tu punto de partida es un dashboard en la sección Customized.
A través de Clone this dashboard for packaging as extension package creas una extensión desde el dashboard, que posteriormente aparecerá en la lista de la sección Extensions:
Desde aquí, Go to extension packages te llevará al administrador de paquetes de extensiones. Puedes ver tus extensiones sin empaquetar, o archivos, en Packages > List unpackaged files.
A través de Create Package puedes crear ahora el paquete.
En las propiedades del paquete, en la parte inferior, bajo Packaged files, añade la extensión GUI que acabas de crear. Por supuesto, también puede tratarse de varios dashboards u otros elementos. Por lo demás, lo principal a lo que debes prestar atención es a la información correcta sobre la versión. En primer lugar, el paquete en sí necesita un número de versión.
Éste debe seguir las directrices explicadas en Versionado semántico, por ejemplo 1.0.0. En segundo lugar, puedes especificar las versiones mínima y máxima admitidas de Checkmk. El versionado es útil para las actualizaciones de Checkmk y la monitorización distribuida, que incluye sites con diferentes versiones de Checkmk (para más información, consulta el artículo MKP ).
Después de empaquetar, tus nuevos paquetes aparecerán en la lista de la página principal de paquetes de extensión - aquí en nuestro ejemplo en dos versiones diferentes, una activada y otra desactivada:
En All packages (enabled or disabled) tienes ahora la opción de descargar los paquetes como archivos MKP.
2.2. Instalación de GUI-MKP
La instalación de paquetes se explica por sí misma. Primero, sube el paquete deseado a través de Upload package en Setup > Maintenance > Extension packages.
A continuación, el paquete acaba de nuevo en la tabla All packages (enabled or disabled) y desde allí se puede activar a través de .
3. Línea de comando
3.1. Creación de GUI-MKP
Como alternativa, también puedes realizar el empaquetado desde la línea de comandos. El procedimiento es exactamente el mismo que para empaquetar extensiones funcionales, tal y como se describe detalladamente en el artículo MKP, por lo que aquí sólo se presenta una versión abreviada:
Crea el dashboard.
Pasa a la línea de comandos como usuario del site.
Lista los archivos sin empaquetar:
mkp findCrea la configuración del paquete:
mkp template mydashboardEdita la configuración en:
~/tmp/check_mk/mydashboard.manifest.tempCrea el paquete con:
mkp package tmp/check_mk/mydashboard.manifest.tempEl paquete se guarda como:
/var/check_mk/packages_local/mydashboard-1.0.0.mkp
3.2. Instalar GUI-MKPs
Si ahora quieres instalar y activar esos MKPs:
Instala:
mkp add /tmp/mydashboard-1.0.0.mkpActivar:
mkp enable mydashboard-1.0.0.mkp
Para obtener referencias de comandos, una descripción del formato MKP y otras notas, consulta el artículo MKP.
Nota para los usuarios de Checkmk Raw: Una vez más, puedes instalar extensiones GUI como todos los demás MKP. Sin embargo, dado que las ediciones comerciales contienen algunos elementos visuales exclusivos (como dashlets), es posible que te encuentres con un mensaje del tipo siguiente:
Dashlet type 'state_host' could not be found. Please remove it from your dashboard configuration.
En este caso falta un dashlet, pero el resto del dashboard sigue siendo utilizable.
4. Archivos y directorios
| Ruta del archivo | Descripción |
|---|---|
|
Depósito para vistas de tabla clonadas como extensiones. |
|
Ubicación para los informes clonados como extensiones. |
|
Ubicación de los dashboards clonados como extensiones. |
|
Fichero de configuración para construir el paquete. |
|
Ubicación de los MKP instalados. |
|
Ubicación de los MKP activados. |