Pielāgots serveris
Ja GitHub neatbilst jūsu vajadzībām, varat mitināt reģistru jebkurā HTTP serverī. Vienīgā prasība ir, lai registry.json un bloku failiem varētu piekļūt, izmantojot to URL.
Statisko failu serveris
Vienkāršākais risinājums. Ievietojiet mapes registry.json un blocks/ jebkurā statiskās mitināšanas pakalpojumā:
- Nginx/Apache: apkalpojiet direktoriju tieši
- Vercel/Netlify: izvietojiet direktoriju kā statisku vietni
- S3/R2/GCS: augšupielādējiet failus krātuvē ar publisku piekļuvi
- CDN: novietojiet failus aiz Cloudflare, Fastly vai jebkura CDN
CLI ir nepieciešama tikai GET piekļuve failiem. Nav nepieciešams API, dinamiskie maršruti vai servera puses loģika.
Dinamiskais serveris
Ja vēlaties dinamiski ģenerēt registry.json (e.g, piemēram, no datubāzes, vai pievienot piekļuves kontroli), varat izveidot vienkāršu API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} var ietvert slīpsvītras, ja blokā ir uzskaitīti faili apakšdirektorijās (src/script.js), tāpēc failu maršrutam jāatbilst ligzdotiem ceļiem.
CLI nav svarīgi, kā šie galapunkti ir ieviesti. Tas veic vienkāršus GET pieprasījumus un sagaida, ka atbildes pamattekstā būs faila saturs.
Piemērs: 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);
Piemērs: 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
Ja CLI darbojas vidē, kurā svarīgs ir CORS (maz ticams Node.js CLI gadījumā, bet iespējams turpmākajiem tīmekļa rīkiem), pārliecinieties, ka serveris nosūta atbilstošās Access-Control-Allow-Origin galvenes.
Kešatmiņa
CLI vienas komandas izpildes laikā kešo atmiņā iegūtos registry.json failus. Kešatmiņa netiek saglabāta starp izpildēm. Ja vēlaties optimizēt darbību lieliem reģistriem, servera atbildēm pievienojiet standarta HTTP kešošanas galvenes (Cache-Control, ETag).
Iekšējie/uzņēmuma reģistri
Komandām, kas vēlas koplietot blokus iekšēji:
- Mitiniet reģistru iekšējā serverī vai URL, kam var piekļūt, izmantojot VPN
- Katrs izstrādātājs pievieno reģistru URL sava projekta
blocks.json - CLI iegūst datus no šī URL tāpat kā no jebkura cita reģistra
Īpaša iestatīšana nav nepieciešama. Ja URL ir sasniedzams no izstrādātāja datora, tas darbojas.