Przejdź do treści

Serwer niestandardowy

Jeśli GitHub nie spełnia Twoich potrzeb, możesz hostować rejestr na dowolnym serwerze HTTP. Jedynym wymaganiem jest dostępność registry.json i plików bloków pod ich adresami URL.

Serwer plików statycznych

Najprostsza opcja. Umieść foldery registry.json i blocks/ w dowolnej usłudze hostingu statycznego:

  • Nginx/Apache: udostępnij katalog bezpośrednio
  • Vercel/Netlify: opublikuj katalog jako witrynę statyczną
  • S3/R2/GCS: prześlij pliki do zasobnika z publicznym dostępem
  • CDN: umieść pliki za Cloudflare, Fastly lub dowolnym CDN

CLI potrzebuje jedynie dostępu GET do plików. Nie ma tu API ani tras dynamicznych, nie jest też wymagana logika po stronie serwera.

Serwer dynamiczny

Jeśli chcesz generować registry.json dynamicznie (e.g, na przykład z bazy danych lub aby dodać kontrolę dostępu), możesz zbudować prosty API:

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

{file} może zawierać ukośniki, gdy blok wymienia pliki w podkatalogach (src/script.js), dlatego trasa pliku musi obsługiwać zagnieżdżone ścieżki.

CLI nie ma znaczenia, jak zaimplementowano te endpointy. Wysyła zwykłe żądania GET i oczekuje, że treść odpowiedzi będzie zawierać zawartość pliku.

Przykład: 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);

Przykład: 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

Jeśli CLI działa w środowisku, w którym ma znaczenie CORS (co jest mało prawdopodobne w przypadku Node.js CLI, ale możliwe w przypadku przyszłych narzędzi internetowych), upewnij się, że serwer wysyła odpowiednie nagłówki Access-Control-Allow-Origin.

Buforowanie

CLI buforuje pobrane pliki registry.json w pamięci podczas pojedynczego uruchomienia polecenia. Nie zachowuje pamięci podręcznej między uruchomieniami. Aby zoptymalizować działanie w przypadku dużych rejestrów, dodaj do odpowiedzi serwera standardowe nagłówki buforowania HTTP (Cache-Control, ETag).

Rejestry wewnętrzne i firmowe

Dla zespołów, które chcą udostępniać bloki wewnętrznie:

  1. Hostuj rejestr na serwerze wewnętrznym lub URL dostępnym przez VPN
  2. Każdy programista dodaje rejestr URL do pliku blocks.json swojego projektu
  3. CLI pobiera dane z tego URL tak jak z każdego innego rejestru

Nie jest wymagana specjalna konfiguracja. Wystarczy, że z maszyny dewelopera można uzyskać dostęp do URL, a wszystko będzie działać.