Strežnik po meri
Če GitHub ne ustreza vašim potrebam, lahko register gostujete na katerem koli strežniku HTTP. Edina zahteva je, da sta registry.json in datoteke blokov dostopni prek svojih URL-jev.
Statični datotečni strežnik
Najpreprostejša možnost. Mapo registry.json in blocks/ naložite na poljubno storitev za statično gostovanje:
- Nginx/Apache: neposredno strežite imenik
- Vercel/Netlify: uvedite imenik kot statično spletno mesto
- S3/R2/GCS: naložite datoteke v javno dostopen vsebnik
- CDN: datoteke zaščitite z Cloudflare, Fastly ali poljubnim CDN
CLI potrebuje le GET dostop do datotek. Ni potrebe po API, dinamičnih poteh ali strežniški logiki.
Dinamični strežnik
Če želite registry.json ustvarjati dinamično (e.g. iz zbirke podatkov ali za dodajanje nadzora dostopa), lahko zgradite preprost API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} lahko vsebuje poševnice, kadar blok navaja datoteke v podimenikih (src/script.js), zato se mora pot datoteke ujemati z ugnezdenimi potmi.
CLI ne zanima, kako so te končne točke implementirane. Pošilja običajne zahteve GET in pričakuje, da telo odgovora vsebuje vsebino datoteke.
Primer: 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);
Primer: 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
Če CLI deluje v okolju, kjer je pomemben CORS (kar je pri Node.js CLI malo verjetno, pri prihodnjih spletnih orodjih pa mogoče), poskrbite, da strežnik pošilja ustrezne glave Access-Control-Allow-Origin.
Predpomnjenje
CLI med enim zagonom ukaza v pomnilniku predpomni prenesene datoteke registry.json. Predpomnilnika ne ohranja med zagoni. Če želite optimizirati delovanje za velike registre, v odgovore strežnika dodajte standardne glave za predpomnjenje HTTP (Cache-Control, ETag).
Interni in korporativni registri
Za ekipe, ki želijo interno deliti bloke:
- Register gostujte na internem strežniku ali URL, dostopnem prek VPN-a
- Vsak razvijalec doda URL registra URL v
blocks.jsonsvojega projekta - CLI prenaša podatke s tega URL kot iz katerega koli drugega registra
Posebna nastavitev ni potrebna. Deluje, če je URL dosegljiv z razvijalčevega računalnika.