Перейти к содержимому

Пользовательский сервер

Если 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

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

Пример: 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

Если CLI работает в среде, где важно CORS (что маловероятно для Node.js CLI, но возможно для будущих веб-инструментов), настройте сервер так, чтобы он отправлял соответствующие заголовки Access-Control-Allow-Origin.

Кэширование

CLI кэширует загруженные файлы registry.json в памяти на время выполнения одной команды. Кэш не сохраняется между запусками. Чтобы оптимизировать работу с большими реестрами, добавьте в ответы сервера стандартные заголовки кэширования HTTP (Cache-Control, ETag).

Внутренние и корпоративные реестры

Для команд, которые хотят совместно использовать блоки внутри организации:

  1. Разместите реестр на внутреннем сервере или URL, доступном через VPN
  2. Каждый разработчик добавляет реестр URL в файл blocks.json своего проекта
  3. CLI загружает данные из этого URL, как из любого другого реестра

Дополнительная настройка не нужна. Реестр будет работать, если URL доступен с компьютера разработчика.