Brugerdefineret server
Hvis GitHub ikke passer til dine behov, kan du hoste et register på en hvilken som helst HTTP-server. Det eneste krav er, at registry.json og blokfilerne er tilgængelige via deres URL’er.
Statisk filserver
Den enkleste mulighed. Læg din registry.json– og blocks/-mappe på en hvilken som helst statisk hosting:
- Nginx/Apache: server mappen direkte
- Vercel/Netlify: udrul mappen som et statisk websted
- S3/R2/GCS: upload filerne til en bucket med offentlig adgang
- CDN: læg filerne bag Cloudflare, Fastly eller en hvilken som helst CDN
CLI behøver kun GET adgang til filerne. Der er ingen API, ingen dynamiske ruter og ingen serverlogik påkrævet.
Dynamisk server
Hvis du vil generere registry.json dynamisk (e.g. fra en database eller for at tilføje adgangskontrol), kan du bygge en enkel API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} kan indeholde skråstreger, når en blok viser filer i undermapper (src/script.js), så filruten skal kunne håndtere indlejrede stier.
CLI er ligeglad med, hvordan disse endpoints implementeres. Den sender almindelige GET-anmodninger og forventer, at svarindholdet indeholder filens indhold.
Eksempel: 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);
Eksempel: 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
Hvis CLI kører i et miljø, hvor CORS har betydning (usandsynligt for et Node.js CLI, men muligt for fremtidige webbaserede værktøjer), skal du sørge for, at din server sender de relevante Access-Control-Allow-Origin-headers.
Caching
CLI cacher hentede registry.json-filer i hukommelsen under en enkelt kommandokørsel. Cacher gemmes ikke mellem kørsler. Hvis du vil optimere til store registre, skal du tilføje standardiserede HTTP-cacheheaders (Cache-Control, ETag) til serverens svar.
Interne virksomhedsregistre
Til teams, der vil dele blokke internt:
- Host registret på en intern server eller en URL, der er tilgængelig via VPN
- Hver udvikler tilføjer registrets URL til projektets
blocks.json - CLI henter fra dette URL som fra ethvert andet register
Der kræves ingen særlig opsætning. Så længe URL kan nås fra udviklerens maskine, fungerer det.