Pāriet uz saturu

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:

Kods
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

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

Piemērs: 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

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:

  1. Mitiniet reģistru iekšējā serverī vai URL, kam var piekļūt, izmantojot VPN
  2. Katrs izstrādātājs pievieno reģistru URL sava projekta blocks.json
  3. 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.