Integración y despliegue
Procedimiento para desplegar los seis componentes del Manifiesto de entrega en el ambiente de Certificación del Ministerio de Educación Nacional. Está escrito para que lo ejecute el equipo técnico del MEN (OTSI) sin intervención del equipo de desarrollo.
El cambio se tramita con el formato de Requerimiento de Cambio del MEN. El plan aprobado con el cliente es el que manda: esta sección lo desarrolla ítem por ítem, sin añadirle ni quitarle pasos. Ver El RFC como instrumento.
Ambiente destino
| URL | https://applicationcert.colombiaaprende.edu.co |
| Nodos de aplicación | M2APCAMPUS01 (192.168.214.200) · M2APCAMPUS02 (192.168.214.201) · M2APCAMPUS03 (192.168.214.202) |
| Nodo de base de datos | M2BDCAMPUS01 (192.168.214.204) |
| Directorio de la aplicación | /ictdata/campus |
| Plataforma | Moodle 5.1+ (branch 501) · PHP 8.3 · MariaDB |
Solo tiene acceso de consulta por VPN. Todas las actividades de esta sección las ejecuta el MEN. Por eso ninguna página incluye rutas de máquinas del equipo de desarrollo, llaves SSH propias ni comandos de Docker: el ambiente de Certificación no usa contenedores.
El despliegue en tres pasos
Cualquier despliegue de este proyecto se reduce a tres pasos. Cada uno es una unidad con verificación propia, y el orden entre ellos no es negociable: Moodle no puede configurar lo que todavía no ha registrado, así que la configuración va después de la instalación.
| Paso | Qué hace | Cómo se ejecuta |
|---|---|---|
| 1. Código fuente | Llevar los seis componentes al árbol de Moodle | Paso 1/3 — Código fuente |
| 2. Instalación | Registrar los componentes y sus Web Services, y recompilar assets y plantillas | Paso 2/3 — Instalación |
| 3. Configuración | Dejar aplicada toda la configuración administrativa | Paso 3/3 — Configuración |
Antes del paso 1 va siempre la preparación (ventana de mantenimiento, snapshot y respaldo); después del paso 3, la verificación técnica y el protocolo funcional.
El build de assets ocurre antes de la entrega, nunca en el servidor destino: el paquete entregado ya trae AMD y SCSS compilados, de modo que el ambiente de Certificación no necesita Node.
Dónde va cada componente
Dentro del docroot, en las rutas estándar de cada tipo de plugin. No se toca ningún otro archivo del core.
| Componente | Ruta destino |
|---|---|
local_pccntr8203403_dashboard | public/local/pccntr8203403_dashboard/ |
local_pccntr8203403_aitutor | public/local/pccntr8203403_aitutor/ |
local_pccntr8203403_iacontext | public/local/pccntr8203403_iacontext/ |
block_pccntr8203403_logros | public/blocks/pccntr8203403_logros/ |
block_pccntr8203403_atencion | public/blocks/pccntr8203403_atencion/ |
theme_cdigital | public/theme/cdigital/ |
Orden de instalación: primero los plugins locales, luego los bloques y por último el tema (el
tema y los bloques consumen clases y Web Services de los plugins locales; los bloques declaran la
dependencia en su version.php). Con una copia única del árbol y un solo upgrade.php, Moodle
resuelve este orden automáticamente. El ejecutor no tiene que hacer nada al respecto.
Mapa del plan aprobado
Cada ítem del plan de implementación tiene su página. Las duraciones son las acordadas con el cliente.
| Ítem | Actividad | Responsable | Min | Página |
|---|---|---|---|---|
| 1 | Poner la aplicación en mantenimiento en el software de monitoreo | Monitoreo | 30 | Preparación |
| 2 | Dar acceso permanente al endpoint del servicio del Agente IA | Seguridad | 30 | Preparación |
| 3 | Snapshot de los cuatro servidores, incluido el de base de datos | Infraestructura | 120 | Preparación |
| 4 | Respaldo de la base de datos moodle y del directorio de la aplicación | Aplicaciones Colombia Aprende | 180 | Preparación |
| 5 | Paso 1/3 — Integración del código fuente | Aplicaciones Colombia Aprende | 90 | Paso 1/3 |
| 6 | Paso 2/3 — Instalación | Aplicaciones Colombia Aprende | 60 | Paso 2/3 |
| 7 | Paso 3/3 — Configuración | Aplicaciones Colombia Aprende | 60 | Paso 3/3 |
| 8 | Pruebas de despliegue | Aplicaciones Colombia Aprende | 30 | Verificación técnica |
| 9 | Retirar la aplicación de mantenimiento | Monitoreo | 30 | Preparación |
| 10 | Validaciones funcionales | Líder funcional | 300 | Protocolo paso a Producción |
Si la verificación del ítem 8 falla, se ejecuta el plan de reversa.
Antes de tocar nada
Confirma los requisitos del entorno: subsistemas de Moodle que deben estar habilitados (seguimiento de finalización, logs, Web Services + REST) y versiones de plataforma. El Dashboard y la gamificación devuelven métricas vacías si el seguimiento de finalización está apagado.