Wrangler (Cloudflare) — Guía de inicio

Instalación

# Con npm
npm install -g wrangler

# O local en tu proyecto
npm install -D wrangler

Verifica:

wrangler --version

Autenticación

wrangler login

Abre el navegador para vincular tu cuenta de Cloudflare. Para CI/CD usa API tokens:

export CLOUDFLARE_API_TOKEN=xxxxx
export CLOUDFLARE_ACCOUNT_ID=yyyyy

Tu primer Worker

mkdir mi-worker && cd mi-worker
wrangler init
# elige "Worker" (no Pages por ahora)

Edita src/index.ts:

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    return new Response(JSON.stringify({ hola: 'mundo' }), {
      headers: { 'content-type': 'application/json' },
    });
  },
};

Desarrollo local:

wrangler dev
# → http://localhost:8787

Deploy a producción:

wrangler deploy
# → https://mi-worker.tu-subdominio.workers.dev

Configuración: wrangler.toml

name = "mi-worker"
main = "src/index.ts"
compatibility_date = "2026-07-01"

[vars]
ENVIRONMENT = "production"

[[kv_namespaces]]
binding = "USERS"
id = "abc123"

Workers con KV

# Crear namespace
wrangler kv:namespace create USERS
# → te da un id, pégalo en wrangler.toml

# Escribir valor
wrangler kv:key put --binding=USERS "user:1" '{"name":"Ana"}'

# Leer valor
wrangler kv:key get --binding=USERS "user:1"

# Listar
wrangler kv:key list --binding=USERS

Workers con D1 (SQLite distribuido)

# Crear DB
wrangler d1 create mi-db
# → te da un id

# Crear tabla
wrangler d1 execute mi-db --command "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)"

# Insertar
wrangler d1 execute mi-db --command "INSERT INTO users (name) VALUES ('Ana')"

# Query
wrangler d1 execute mi-db --command "SELECT * FROM users"

Pages (hosting estático + Functions)

wrangler pages dev ./dist          # previsualizar local
wrangler pages deploy ./dist --project-name=mi-sitio   # deploy

Para proyectos Astro / Next / Vite:

# Build primero
npm run build

# Deploy el resultado
wrangler pages deploy ./dist --project-name=mi-sitio

Tail logs en vivo

wrangler tail mi-worker    # logs en streaming

Comandos útiles

wrangler whoami                           # info de la cuenta
wrangler deployments list                 # deploys recientes
wrangler rollback                         # volver al deploy anterior
wrangler secret put MI_SECRETO            # añadir secret
wrangler secret list                      # listar secrets
wrangler r2 bucket create mi-bucket       # crear bucket R2
wrangler r2 object put mi-bucket/file.txt ./file.txt   # subir archivo

Recursos

• Documentación oficial
• Cloudflare Workers playground