Перейти до вмісту

Власний сервер

Якщо 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 доступний із комп’ютера розробника.