Vai al contenuto

Server personalizzato

Se GitHub non soddisfa le tue esigenze, puoi ospitare un registro su qualsiasi server HTTP. L’unico requisito è che registry.json e i file dei blocchi siano accessibili tramite i rispettivi URL.

Server di file statici

L’opzione più semplice. Carica le cartelle registry.json e blocks/ su un servizio di hosting statico qualsiasi:

  • Nginx/Apache: servi direttamente la directory
  • Vercel/Netlify: distribuisci la directory come sito statico
  • S3/R2/GCS: carica i file in un bucket con accesso pubblico
  • CDN: proteggi i file con Cloudflare, Fastly o un qualsiasi CDN

Al CLI basta l’accesso GET ai file. Non serve alcun API, né route dinamiche o logica lato server.

Server dinamico

Se volete generare registry.json dinamicamente (e.g, ad esempio, da un database o per aggiungere il controllo degli accessi), potete creare un semplice API:

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

{file} può contenere barre quando un blocco elenca file in sottodirectory (src/script.js), quindi la route dei file deve corrispondere ai percorsi annidati.

Al CLI non interessa come vengono implementati questi endpoint. Effettua semplici richieste GET e si aspetta che il corpo della risposta contenga il file.

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

Esempio: 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

Se il CLI viene eseguito in un ambiente in cui CORS è importante (improbabile per un Node.js CLI, ma possibile per futuri strumenti basati sul web), assicuratevi che il server invii le intestazioni Access-Control-Allow-Origin appropriate.

Memorizzazione nella cache

Il CLI memorizza nella cache i file registry.json recuperati durante una singola esecuzione del comando. Le cache non vengono mantenute tra un’esecuzione e l’altra. Per ottimizzare registri di grandi dimensioni, aggiungete alle risposte del server le intestazioni standard di cache HTTP (Cache-Control, ETag).

Registri interni/aziendali

Per i team che vogliono condividere blocchi internamente:

  1. Ospitate il registro su un server interno o su un URL accessibile tramite VPN
  2. Ogni sviluppatore aggiunge il registro URL al blocks.json del proprio progetto
  3. Il CLI recupera i dati da quel URL come da qualsiasi altro registro

Non serve alcuna configurazione speciale. Basta che il URL sia raggiungibile dal computer dello sviluppatore.