Mukautettu palvelin
Jos GitHub ei vastaa tarpeitasi, voit isännöidä rekisteriä millä tahansa HTTP-palvelimella. Ainoa vaatimus on, että registry.json ja lohkotiedostot ovat saatavilla URL-osoitteistaan.
Staattinen tiedostopalvelin
Yksinkertaisin vaihtoehto. Sijoita registry.json ja blocks/-kansiosi mihin tahansa staattiseen isännöintipalveluun:
- Nginx/Apache: tarjoa hakemisto suoraan
- Vercel/Netlify: julkaise hakemisto staattisena sivustona
- S3/R2/GCS: lataa tiedostot julkisesti käytettävissä olevaan säilöön
- CDN: sijoita tiedostot palvelun Cloudflare, Fastly tai minkä tahansa CDN taakse
CLI tarvitsee vain GET pääsyn tiedostoihin. Mitään API ei tarvita, ei dynaamisia reittejä eikä palvelinpuolen logiikkaa.
Dynaaminen palvelin
Jos haluat luoda registry.json dynaamisesti (e.g. tietokannasta tai lisätä käyttöoikeuksien hallinnan), voit rakentaa yksinkertaisen API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} voi sisältää vinoviivoja, kun lohko luettelee tiedostoja alihakemistoissa (src/script.js), joten tiedostoreitin on vastattava sisäkkäisiä polkuja.
CLI ei välitä siitä, miten nämä päätepisteet on toteutettu. Se tekee tavallisia GET-pyyntöjä ja odottaa, että vastauksen runko sisältää tiedoston sisällön.
Esimerkki: 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);
Esimerkki: 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
Jos CLI toimii ympäristössä, jossa CORS on tärkeä (epätodennäköistä Node.js-CLI-työkalulle, mutta mahdollista tuleville verkkopohjaisille työkaluille), varmista, että palvelimesi lähettää asianmukaiset Access-Control-Allow-Origin-otsakkeet.
Välimuisti
CLI tallentaa haetut registry.json-tiedostot välimuistiin muistiin yhden komennon suorituksen ajaksi. Välimuistia ei säilytetä suorituskertojen välillä. Jos haluat optimoida suuria rekistereitä varten, lisää palvelimen vastauksiin tavalliset HTTP-välimuistiotsakkeet (Cache-Control, ETag).
Sisäiset ja yritysrekisterit
Tiimeille, jotka haluavat jakaa lohkoja sisäisesti:
- Isännöi rekisteriä sisäisellä palvelimella tai VPN:n kautta käytettävissä olevassa URL
- Kukin kehittäjä lisää rekisterin URL-osoitteen projektinsa
blocks.json-tiedostoon - CLI hakee lohkot tuosta URL-osoitteesta kuten mistä tahansa rekisteristä
Erityisiä määrityksiä ei tarvita. Se toimii, kunhan URL on kehittäjän koneen tavoitettavissa.