Pereiti prie turinio

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:

Kodas
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

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

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

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:

  1. Patalpinkite registrą vidiniame serveryje arba per VPN pasiekiamame URL
  2. Kiekvienas kūrėjas įtraukia registro URL į savo projekto blocks.json
  3. 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.