Hace apenas dos semanas, compartí contigo una herramienta que he estado afinando para simplificar tu flujo de trabajo. Winter CMS encapsula un entorno de desarrollo robusto y eficiente, ahorrándote horas de configuración y garantizando la consistencia en cada paso de tu proceso creativo.

¿Qué te ofrece Winter CMS?

• Un entorno consistente: Olvídate de los “funciona en mi máquina”. Winter CMS asegura que todos los miembros de tu equipo trabajen en un ambiente idéntico.
• Ahorro de tiempo invaluable: Dedica tu energía a lo que realmente importa: ¡codificar! Winter CMS viene listo para usarse.
• Flexibilidad total: Adapta Winter CMS a tus necesidades específicas. Su diseño modular te permite integrar las herramientas que realmente utilizas.
• La base de mis servicios: Winter CMS no es solo una imagen Docker, es la demostración de mi compromiso con la eficiencia y la calidad en el desarrollo. Utilizo esta misma base para ofrecerte soluciones robustas y escalables.

¿Qué Versiones de Winter CMS se han liberado?

• 1.2.7 php 8.2 fpm
• 1.2.7 php 8.2 apache
• 1.2.7 php 8.1 fpm
• 1.2.7 php 8.1 apache
• 1.2.7 php 8.0 fpm
• 1.2.7 php 8.0 apache

¿Listo para experimentar la calidez de un desarrollo sin complicaciones?

¡Quiero saber cómo Winter CMS puede impulsar mi próximo proyecto!

Al hacer clic en el botón de arriba, podrás contactarme directamente para discutir tus necesidades y descubrir cómo mis servicios, basados en la eficiencia de herramientas como Winter CMS, pueden llevar tus ideas al siguiente nivel.

Ya sea que necesites ayuda para optimizar tu flujo de trabajo, construir aplicaciones robustas o implementar soluciones escalables, estoy aquí para ofrecerte mi experiencia y las herramientas adecuadas.

¡No esperes más para descongelar tu potencial! Explora Winter CMS en Docker Hub: https://hub.docker.com/r/webmago/winter

Today I put my hands to write a basic docker-compose.yml to test the Docker Image using Docker Compose, SQLite as a database.

I decided to bind to my SSD local directories with storage, themes, plugins, and database container directories to keep this data safe if the container crashes or is removed.

WinterCMS binding directories

I created an .env file to inject environment variables and some values into the docker-compose.yml services file.

###
#
# Winter CMS Test Image
# Version 1.0
# @author: WebMago
#
###
#### ---- * WinterCMS Configuration * ---- ####
# Name
CONTAINER_CMS_NAME=wintercms
# Image
CONTAINER_CMS_IMAGE=webmago/winter:stable-v1.1.3-php7.4-apache
# Env values
APP_DEBUG=false
APP_KEY=base64:PUT-YOUR-KEY-HERE
TZ=America/Mexico_City
APP_LOCALE=en
DB_PATH_SQLITE=storage/database.sqlite
DB_TYPE=sqlite
SESSION_DRIVER=file
CMS_ACTIVE_THEME=jacoweb-freelance
#### ---- * WinterCMS Domains * ---- ####
# A fake domain to test locally
WINTER_DOMAINS=winter.webmago.io

On the docker-compose.yml the .env values are injected as you can view on the code below and the directories are bound locally on my SSD.

version: '3'
services:
  web-wintercms:
    image: ${CONTAINER_CMS_IMAGE}
    container_name: ${CONTAINER_CMS_NAME}
    restart: unless-stopped
    ports:
      - "80:80"
    environment:
        VIRTUAL_HOST: ${WINTER_DOMAINS}
        APP_DEBUG: ${APP_DEBUG}
        APP_KEY: ${APP_KEY}
        TZ: ${TZ}
        APP_LOCALE: ${APP_LOCALE}
        DB_PATH_SQLITE: ${DB_PATH_SQLITE}
        DB_TYPE: ${DB_TYPE}
        SESSION_DRIVER: ${SESSION_DRIVER}
        CMS_ACTIVE_THEME: ${CMS_ACTIVE_THEME}
    volumes:
     - ./config/test:/var/www/html/config/docker
     - ./wintercms/storage/database.sqlite:/var/www/html/storage/database.sqlite
     - ./wintercms/storage/logs:/var/www/html/storage/logs
     - ./wintercms/storage/app:/var/www/html/storage/app
     - ./wintercms/storage/cms:/var/www/html/storage/cms
     - ./wintercms/themes:/var/www/html/themes
     - ./wintercms/plugins:/var/www/html/plugins

To launch WinterCMS execute:

docker-compose up -d

This runs the process in the background, to stop the execution run:

docker-compose down

The first run creates the database.sqlite and assign a random password to the admin user, this is not visible if you run the docker-compose command using the flag -d.

This can be solved using three scenarios.

First Scenario

Execute the docker-compose without the flag -d

docker-compose up

Second Scenario

If you have been executed the docker-compose with the flag -d and used the YAML of this example, the database is not deleted and the change will keep on the next execution.

# Access the container
docker-compose exec -it wintercms bash
# change the admin password
php artisan winter:passwd
# Enter the username to reset, on this case is admin
 Username to reset:
 > admin
 Enter new password (leave blank for generated password) []:
 > 
Password successfully changed.
# exit the container.
exit

If you require to use redis my advice is to use my images as a base to generate a new image with this PHP extension.

Third Scenario

Add the environment variable INIT_WINTER with the false value into the environment section of the YAML file, only if you have not executed the docker-compose command as the first run.

# Access the container
docker-compose exec -it wintercms bash
# Winter up
php artisan winter:up
.
. # this show the DB migration process
.
.
. # finally the process displays the random password assigned, this is an example only
- The following password has been automatically generated for the "admin" account: xZ4DF20k8txIrcBRqEhkjw
 

Accessing the Backend After all the previous process, now you can access the Backend  CMS, on my case I define the host wintercms.webmago.io as a fake URL added to my hosts, on my web browser typed: http://wintercms.webmago.io/backend/ the user is admin and my password the defined or adjusted based on the previous three scenarios described. /etc/hosts file

127.0.0.1 wintercms.webmago.io

WinterCMS SQLite, Freelance Theme

Glitches

The demo theme currently is not available, this can origin errors on the Frontend, you need to install and activate one of the suggested on the Front-end theme section, find or add your old theme with the required adjustments for WinterCMS.

On the Plugins section, the oldest OctoberCMS Plugins are available to be installed, this can be an additional article for the WinterCMS series.

WinterCMS Plugins

If you require my help, please let me know, contact me.

Varios desarrolladores que hemos usado este CMS también han optado por mirar y  migrar sus proyectos a este nuevo Administrador de Contenido, y por ello me he unido para proveer de las primeras imágenes Docker de WinterCMS de forma gratuita.

Para generar dichas imágenes me base en el código  proporcionado por @aspendigital, haciendo una derivación para generar el CI  con Codefresh un SaaS al que le he confiado varios de mis pipelines desde hace mas de 2 años.

Al momento de escribir este artículo he generado 3 versiones de WinterCMS, v1.1.0, v1.1.2 y v1.1.3 con PHP 7.2 a 7.4 con dos variantes, para apache y fpm; el por que no esta la version 1.1.1 se debe a que generó un error de sqlite al momento de su construcción, por lo que opté por no generar sus respectivas imágenes, así también  las imágenes con PHP 5.6 fueron descartadas , esto debido a que WinterCMS recomienda usar la version PHP 7.2 en adelante.

¿Cómo usar la imagen?

La forma rápida

$ docker run -p 80:80 --name winter webmago/winter:latest

Detener la imagen con CTRL-C

$ docker rm winter # Destruye el contenedor

Si hay un conflicto con el puerto, recibirás un mensaje de error del daemon Docker. Intenta mapear a un puerto local (-p 8080:80) o apaga el contenedor o servidor que esté usando el puerto deseado.

$ docker run -p 80:80 --name winter -d webmago/winter:latest
$ docker stop winter  # Detener el contenedor. Para reiniciar docker start winter
$ docker rm winter  # Destruir el contenedor

Trabajar con archivos locales

# Developing a plugin
$ git clone git@github.com:aspendigital/oc-resizer-plugin.git
$ cd oc-resizer-plugin
$ docker run -p 80:80 --rm \
-v $(pwd):/var/www/html/plugins/aspendigital/resizer \
webmago/winter:latest

# docker-compose.yml
version: '2.2'
services:
  web:
    image: webmago/winter
    ports:
      - 80:80
    volumes:
      - $PWD:/var/www/html/plugins/aspendigital/resizer

$ docker-compose up -d # inicia los servicios definidos en `docker-compose.yml` en el fondo
$ docker-compose down # detiene y destruye

Estas son algunas formas principales de como usar esta imagen, si requieres una personalización o implementarla en algun cluster Kubernetes contactame.

Usando código en Typescript trabaje en un PoC para vincular 3 Droplets y balancear sus cargas, para ello hice uso de Pulumi para generar la arquitectura en donde un balanceador de carga recibirá las peticiones y las dirigirá hacia los droplets, a su vez un firewall evitara accesos a puertos no solicitados.

En un post previo hable de Pulumi con Digital Ocean, con el que trabaje en un PoC y Kubernetes. Para este PoC me base en este código  al cual le hice algunas adecuaciones para instalar docker y ejecutar el contenedor de Simple Web y validar el balanceo a través de los 3 Droplets creados.

En la primer creación del Load Balancer, el verificador de salud lo habia definido para revisar el protocolo TCP en el puerto 80, esto genero un fallo general debido al uso del contenedor con python, por lo que procedí a ajustarlo para revisar el protocolo HTTP en el codigo de Typescript en lugar de hacerlo en el panel administrativo de Digital Ocean obteniendo así el estado de salud satisfactorio.

Cabe señalar que existen algunos glitches que Pulumi deberá resolver como en el caso de actualizar el Userdata de los Droplets se generan errores en el recurso del Firewall y Load Balancer.

Les dejo a continuación unas capturas del PoC.

Pulumi Stack

DO VPC creado

DO DROPLETS creados

DO LB creado

DO FW creado

Puedes usar una gran variedad de software para llevarlo a cabo, lo que implica en algunos casos aprender un nuevo lenguaje, algo que Pulumi ha tomado en cuenta para su rápida adopción, por lo que si sabes Typescript, Go, Python, Javascript o .Net reducirás enormemente la curvatura de aprendizaje.

Había escuchado de Pulumi hace un año, hace unas semanas tome dos webinars  y las dudas que tenia sobre su uso, escenarios me animo a probarlo con una promo que obtuve en Digital Ocean por lo que inicie con la creación de un cluster Kuberntes usando Typescript. Pulumi te ofrece una version gratuita si únicamente tú usas el entorno.

La ventaja de esto que puedes ir haciéndolo poco a poco y esta es la lista ordenada de lo que fui administrando con mi código.

1. Creación del Cluster Kubernetes.
2. Creación de algunos namespaces, ex: staging, website
3. Creación de un primer Deployment con nginx en el namespace de staging.
4. Creación de un ClusterIP Service para el Deployment creado en el punto 3.
5. Una gran pausa para instalar Istio (muy complicado y tomaría mas horas) o nginx como Ingress
6. Después de decidirme en el punto 5 por nginx, procedí a crear el código para instalarlo como Ingress, con su namespace usando el Helm v3 Chart; esto me genero un LoadBalancer en Digital Ocean a su vez asignándome la IP Publica.
7. Creación de un Service Ingress para dirigir el tráfico del ingress-nginx creado en el punto 6 hacia el ClusterIP creado en el punto 4, puedes verlo en do.webmago.dev (puede no estar disponible en el futuro).

Ejecucion Paso 1 Pulumi

Revision Dashboard Digital Ocean

Dashboard Pulumi paso 1

Cabe señalar que para mantener mi entorno aislado y no interferir con mis configuraciones de mi equipo trabaje desde un contenedor de docker.

Tengo que aclarar que tuve algunos glitches con Pulumi al aplicar/actualizar cambios y al parecer es un comportamiento algo raro que tiene Digital Ocean, por lo que recibía errores y tenia que volver a ejecutar la actualización de cambios.

En mi experiencia, puedo decir que Pulumi reduce considerablemente su curvatura de aprendizaje y adopción permitiéndote administrar tu Infraestructura como Código con los lenguajes antes mencionados.

He desarrollado código en diversos lenguajes y he tenido la necesidad que algún proyecto requiere de un ajuste o corrección y no cargo con una Laptop, quienes hacen senderismo me darán la razón que con el tiempo la carga puede ser agobiante y entre mas ligero transites mejor, por lo tanto, una tableta, datos móviles y la corrección puede ser realizada en cualquier lugar.

Existen en el mercado varios proveedores para editar código en línea, algunos te ofrecen cuentas básicas gratuitas con un espacio de trabajo y pueden servirte para tu projecto personal, aquí te enlisto algunos de ellos.

Estos te permiten crear espacios de trabajo

• AWS Cloud9 – $ 2.05 al mes en adelante.
• Codeanyhere – $ 2.5 al mes en adelante.
• Repl.it – Free, $7.00 (usuario), $ 35 (Team) al mes
• Code Sandbox – Free, $7.00 mes

Si solo quieres probar y aprender código:

• Online IDE
• IdeOne
• Code Chef
• Paiza
• Coding Blocks IDE

Si quieres trabajar con tu cluster Kubernetes

• Gitpod

Si cuentas con un VPS de al menos 2 Cores CPU, 1 GB RAM puedes montarte tu Visual Studio Code en tu propio servidor y tener tu IDE web en algun dominio como https://idecode.webmago.dev, puedes hacerlo siguiendo el procedimiento de instalacion o usar una imagen Docker .

La implementacion de Visual Studio Code en un VPS me tomo menos de una hora; el pasado fin de semana estando fuera de oficina tuve que corregir un estilo en un sitio web y el contar ya con un editor en linea me ayudo para hacer la correccion y enviarla al repositorio y lanzar el procedimiento de CI/CD y ver el cambio solicitado por el cliente.

En esta captura podras ver Visual Studio Code solicitandome la contraseña para acceder y empezar a trabajar.

Acceder usando contraseña

En esta otra captura podras ver la pantalla clasica de bienvenidad de Visual Studio Code.

Pantalla de Bienvenida

Si requieres de mi ayuda para montar tu propio IDE online en tu VPS contactame.

Para los clusters Kubernetes me auxilio de “Monitoring” (antes Stackdriver) en GCP o CloudWatch en AWS, o incluso Prometheus con Grafana.

Lo que hace de Weavescope un software Open Source tan peculiar no solo es ver métricas, sino pausar, detener, reiniciar un contenedor o acceder a la terminal del mismo para hacer algunas operaciones tal como si fuera una terminal remota.

Esta versatilidad de Weavescope me permite visualizar y hacer operaciones cuando solo cuento con un dispositivo móvil como una tableta o un iPad.

Weavescope ofrece varias alternativas de ser instalado, en mi caso donde uso VPS con docker-compose opte por esta version con algunos ajustes que no se mencionan en la version oficial, tal es el caso de la autenticacion, ya que de no contar con esto cualquiera que conozca la dirección de mi instalacion podria hacer un mal uso como detener o crear contenedores y vulnerar mi sistema.

Weaveworks la compañia creadora de Weavescope ofrece diferentes soluciones de automatizacion CI-CD, monitoreo y registros, una de las herramientas mas novedosas GitOps basado en Kubernetes.

No olvides contactarme si requieres asistencia en tus proyectos.

A continuacion dejo una serie de capturas de una de mis instalaciones de Weavescope.

Filtrando los recursos por contenedor

En la ficha del contenedor se observan varios botones para efectuar operaciones tales como adjuntar, acceder a la terminal, refrescar, pausar, detener el contenedor.

Esta version grafica es un atajo a la instruccion “docker exec -it dbadmin bash”

So, Kubernetes is deprecating Docker support and you’re either nervous or confused. That’s okay! I would like to help you understand what’s happening. A thread! 1/10

— Kat Cosgrove, but ✨festive✨ (@Dixie3Flatline) December 2, 2020

Quienes trabajamos con Kubernetes o en Desarrollo de Software hemos usado Docker para desarrollar y generar las imágenes que finalmente usaremos en nuestro clúster, por supuesto que existen mas proveedores compatibles con OCI (Open Container Initiative) y esto quiere decir que las imágenes que generamos en Docker cumplen con esta normativa.

Ayer 3 de Noviembre 2020, Docker publico un articulo (en inglés) detallando quá sucederá con este cambio dándonos una tranquilidad a toda la comunidad que usa la tecnología de contenedores.

What developers need to know about Docker, Docker Engine, and Kubernetes v1.20

En si, lo que se eliminará probablemente en un año será dockershim, por lo tanto, las imágenes que generes con Docker seguirán funcionando en tu clúster Kubernetes, el cambio es mas para los operadores y administradores de Kubernetes donde el acceso a la inspección de los contenedores usando comandos de Docker no podrán ser usados.

Así que mantén la calma y sigue usando Docker.

Posterior a un cambio hecho en el código iniciaron las caídas de secciones en cascada y finalmente la página de inicio, el momento en que esto sucedía era aleatorio, el único patrón detectado era la caída de secciones y finalmente la página de inicio.

El equipo externo de desarrollo nos responsabilizaba por qué seguramente habíamos hecho algún cambio no autorizado al sistema de cache; algo que tenia mas de un año sin ser modificado.

Algunos desarrolladores no cuentan con un disciplina para documentar, hacer pruebas unitarias, este era el caso de el equipo externo, incluso había detectado código duplicado o no optimizado en el inicio del proyecto y lo peor, habían silenciado los registros, es decir, si algo mal ocurría simplemente era “ocultado” o no registrado, algo que el mismo programador hizo a propósito.

En algún momento trabaje con un equipo ordenado que documentaba y generaba sus pruebas unitarias, al momento de hacer el proceso de integración estas pruebas unitarias validaban en parte que el código no tendría errores, así también la detección de código duplicado entre otros.

Es mi costumbre documentar y tener estadísticas de incidencias, por lo que estuve buscando cómo validar su código y con ello respaldarnos para descartar que era nuestra responsabilidad la caída de secciones y página principal.

En el camino encontré Codacy, una buena opción con muchas características, lamentablemente solicitar una autorización para el incremento del presupuesto tomaría tiempo y nos quedaríamos sin funciones PRO en el corto tiempo, así que opte por Sonarqube.

Con Sonarqube implemente un bash script para escanear el código del proyecto indicado, para mi fortuna Sonarqube cuenta con una versión Docker Comunitaria gratuita la cual puedes tener lista y operando en 5 minutos; esta versión solo te permite escanear la rama master de tu proyecto, si requieres algo mejorado tendrás que optar por la versión de Sonar Cloud y te cobrara en base a las lineas de código que tenga tu proyecto.

Usando mis estadísticas desde que dejaron de presentarse caídas y al momento de su re-aparición busque en el histórico de Sonarqube y encontré las fechas en las que habían hecho los cambios y Sonarqube nos indicaba la mala calidad del código que había detectado en esos cambios, con ello descartaron que había sido un descuido de nuestro lado al modificar un componente fuera de su alcance.

Lo anterior hizo que trabajara en la creación del espacio en GCR, generar los permisos IAM, ajustar todos los pipelines en Codefresh  para enviar las imágenes resultantes, exportar las imágenes mas recientes y descargadas y por ultimo hacer los cambios en el cluster Kubernetes para que los deployments pudieran descargar las imágenes durante el proceso de CI/CD o regeneración.

Quienes hemos trabajado con Kubernetes existe un parámetro ImagePullPolicy cuyos valores pueden ser Always o IfNotPresenty dependerá del comportamiento esperado tomando en cuenta estas recomendaciones.

Recientemente Docker anuncio a través de un correo electrónico  que haría cambios para las descargas y retención de imágenes en su servicio.

Los descargas anónimas de imágenes solo podrán hacerse 100 veces en 6 horas, las descargas de tus imágenes en tu cuenta gratuita se extiende hasta 200 cada 6 horas; las cuentas Pro y Team y Large no tienen esta limitante ver comparativo en su pagina de Precios, dicha política entro en vigor en Noviembre 2, 2020.

Por otro lado, las retenciones de las imágenes solo estarán disponibles por seis meses, por lo que si tu imagen no es actualizada o descargada en ese tiempo será eliminada, este ultimo ha sido pausado ya que entraría en vigor en noviembre 1, 2020; y será retomado a mediados del año 2021.

Como recordaran, tenia duda si realmente Codefresh daría de baja el servicio por falta de uso, o por que le estaba generando un costo enorme mantener varias imágenes de todos los que formamos su plantilla de clientes, algo que también Docker acaba de hacer con su servicio.

Creo que el costo de $5.00 US siendo Pro en Docker vale la pena para tener nuestro Hub de nuestras imágenes de forma privada.