Власний сервер
Якщо GitHub вам не підходить, можна розмістити реєстр на будь-якому сервері HTTP. Потрібно лише, щоб registry.json і файли блоків були доступні за своїми URL-адресами.
Статичний файловий сервер
Найпростіший варіант. Розмістіть папки registry.json та blocks/ на будь-якому сервісі статичного хостингу:
- Nginx/Apache: розмістіть каталог безпосередньо
- Vercel/Netlify: опублікуйте каталог як статичний сайт
- S3/R2/GCS: завантажте файли у сховище з публічним доступом
- CDN: розмістіть файли за Cloudflare, Fastly або будь-яким CDN
CLI потрібен лише GET доступ до файлів. Не потрібні API, динамічні маршрути чи серверна логіка.
Динамічний сервер
Якщо потрібно генерувати registry.json динамічно (наприклад, e.g з бази даних або для додавання контролю доступу), можна створити простий API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} може містити скісні риски, якщо блок перелічує файли у вкладених каталогах (наприклад, src/script.js), тому маршрут для файлів має обробляти вкладені шляхи.
CLI байдуже, як реалізовані ці кінцеві точки. Він надсилає звичайні
GET запити й очікує, що тіло відповіді міститиме вміст файлу.
Приклад: 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);
Приклад: 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
Якщо CLI працює в середовищі, де важливий CORS (малоймовірно для Node.js
CLI, але можливо для майбутніх вебінструментів), переконайтеся, що сервер надсилає
відповідні заголовки Access-Control-Allow-Origin.
Кешування
CLI кешує отримані файли registry.json у пам’яті під час одного
запуску команди. Кеш не зберігається між запусками. Щоб оптимізувати роботу
з великими реєстрами, додайте до відповідей сервера стандартні заголовки кешування
HTTP (Cache-Control, ETag).
Внутрішні й корпоративні реєстри
Для команд, які хочуть ділитися блоками всередині організації:
- Розмістіть реєстр на внутрішньому сервері або URL, доступному через VPN
- Кожен розробник додає адресу реєстру URL до
blocks.jsonсвого проєкту - CLI отримує дані з цього URL, як і з будь-якого іншого реєстру
Спеціальне налаштування не потрібне. Реєстр працюватиме, якщо URL доступний із комп’ютера розробника.