Desplegar una app de Go

Para desplegar una app de Go en Lizard (lizard.build), sube o haz push de un módulo con un archivo go.mod. lizardpack lo compila con la versión de Go de la línea go, genera un binario estático (CGO_ENABLED=0) y lo ejecuta en Alpine Linux. El puerto del servicio es 8080, y Lizard se lo pasa a tu proceso en PORT, así que lee PORT y escucha en todas las interfaces.

Estado de las pruebas: la app de ejemplo de abajo se compila y funciona localmente con Go 1.24, y revisamos su plan de compilación con lizardpack, el planificador de compilación que ejecuta Lizard. Todavía no la hemos desplegado de principio a fin con esta guía.

Antes de empezar

• Un módulo de Go con go.mod en el directorio que despliegas, y go.sum si tiene dependencias.
• Lizard CLI, con la sesión iniciada mediante lizard login, en Pro o en la prueba de Pro de 7 días (se requiere tarjeta). Consulta los precios.

Una app mínima

go.mod:

module example.com/hello

go 1.24

main.go:

package main
 
import (
	"fmt"
	"log"
	"net/http"
	"os"
)
 
func main() {
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}
 
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "Hello from Go on Lizard")
	})
	http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "ok")
	})
 
	log.Printf("listening on :%s", port)
	log.Fatal(http.ListenAndServe(":"+port, nil))
}

":"+port escucha en todas las interfaces. Una dirección como 127.0.0.1:8080 solo acepta conexiones desde dentro del contenedor, y el despliegue nunca alcanza el estado healthy.

Pruébala localmente:

go run .
curl http://localhost:8080/healthz

Qué compila lizardpack

El Dockerfile generado:

FROM golang:1.24-alpine AS build
WORKDIR /app
COPY go.mod go.sum* ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags='-s -w' -o /app/server .
 
FROM alpine:3.19
RUN apk add --no-cache ca-certificates tzdata
WORKDIR /app
COPY --from=build /app /app
EXPOSE 8080
CMD ["/app/server"]

Deja vacíos los comandos de compilación e inicio del servicio para obtener esta imagen. Si defines cualquiera de los dos, Lizard escribe otro Dockerfile a partir de esos comandos e ignora la línea go: un comando go build … compila con Go 1.24. Para controlar cada paso, haz commit de tu propio Dockerfile; consulta Desplegar un contenedor Docker desde un Dockerfile.

Desplegar

Desde la raíz del módulo:

lizard init --name go-app
lizard add --service api
lizard up --service api --port 8080

lizard up sube el directorio, lo compila en las máquinas de compilación de Lizard e imprime la URL. No necesitas Docker ni Go en la máquina que ejecuta el comando. Para usar git push to deploy, conecta un repositorio de GitHub con lizard add -r your-org/your-app -n api y luego comprueba que lizard port --service api imprime 8080.

Frameworks

• net/http, chi, gorilla/mux: pasa ":" + os.Getenv("PORT") a http.ListenAndServe, como arriba.
• Gin: r.Run() sin dirección lee PORT y, si no existe, usa :8080. Define GIN_MODE=release en el servicio.
• Echo, Fiber: pasa tú mismo la dirección: e.Start(":" + os.Getenv("PORT")) o app.Listen(":" + os.Getenv("PORT")).

Variables y bases de datos

Define la configuración en el servicio y léela con os.Getenv:

lizard secrets set GIN_MODE=release API_KEY=change-me --service api

Para una base de datos, añade Managed Postgres y pasa su URL privada con una referencia:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service api

Después ábrela con tu driver, por ejemplo pgxpool.New(ctx, os.Getenv("DATABASE_URL")). Un cambio de variable reinicia el servicio sin volver a compilar.

Comprobar que funciona

lizard logs --build --service api
lizard logs --service api --tail 100
lizard ps

Solicita /healthz en la URL que imprimió lizard up y luego una ruta que haga trabajo real. El log de compilación muestra la imagen golang: que usó la compilación.

Problemas comunes

Un proceso de Go que no sirve HTTP, como un consumidor de cola, se ejecuta como worker en segundo plano con --port 0.

Relacionado

• Guías de frameworks
• Pipeline de compilación
• Variables y secretos
• Redes y dominios

Actualizado 12 de octubre de 2026