Μετάβαση στο περιεχόμενο

Προσαρμοσμένος διακομιστής

Αν το GitHub δεν καλύπτει τις ανάγκες σας, μπορείτε να φιλοξενήσετε ένα μητρώο σε οποιονδήποτε διακομιστή HTTP. Η μόνη απαίτηση είναι το registry.json και τα αρχεία μπλοκ να είναι προσβάσιμα μέσω των URL τους.

Διακομιστής στατικών αρχείων

Η απλούστερη επιλογή. Ανεβάστε τον φάκελο registry.json και blocks/ σε οποιαδήποτε υπηρεσία στατικής φιλοξενίας:

  • Nginx/Apache: προβάλετε απευθείας τον κατάλογο
  • Vercel/Netlify: αναπτύξτε τον κατάλογο ως στατικό ιστότοπο
  • S3/R2/GCS: ανεβάστε τα αρχεία σε bucket με δημόσια πρόσβαση
  • 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} μπορεί να περιέχει κάθετες όταν ένα block παραθέτει αρχεία σε υποκαταλόγους (src/script.js), οπότε η διαδρομή αρχείου πρέπει να αντιστοιχίζει ένθετες διαδρομές.

Το CLI δεν ενδιαφέρεται για τον τρόπο υλοποίησης αυτών των endpoint. Στέλνει απλά αιτήματα 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).

Εσωτερικά/εταιρικά μητρώα

Για ομάδες που θέλουν να μοιράζονται blocks εσωτερικά:

  1. Φιλοξενήστε το μητρώο σε εσωτερικό διακομιστή ή σε URL προσβάσιμο μέσω VPN
  2. Κάθε προγραμματιστής προσθέτει το μητρώο URL στο blocks.json του έργου του
  3. Το CLI ανακτά στοιχεία από αυτό το URL όπως από οποιοδήποτε άλλο μητρώο

Δεν απαιτείται ειδική ρύθμιση. Αρκεί το URL να είναι προσβάσιμο από τον υπολογιστή του προγραμματιστή.