Přejít k obsahu

Vlastní server

Pokud vám GitHub nevyhovuje, můžete hostovat registr na libovolném serveru HTTP. Jediným požadavkem je dostupnost registry.json a souborů bloků prostřednictvím jejich URL.

Statický souborový server

Nejjednodušší možnost. Nahrajte složky registry.json a blocks/ na libovolnou službu statického hostingu:

  • Nginx/Apache: přímo zpřístupněte adresář
  • Vercel/Netlify: nasaďte adresář jako statický web
  • S3/R2/GCS: nahrajte soubory do veřejně přístupného úložiště
  • CDN: umístěte soubory za Cloudflare, Fastly nebo libovolný CDN

CLI potřebuje pouze GET přístup k souborům. Není potřeba žádné API, dynamické routy ani logika na straně serveru.

Dynamický server

Pokud chcete registry.json generovat dynamicky (e.g například z databáze nebo chcete přidat řízení přístupu), můžete vytvořit jednoduchý API:

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

{file} může obsahovat lomítka, když blok uvádí soubory v podadresářích (src/script.js), takže routa pro soubory musí odpovídat vnořeným cestám.

CLI nezáleží na tom, jak jsou tyto endpointy implementované. Posílá běžné požadavky GET a očekává, že tělo odpovědi bude obsahovat obsah souboru.

Příklad: 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říklad: 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

Pokud CLI běží v prostředí, kde záleží na CORS (u Node.js CLI je to nepravděpodobné, ale u budoucích webových nástrojů možné), zajistěte, aby váš server posílal příslušné hlavičky Access-Control-Allow-Origin.

Ukládání do mezipaměti

CLI ukládá načtené soubory registry.json během jednoho spuštění příkazu do paměti. Mezi jednotlivými spuštěními se mezipaměť neuchovává. Pokud chcete optimalizovat výkon u rozsáhlých registrů, přidejte do odpovědí serveru standardní hlavičky pro ukládání do mezipaměti HTTP (Cache-Control, ETag).

Interní a firemní registry

Pro týmy, které chtějí sdílet bloky interně:

  1. Hostujte registr na interním serveru nebo v umístění přístupném přes VPN URL
  2. Každý vývojář přidá do blocks.json svého projektu adresu registru URL
  3. CLI načítá data z tohoto URL stejně jako z jakéhokoli jiného registru

Není potřeba žádné zvláštní nastavení. Stačí, aby byl URL dostupný z počítače vývojáře, a bude fungovat.