Tinkintas serveris
Jei GitHub jums netinka, registrą galite laikyti bet kuriame HTTP serveryje. Vienintelis reikalavimas – kad registry.json ir blokų failai būtų pasiekiami jų URL adresais.
Statinių failų serveris
Paprasčiausias variantas. Įkelkite registry.json ir blocks/ aplanką į bet kurią statinių failų prieglobos paslaugą:
- Nginx/Apache: pateikite katalogą tiesiogiai
- Vercel/Netlify: įdiekite katalogą kaip statinę svetainę
- S3/R2/GCS: įkelkite failus į viešai pasiekiamą saugyklą
- CDN: apsaugokite failus naudodami Cloudflare, Fastly arba bet kurį CDN
CLI reikia tik GET prieigos prie failų. Nereikia nei API, nei dinaminių maršrutų, nei serverio pusės logikos.
Dinaminis serveris
Jei norite dinamiškai generuoti registry.json (e.g, pavyzdžiui, iš duomenų bazės arba pridėti prieigos valdymą), galite sukurti paprastą API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} gali turėti pasvirųjų brūkšnių, kai blokas nurodo failus poaplankiuose (src/script.js), todėl failo maršrutas turi atitikti įdėtinius kelius.
CLI nesvarbu, kaip šie galiniai taškai įgyvendinti. Jis siunčia paprastas GET užklausas ir tikisi, kad atsakymo turinyje bus failo turinys.
Pavyzdys: 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);
Pavyzdys: 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
Jei CLI veikia aplinkoje, kurioje svarbus CORS (mažai tikėtina Node.js CLI atveju, tačiau įmanoma būsimiems žiniatinklio įrankiams), įsitikinkite, kad serveris siunčia tinkamas Access-Control-Allow-Origin antraštes.
Spartinančioji talpykla
CLI per vieną komandos vykdymą talpykloje saugo atmintyje gautus registry.json failus. Talpyklos tarp vykdymų neišsaugomos. Jei norite optimizuoti didelius registrus, į serverio atsakymus įtraukite standartines HTTP talpyklos antraštes (Cache-Control, ETag).
Vidiniai ir įmonių registrai
Komandoms, norinčioms dalytis blokais viduje:
- Patalpinkite registrą vidiniame serveryje arba per VPN pasiekiamame URL
- Kiekvienas kūrėjas įtraukia registro URL į savo projekto
blocks.json - CLI gauna duomenis iš to URL kaip iš bet kurio kito registro
Specialios sąrankos nereikia. Pakanka, kad URL būtų pasiekiamas iš kūrėjo kompiuterio.