POLITICA DE COOKIES

Q2BSTUDIO.COM utiliza cookies técnicas, analíticas, de sesión y de publicidad con la finalidad de prestar un mejor servicio. No obstante, necesitamos su consentimiento explícito para poder utilizarlas. Así mismo puede cambiar la configuración de las cookies u obtener más información aquí .

Cómo Desplegar Go con Templ, HTMX y TailwindCSS

Cómo Desplegar Go con Templ, HTMX y TailwindCSS

Publicado el 09/03/2025

En este artículo, te mostraremos cómo desplegar la pila GoTTH (Go, Templ, HTMX, Tailwind) en producción.

Recientemente, desarrollamos una plataforma de agregación para el intercambio de criptomonedas que encuentra las mejores tasas de intercambio entre distintos proveedores asociados.

El proyecto consta de dos partes:

  1. Una API escrita en Go utilizando el framework Gin para interactuar con los intercambios.

  2. Una interfaz web desarrollada en Go que emplea HTML, HTMX, TailwindCSS, CSS y Javascript en plantillas Templ, lo que conforma la pila GoTTH.

Una de las principales ventajas de esta configuración es que podemos generar un solo binario compilado con todos los elementos necesarios para cada parte del sistema y desplegarlo fácilmente en el servidor. En el caso de la interfaz web, esto es posible gracias a que las plantillas HTML se convierten en código Go y se integran en el binario final.

En este artículo, detallamos nuestra configuración para facilitar su implementación.

Configuración del servidor

Utilizamos un servidor Debian 12 para alojar nuestra aplicación, que se expone a través de Cloudflare Tunnels. Los archivos estáticos son servidos mediante Nginx y tanto la API como la aplicación web se ejecutan como servicios administrados por systemd.

La estructura del proyecto en el entorno de desarrollo es la siguiente:

api/
web/
builds/

El directorio `api/` contiene el código fuente de la API, `web/` alberga el código fuente de la interfaz web, y `builds/` almacena los binarios listos para el despliegue en el servidor.

Configuración de Tailwind

Para gestionar TailwindCSS, contamos con una carpeta `static/` dentro del directorio `web/`, donde se ubican dos archivos:

/web/static/
    styles.css
    tailwind.css

El archivo `styles.css` simplemente importa TailwindCSS:

@import 'tailwindcss';

Mientras que `tailwind.css` es generado por TailwindCLI utilizando el siguiente comando:

npx @tailwindcss/cli -i ./static/styles.css -o ./static/tailwind.css --watch

Ambos archivos son referenciados en la plantilla HTML principal utilizando:



Para servir estos archivos estáticos en el servidor, utilizamos Echo en nuestro `main.go`:

func main(){
    e := echo.New()

    e.Use(middleware.Logger())
    e.Use(middleware.Recover())
    e.Use(middleware.Secure())

    e.Static('/static', 'static') // Servir contenido estático.

    // Resto de handlers
}

Configuración de servicios en el servidor

En el servidor, tenemos una estructura de carpetas similar a:

cyphergoat/
+-- api
+-- static/
+-- web

Los binarios `api` y `web` son manejados por systemd mediante los siguientes servicios:

cg-api.service:

[Unit]
Description=API de CypherGoat
After=network.target

[Service]
User=usuario
Group=www-data
WorkingDirectory=/home/usuario/cyphergoat
ExecStart=/home/usuario/cyphergoat/api
Restart=always
RestartSec=1

[Install]
WantedBy=multi-user.target

cg-web.service:

[Unit]
Description=Interfaz Web de CypherGoat
After=network.target

[Service]
User=usuario
Group=www-data
WorkingDirectory=/home/usuario/cyphergoat
ExecStart=/home/usuario/cyphergoat/web

[Install]
WantedBy=multi-user.target

Configuración de Nginx

Para servir la interfaz de usuario mediante Nginx, utilizamos la siguiente configuración:

server {
    server_name dominio.com;

    location / {
        proxy_pass https://127.0.0.1:4200;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /static/ {
        alias /var/www/static/;
        expires 30d;
    }

    listen 80;
}

Para habilitar HTTPS, utilizamos Certbot con:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d dominio.com

Despliegue

Para automatizar la generación y traslado de los binarios, creamos un script bash:

cd api
go build -o ../builds/

cd ../web
templ generate && go build -o ../builds/web cmd/main.go

cd ..
rsync -urvP ./builds/ usuario@SERVIDOR:/home/usuario/cyphergoat
rsync -urvP ./web/static usuario@SERVIDOR:/home/usuario/cyphergoat/
rsync -urvP ./api/coins.json usuario@SERVIDOR:/home/usuario/cyphergoat/

Luego, accedemos al servidor y reiniciamos los servicios:

ssh usuario@ip
sudo systemctl restart cg-api cg-web

En Q2BSTUDIO nos especializamos en el desarrollo y despliegue de soluciones tecnológicas, ofreciendo servicios a medida para implementar infraestructuras eficientes y escalables. Si estás buscando expertos en desarrollo y despliegue de aplicaciones modernas, contáctanos.

Construyendo software juntos

Dando vida a tus ideas desde 2008

Diseñamos aplicaciones móviles y de escritorio innovadoras que cumplen con tus requisitos específicos y mejoran la eficiencia operativa.
Más info
Cuéntanos tu visión
Sea cual sea el alcance, podemos convertir tu idea en realidad. Envíanosla y charlemos sobre tu proyecto o una colaboración futura.
Contáctanos
artículos destacados
Enviado correctamente.

Gracias por confiar en Q2BStudio