lmmartin/preving-bootstrap repository overview

⁠Preving Bootstrap

Imagen de la guía de estilos interna para el desarrollo de proyectos y aplicaciones web de Grupo Preving. Actualmente publicada en http://styleguide.preving.com/⁠

⁠¿Qué contiene esta imagen?

Preving Boostrap es el compendio de guía de estilos, biblioteca de componentes HTML+CSS+JS y patrones de diseño front-end para las aplicaciones de Grupo Preving⁠. Está desarrollado sobre el trabajo del proyecto Bootstrap y permite desarrollar de forma rápida aplicaciones gracias al sistema de variables y mixings de SASS, estructura de retícula responsive y los componentes preconfigurados.

⁠Creación de archivo Dockerfile

Se ha utilizado una imagen de NGINX (https://hub.docker.com/_/nginx⁠), un servidor web ligero, para "servir" la guía de estilos dockerizada.

El archivo Dockerfile es el siguiente:

# Descargamos la imagen de NGINX sobre la mini distribución Linux Alpine (aprox. 5MB)
FROM nginx:alpine
LABEL version="1.0"

# Puerto desde el que será accesible el contenedor desde otros contenedores
EXPOSE 80

# Copiamos el archivo de configuración de NGINX desde local
COPY ./nginx.conf /etc/nginx/nginx.conf

# Copiamos al contenedor la compilación de la guía realizada para dockerizarla
COPY ./_docker/ /usr/share/nginx/html/

⁠Configuración optima de NGINX

Se ha configurado la imagen para generar un contenedor liviano y ultra ligero. El archivo nginx.conf es el siguiente:

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    include mime.types; # Para que coja correctamente los CSS
    sendfile on;
    server {
        listen 80;
        server_name styleguide.com; # Da igual

	    # Directorio / del servidor
        root   /usr/share/nginx/html;
        
        # Compresión GZIP te todo el código
        gzip on;
        gzip_min_length 1000;
        gzip_proxied expired no-cache no-store private auth;
        gzip_types text/plain text/css application/json application/javascript application/x-javascript text/xml application/xml application/xml+rss text/javascript;

    }
}

⁠Puesta en marcha de la imagen

• Instalar Docker (Docker Toolbox en Windows Home, Docker Desktop en Windows 10 Pro o Mac):

  • Docker Toolbox⁠ - Última versión: GitHub⁠
  • Docker Desktop para Windows 10 Pro⁠
  • Docker Desktop para Mac⁠

• Descargar la imagen de Preving Bootstrap: docker pull lmmartin/preving-bootstrap

• Lanzar el contenedor por primera vez: docker run --rm -d -p 8888:80 --name styleguide lmmartin/preving-bootstrap:latest

• Ahora podríamos acceder al contenedor a través de http://192.168.99.100:8888/⁠ (siendo 192.168.99.100 la IP por defecto de Docker y 8888 el puerto al que hemos redireccionado el puerto 80 del contenedor).

• Para el el contenedor: docker stop styleguide

• Lanzar el contenedor de nuevo: docker start styleguide

NOTAS:

1. Si usamos el modificador --rm durante la primera ejecución del contenedor este se borrará automáticamente en cuanto lo paremos (docker stop styleguide), por lo que habría que volver a lanzarlo con un docker run la siguiente vez. En caso de no incluirlo, podremos guardar su estado y lanzarlo de nuevo mediante un docker start.