Armar imagen Docker con la personalización

Esta guía muestra los pasos a seguir para extender la imagen base del portal SIU-Huarpe.

Esta opción es válida únicamente cuando:

• NO se realiza un fork del portal
• se crea un nuevo bundle
• se realiza alguna configuración que se quiera tener en la imagen Docker

A tener en cuenta:

• no se requiere ajustes al archivo Dockerfile original, solo al personalizado
• se recomienda contar un repositorio y registro privado donde alojar la imagen Docker! No puede ser público.

Preparar el lugar donde estarán alojados los archivos

Contar con un repositorio, un lugar donde alojar:

• el archivo Dockerfile, necesario para construir la imagen Docker
• guardar los archivos que se hayan personalizados
• aplicar alguna configuración adicional

Ejemplo

Supongamos que vamos a crear una nueva imagen docker, ella:

• tomará la configuración aplicada en Configurar el Portal
• tomará la personalización del bundle aplicado en Extender un bundle
• empaquetará todos los cambios en una imagen Docker, lista para usarse!

Organización del repositorio

Recordemos lo realizado previamente. El repositorio propio tendría una estructura similar a esto:

├── Dockerfile    <-- aún no existe!
├── MapucheBundle
│   └──Resources
│      └── vacaciones_lcencias
│         └──  vacaciones.html.twig

Armar el archivo Dockerfile

Crear en el repositorio, un nuevo archivo Dockerfile que tendrá las instrucciones para empaquetar nuestra personalización del portal SIU-Huarpe. Este archivo tiene el siguiente contenido:

FROM hub.siu.edu.ar:5005/siu-arai/huarpe-core:v3.0.0

# copiar personalización del bundle MapucheBundle
COPY MapucheBundle templates/bundles/MapucheBundle

ENV BUNDLE_ARAI_ACTIVO=true
ENV BUNDLE_MAPUCHE_ACTIVO=true
... 

Construir y publicar

El primer paso es construir la imagen Docker ejecutando:

docker build --file docker/Dockerfile --tag mi-huarpe:custom .

Luego se define un tag o etiqueta que identifica a la imagen Docker recién construida:

docker tag mi-huarpe:custom https://registry.docker.privada:5005/mi-huarpe:custom

Finalmente, debemos publicar la imagen Docker, para su posterior despliegue y uso

docker push https://registry.docker.privada:5005

Hasta aquí, se empaquetó la versión configurada de Huarpe en una nueva imagen Docker. La misma podrá ser usada para su distribución y despliegue en los ambientes que se deseen.