Hoppa till innehåll

Anpassad server

Om GitHub inte passar dina behov kan du vara värd för ett register på valfri HTTP-server. Det enda kravet är att registry.json och blockfilerna är tillgängliga via sina URL:er.

Statisk filserver

Det enklaste alternativet. Lägg din registry.json och blocks/-mapp på valfri statisk värdtjänst:

  • Nginx/Apache: visa katalogen direkt
  • Vercel/Netlify: distribuera katalogen som en statisk webbplats
  • S3/R2/GCS: ladda upp filerna till en bucket med offentlig åtkomst
  • CDN: placera filerna bakom Cloudflare, Fastly eller valfri CDN

CLI behöver bara GET åtkomst till filerna. Det finns ingen API, inga dynamiska rutter och ingen logik på serversidan krävs.

Dynamisk server

Om du vill generera registry.json dynamiskt (e.g. från en databas, eller lägga till åtkomstkontroll) kan du bygga en enkel API:

Kod
GET /registry.json          -> returns the registry manifest
GET /blocks/{name}/{file}   -> returns the block file content

{file} kan innehålla snedstreck när ett block listar filer i underkataloger (src/script.js), så filrutten måste matcha nästlade sökvägar.

CLI bryr sig inte om hur dessa slutpunkter implementeras. Den skickar vanliga GET-förfrågningar och förväntar sig att svarskroppen innehåller filens innehåll.

Exempel: Express

JavaScript
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);

Exempel: PHP

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

Om CLI körs i en miljö där CORS spelar roll (osannolikt för ett Node.js CLI, men möjligt för framtida webbaserade verktyg), se till att servern skickar lämpliga Access-Control-Allow-Origin-headers.

Cachning

CLI cachelagrar hämtade registry.json-filer i minnet under en enskild kommandokörning. Cachelagringen sparas inte mellan körningar. Om du vill optimera för stora register kan du lägga till vanliga HTTP-cacheheaders (Cache-Control, ETag) i serversvaren.

Interna register och företagsregister

För team som vill dela block internt:

  1. Värdhantera registret på en intern server eller en URL som nås via VPN
  2. Varje utvecklare lägger till registrets URL i projektets blocks.json
  3. CLI hämtar från den URL precis som från vilket annat register som helst

Ingen särskild konfiguration behövs. Så länge URL är åtkomlig från utvecklarens dator fungerar det.