From c13adc0b926cd706e5722b8caecc5e4b766affd9 Mon Sep 17 00:00:00 2001 From: groales Date: Fri, 5 Dec 2025 10:16:00 +0100 Subject: [PATCH] =?UTF-8?q?A=C3=B1adir=20secci=C3=B3n=20de=20despliegue=20?= =?UTF-8?q?con=20Docker=20CLI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) diff --git a/README.md b/README.md index 2f6f518..b76a4f1 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,94 @@ DOMAIN_HOST=checkmk.tudominio.com --- +## Despliegue con Docker CLI + +Si prefieres trabajar desde la línea de comandos: + +### 1. Clonar el repositorio + +```bash +git clone https://git.ictiberia.com/groales/checkmk.git +cd checkmk +``` + +### 2. Generar contraseña + +Contraseña para el usuario `cmkadmin`: + +```bash +openssl rand -base64 32 +``` + +### 3. Elegir modo de despliegue + +#### Opción A: Traefik (recomendado para producción) + +```bash +cp docker-compose.override.traefik.yml.example docker-compose.override.yml +cp .env.example .env +nano .env # Editar: pegar CMK_PASSWORD, configurar DOMAIN_HOST +``` + +#### Opción B: Nginx Proxy Manager + +```bash +cp .env.example .env +nano .env # Editar: pegar CMK_PASSWORD, configurar DOMAIN_HOST +``` + +### 4. Iniciar el servicio + +```bash +docker compose up -d +``` + +⏱️ La inicialización puede tardar **2-3 minutos** (creación del site, configuración OMD). + +### 5. Verificar el despliegue + +```bash +# Ver logs en tiempo real +docker compose logs -f checkmk + +# Verificar contenedores activos +docker compose ps + +# Verificar estado del site CheckMK +docker compose exec checkmk omd status + +# Listar sites disponibles +docker compose exec checkmk omd sites +``` + +**Acceso**: +- Traefik: `https:///monitoring/` (ejemplo: `https://checkmk.example.com/monitoring/`) +- NPM: Configurar en NPM apuntando a `checkmk` puerto `5000` → `https://checkmk.example.com/monitoring/` + +⚠️ **IMPORTANTE**: El path `/monitoring/` es obligatorio (nombre del site CheckMK). + +**Credenciales iniciales**: +- Usuario: `cmkadmin` +- Contraseña: La configurada en `CMK_PASSWORD` + +### 6. Comandos OMD útiles + +```bash +# Ver todos los servicios del site +docker compose exec checkmk omd status + +# Reiniciar site +docker compose exec checkmk omd restart + +# Backup manual +docker compose exec checkmk omd backup /tmp/backup.tar.gz + +# Ver configuración del site +docker compose exec checkmk omd config +``` + +--- + ## Modos de Despliegue ### Traefik (Proxy Inverso con SSL automático)