Ugrás a tartalomhoz

Egyéni szerver

Ha a GitHub nem felel meg az igényeidnek, bármilyen HTTP szerveren üzemeltethetsz regisztert. Mindössze annyi szükséges, hogy a registry.json és a blokkok fájljai elérhetők legyenek a saját URL-jükön.

Statikus fájlszerver

A legegyszerűbb megoldás. Helyezd el a registry.json fájlt és a blocks/ mappát bármilyen statikus tárhelyen:

  • Nginx/Apache: közvetlenül szolgálja ki a könyvtárat
  • Vercel/Netlify: telepítsd a könyvtárat statikus webhelyként
  • S3/R2/GCS: töltsd fel a fájlokat egy nyilvánosan elérhető tárolóba
  • CDN: tedd a fájlokat Cloudflare, Fastly vagy bármilyen CDN mögé

A CLI fájlokhoz csak GET hozzáférésre van szüksége. Nincs szükség API-ra, dinamikus útvonalakra vagy szerveroldali logikára.

Dinamikus szerver

Ha dinamikusan szeretnél registry.json-t generálni (e.g. például adatbázisból, vagy hozzáférés-vezérlést hozzáadni), készíthetsz egy egyszerű API-t:

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

A {file} perjeleket is tartalmazhat, ha egy blokk alkönyvtárakban lévő fájlokat sorol fel (src/script.js), ezért a fájlútvonalnak illeszkednie kell a beágyazott útvonalakra.

A CLI számára közömbös, hogyan valósulnak meg ezek a végpontok. Egyszerű GET kéréseket küld, és arra számít, hogy a válasz törzse a fájl tartalmát tartalmazza.

Példa: 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);

Példa: 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

Ha a CLI olyan környezetben fut, ahol számít a CORS (egy Node.js CLI esetén ez valószínűtlen, de jövőbeli webes eszközöknél előfordulhat), gondoskodj róla, hogy a szerver a megfelelő Access-Control-Allow-Origin fejléceket küldje.

Gyorsítótárazás

A CLI egyetlen parancsfutás alatt memóriában gyorsítótárazza a lekért registry.json fájlokat. A gyorsítótárat nem őrzi meg a futások között. Nagy nyilvántartások optimalizálásához adj szabványos HTTP gyorsítótárazási fejléceket (Cache-Control, ETag) a szerver válaszaihoz.

Belső és vállalati nyilvántartások

Azoknak a csapatoknak, amelyek belsőleg szeretnék megosztani a blokkokat:

  1. Helyezd a nyilvántartást egy belső szerverre vagy VPN-en keresztül elérhető URL-re
  2. Minden fejlesztő adja hozzá a nyilvántartás URL-ét a projektje blocks.json fájljához
  3. A CLI ugyanúgy ebből a URL-ből tölt le, mint bármely más nyilvántartásból

Nincs szükség külön beállításra. Amíg a fejlesztő gépéről elérhető a URL, működik.