Servidor personalizado
Si GitHub no se ajusta a tus necesidades, puedes alojar un registro en cualquier servidor HTTP. El único requisito es que registry.json y los archivos de bloques estén disponibles en sus URL.
Servidor de archivos estáticos
La opción más sencilla. Sube las carpetas registry.json y blocks/ a cualquier servicio de alojamiento estático:
- Nginx/Apache: sirve el directorio directamente
- Vercel/Netlify: publica el directorio como sitio estático
- S3/R2/GCS: sube los archivos a un bucket con acceso público
- CDN: coloca los archivos detrás de Cloudflare, Fastly o cualquier CDN
El CLI solo necesita acceso GET a los archivos. No hay API ni rutas dinámicas, y no se necesita lógica del lado del servidor.
Servidor dinámico
Si quiere generar registry.json dinámicamente (e.g. a partir de una base de datos o para añadir control de acceso), puede crear un API sencillo:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} puede contener barras cuando un bloque enumera archivos en subdirectorios (src/script.js), por lo que la ruta del archivo debe coincidir con rutas anidadas.
Al CLI no le importa cómo se implementan estos endpoints. Realiza solicitudes GET simples y espera que el cuerpo de la respuesta contenga el contenido del archivo.
Ejemplo: Express
const express = require('express');
const path = require('path');
const app = express();
app.get('/registry.json', (req, res) => {
res.sendFile(path.join(__dirname, 'registry.json'));
});
app.use('/blocks', express.static(path.join(__dirname, 'blocks')));
app.listen(3000);
Ejemplo: PHP
<?php
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
if ($path === '/registry.json') {
header('Content-Type: application/json');
readfile(__DIR__ . '/registry.json');
exit;
}
if (preg_match('#^/blocks/([^/]+)/(.+)$#', $path, $matches)) {
$file = __DIR__ . '/blocks/' . $matches[1] . '/' . $matches[2];
if (file_exists($file)) {
readfile($file);
exit;
}
}
http_response_code(404);
CORS
Si el CLI se ejecuta en un entorno donde importa CORS (poco probable para una Node.js CLI, pero posible en futuras herramientas web), asegúrese de que su servidor envíe los encabezados Access-Control-Allow-Origin adecuados.
Caché
El CLI almacena en caché los archivos registry.json obtenidos en memoria durante la ejecución de un solo comando. No conserva las cachés entre ejecuciones. Para optimizar registros grandes, añada encabezados de caché HTTP estándar (Cache-Control, ETag) a las respuestas del servidor.
Registros internos o corporativos
Para equipos que quieran compartir bloques internamente:
- Aloje el registro en un servidor interno o en un URL accesible mediante VPN
- Cada desarrollador añade la URL del registro al
blocks.jsonde su proyecto - El CLI obtiene los datos de ese URL como de cualquier otro registro
No se necesita ninguna configuración especial. Funciona siempre que el URL sea accesible desde el equipo del desarrollador.