Server personalizat
Dacă GitHub nu corespunde nevoilor dvs., puteți găzdui un registru pe orice server HTTP. Singura cerință este ca registry.json și fișierele blocurilor să fie accesibile prin URL-urile lor.
Server de fișiere static
Cea mai simplă opțiune. Încărcați fișierul registry.json și directorul blocks/ pe orice serviciu de găzduire statică:
- Nginx/Apache: publicați direct directorul
- Vercel/Netlify: implementați directorul ca site static
- S3/R2/GCS: încărcați fișierele într-un compartiment cu acces public
- CDN: plasați fișierele în spatele Cloudflare, Fastly sau al oricărui CDN
CLI are nevoie doar de acces GET la fișiere. Nu este nevoie de API, de rute dinamice sau de logică pe server.
Server dinamic
Dacă doriți să generați dinamic registry.json (e.g. dintr-o bază de date sau pentru a adăuga controlul accesului), puteți crea un simplu API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} poate conține bare oblice când un bloc listează fișiere din subdirectoare (src/script.js), așa că ruta fișierului trebuie să corespundă căilor imbricate.
CLI nu ține cont de modul în care sunt implementate aceste endpointuri. Trimite cereri simple GET și se așteaptă ca corpul răspunsului să conțină conținutul fișierului.
Exemplu: 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);
Exemplu: 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
Dacă CLI rulează într-un mediu în care contează CORS (puțin probabil pentru un Node.js CLI, dar posibil pentru viitoarele instrumente bazate pe web), asigurați-vă că serverul trimite antetele Access-Control-Allow-Origin corespunzătoare.
Memorarea în cache
CLI păstrează în memorie fișierele registry.json preluate pe durata unei singure rulări a comenzii. Cache-urile nu persistă între rulări. Pentru a optimiza registrele mari, adăugați antete standard de cache HTTP (Cache-Control, ETag) la răspunsurile serverului.
Registre interne/de companie
Pentru echipele care vor să partajeze blocuri intern:
- Găzduiți registrul pe un server intern sau pe un URL accesibil prin VPN
- Fiecare dezvoltator adaugă registrul URL la
blocks.jsonproiectului - CLI preia datele din acel URL ca din orice alt registru
Nu este necesară nicio configurare specială. Atât timp cât URL este accesibil de pe mașina dezvoltatorului, funcționează.