Preskočiť na obsah

Vlastný server

Ak vám GitHub nevyhovuje, môžete hostovať register na ľubovoľnom serveri HTTP. Jedinou požiadavkou je, aby boli registry.json a súbory blokov dostupné cez ich adresy URL.

Statický súborový server

Najjednoduchšia možnosť. Umiestnite priečinok registry.json a blocks/ na ľubovoľný statický hosting:

  • Nginx/Apache: priamo obsluhovať adresár
  • Vercel/Netlify: nasadiť adresár ako statickú stránku
  • S3/R2/GCS: nahrať súbory do úložiska s verejným prístupom
  • CDN: umiestniť súbory za Cloudflare, Fastly alebo ľubovoľný CDN

CLI potrebuje k súborom iba prístup GET. Netreba API, dynamické cesty ani logiku na strane servera.

Dynamický server

Ak chcete generovať registry.json dynamicky (e.g. z databázy alebo pridať riadenie prístupu), môžete vytvoriť jednoduchý API:

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

{file} môže obsahovať lomky, keď blok uvádza súbory v podadresároch (src/script.js), preto musí cesta k súboru zodpovedať vnoreným cestám.

CLI nezáleží na tom, ako sú tieto koncové body implementované. Posiela obyčajné požiadavky GET a očakáva, že telo odpovede bude obsahovať obsah súboru.

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

Prí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

Ak CLI beží v prostredí, kde záleží na CORS (pri Node.js CLI je to nepravdepodobné, no pri budúcich webových nástrojoch možné), uistite sa, že server odosiela príslušné hlavičky Access-Control-Allow-Origin.

Ukladanie do vyrovnávacej pamäte

CLI ukladá načítané súbory registry.json do pamäte počas jedného spustenia príkazu. Medzi spusteniami sa vyrovnávacie pamäte neuchovávajú. Ak chcete optimalizovať veľké registre, pridajte do odpovedí servera štandardné hlavičky ukladania do vyrovnávacej pamäte HTTP (Cache-Control, ETag).

Interné a firemné registre

Pre tímy, ktoré chcú zdieľať bloky interne:

  1. Umiestnite register na interný server alebo do URL dostupného cez VPN
  2. Každý vývojár pridá register URL do súboru blocks.json svojho projektu
  3. CLI načíta údaje z tohto URL rovnako ako z každého iného registra

Nie je potrebné žiadne špeciálne nastavenie. Stačí, aby bol URL dostupný z počítača vývojára, a bude fungovať.