Saltar al contenido principal

Configurador de Insignia

Genera la URL de una insignia personalizada para cualquier repositorio conectado a Cloudflare Workers Builds.

URL del repositorio de GitHub
Usuario
Repositorio
Rama (opcional)
Vista previa

Introduce un usuario y un repositorio para generar una insignia.

Ejemplos

Estas son insignias reales y en vivo de este mismo proyecto, mostradas con distintos estilos de Shields.io. Se admite cualquier parámetro de consulta de Shields.

¿Qué es Cloudflare Build Badge?

Cloudflare Build Badge es un Cloudflare Worker que genera insignias SVG mostrando el estado de construcción de cualquier repositorio desplegado con Cloudflare Workers Builds, listas para incrustar en tu README o en tu sitio.

El problema que resuelve

GitHub no ofrece una insignia de estado nativa para los checks de Cloudflare Workers & Pages como sí lo hace con GitHub Actions. Este proyecto rellena ese hueco consultando la API de Checks de GitHub y traduciendo el resultado a una insignia de Shields.io, sin que tengas que configurar nada en tu repositorio.

Cómo Funciona

Cada solicitud de insignia recorre estos cuatro pasos en el borde de la red de Cloudflare.

Despliega el Tuyo

Comienza con la plantilla y sigue estos pasos para tener tu propia instancia funcionando.

  1. 1. Copia la plantilla

    Ejecuta este comando:

    pnpm create astro@latest cloudflare-build-badge --template Xeffen25/cloudflare-build-badge --install --git

  2. 2. Sube a GitHub y conecta con Cloudflare

    Sube el repositorio a GitHub, conéctalo en Cloudflare Workers Builds e ignora los primeros builds fallidos mientras terminas de configurarlo.

    Panel de Cloudflare

  3. 3. Actualiza la identidad del proyecto

    Configura tu dominio en "site" dentro de astro.config.mjs y actualiza el nombre del worker en wrangler.jsonc.

  4. 4. Configura el enrutamiento de Wrangler

    Opción A: mantén "route.pattern" para usar un dominio personalizado.

    Opción B: elimina "route" y activa "workers_dev: true" para usar un subdominio de workers.dev.

  5. 5. Configura el secreto del token de GitHub

    Crea un token clásico de GitHub con acceso de solo lectura a "repo" y guárdalo con Wrangler:

    Crear un token clásico de GitHub
    pnpm wrangler secret put GITHUB_TOKEN

  6. 6. Haz tu siguiente commit

    Ejecuta estos comandos:

    git add .
    git commit -m "Set up for me"