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:
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
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
$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:
- Umiestnite register na interný server alebo do URL dostupného cez VPN
- Každý vývojár pridá register URL do súboru
blocks.jsonsvojho projektu - 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ť.