Treci la conținut

Server personalizat

Dacă GitHub nu corespunde nevoilor dvs., puteți găzdui un registru pe orice server HTTP. Singura cerință este ca registry.json și fișierele blocurilor să fie accesibile prin URL-urile lor.

Server de fișiere static

Cea mai simplă opțiune. Încărcați fișierul registry.json și directorul blocks/ pe orice serviciu de găzduire statică:

  • Nginx/Apache: publicați direct directorul
  • Vercel/Netlify: implementați directorul ca site static
  • S3/R2/GCS: încărcați fișierele într-un compartiment cu acces public
  • CDN: plasați fișierele în spatele Cloudflare, Fastly sau al oricărui CDN

CLI are nevoie doar de acces GET la fișiere. Nu este nevoie de API, de rute dinamice sau de logică pe server.

Server dinamic

Dacă doriți să generați dinamic registry.json (e.g. dintr-o bază de date sau pentru a adăuga controlul accesului), puteți crea un simplu API:

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

{file} poate conține bare oblice când un bloc listează fișiere din subdirectoare (src/script.js), așa că ruta fișierului trebuie să corespundă căilor imbricate.

CLI nu ține cont de modul în care sunt implementate aceste endpointuri. Trimite cereri simple GET și se așteaptă ca corpul răspunsului să conțină conținutul fișierului.

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

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

Dacă CLI rulează într-un mediu în care contează CORS (puțin probabil pentru un Node.js CLI, dar posibil pentru viitoarele instrumente bazate pe web), asigurați-vă că serverul trimite antetele Access-Control-Allow-Origin corespunzătoare.

Memorarea în cache

CLI păstrează în memorie fișierele registry.json preluate pe durata unei singure rulări a comenzii. Cache-urile nu persistă între rulări. Pentru a optimiza registrele mari, adăugați antete standard de cache HTTP (Cache-Control, ETag) la răspunsurile serverului.

Registre interne/de companie

Pentru echipele care vor să partajeze blocuri intern:

  1. Găzduiți registrul pe un server intern sau pe un URL accesibil prin VPN
  2. Fiecare dezvoltator adaugă registrul URL la blocks.json proiectului
  3. CLI preia datele din acel URL ca din orice alt registru

Nu este necesară nicio configurare specială. Atât timp cât URL este accesibil de pe mașina dezvoltatorului, funcționează.