Gå til indhold

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:

Kode
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

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

Eksempel: 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

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:

  1. Host registret på en intern server eller en URL, der er tilgængelig via VPN
  2. Hver udvikler tilføjer registrets URL til projektets blocks.json
  3. 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.