 |
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 extensión de Checkmk ( MKP) pueden empaquetar extensiones funcionales así como aquellas para la interfaz de usuario gráfica (GUI), es decir, dashboards, vistas o informes. La ventaja de esta característica es que en las ediciones comerciales puede crear dichos MKP directamente desde la interfaz web, y no se necesitan archivos o herramientas externas. Por supuesto, la línea de comandos también está disponible para este propósito, 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 resultar ú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 apropiados hagan que los dashboards estén disponibles como una extensión.
Esto también permite el versionado de dashboards - útil para actualizaciones sin problemas.
El procedimiento para crear MKPs es idéntico para todos los tipos de extensiones GUI, por lo que nos limitaremos al ejemplo de dashboard descrito a continuación.
Requisitos previos: Los usuarios necesitan el permiso Manage Extension Packages (MKPs).
2. Interfaz web
2.1. Creación de GUI-MKPs
Empecemos en la lista de dashboards en Customize > Visualization > Dashboards. Si ya has creado tu propio dashboard, puedes trabajar con ese. 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 a partir del 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 o archivos sin empaquetar en Packages > List unpackaged files.
A través de Create Package puede ahora crear 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 pueden ser varios dashboards u otros elementos. Por lo demás, lo principal a lo que tienes que prestar atención es a la información correcta de 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, puede 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 (consulte el artículo MKP para obtener más información).
Después de empaquetar, sus 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) tiene ahora la opción de descargar los paquetes como archivos MKP.
2.2. Instalación de GUI-MKPs
La instalación de los paquetes se explica por sí misma. En primer lugar, cargue el paquete deseado a través de Upload package en Setup > Maintenance > Extension packages.
A continuación, el paquete termina de nuevo en la tabla All packages (enabled or disabled) y desde allí se puede activar a través de .
3. Línea de comandos
3.1. Creación de GUI-MKPs
Como alternativa, también puede realizar el empaquetado desde la línea de comandos. El procedimiento es exactamente el mismo que el empaquetado de extensiones funcionales, tal y como se describe en detalle en el artículo MKP, por lo que aquí sólo se presenta una versión abreviada:
Cree el dashboard.
Cambie a la línea de comando como usuario del site.
Lista de archivos sin empaquetar:
mkp findCrear la configuración del paquete:
mkp template mydashboardEditar la configuración en:
~/tmp/check_mk/mydashboard.manifest.tempCrear 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. Instalación de GUI-MKPs
Si ahora desea instalar y activar dichos MKPs:
Instalar:
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, consulte el artículo MKP.
Nota para los usuarios de Raw Edition: Una vez más, puede instalar extensiones GUI al igual que todos los demás MKP. Sin embargo, dado que las ediciones comerciales contienen algunos elementos visuales exclusivos (como dashlets), es posible que se encuentre 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 solo dashlet, pero el resto del dashboard sigue siendo utilizable.
4. Archivos y directorios
| Ruta del fichero | Descripción |
|---|---|
|
Depósito para vistas de tabla clonadas como extensiones. |
|
Ubicación para los informes clonados como extensiones. |
|
Ubicación para dashboards clonados como extensiones. |
|
Fichero de configuración para construir el paquete. |
|
Ubicación de los MKP instalados. |
|
Ubicación para MKPs activados. |
