Preskoči na vsebino

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:

Koda
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

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

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

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

  1. Register gostujte na internem strežniku ali URL, dostopnem prek VPN-a
  2. Vsak razvijalec doda URL registra URL v blocks.json svojega projekta
  3. 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.