Server khusus
Jika GitHub tidak sesuai kebutuhan Anda, Anda dapat menghosting registry di server HTTP apa pun. Syaratnya hanya registry.json dan file blok dapat diakses melalui URL-nya.
Server file statis
Opsi paling sederhana. Letakkan folder registry.json dan blocks/ Anda di layanan hosting statis mana pun:
- Nginx/Apache: sajikan direktori secara langsung
- Vercel/Netlify: terapkan direktori sebagai situs statis
- S3/R2/GCS: unggah file ke bucket dengan akses publik
- CDN: letakkan file di balik Cloudflare, Fastly, atau CDN
CLI hanya memerlukan akses GET ke file. Tidak diperlukan API, rute dinamis, ataupun logika sisi server.
Server dinamis
Jika ingin membuat registry.json secara dinamis (e.g. dari basis data, atau menambahkan kontrol akses), Anda dapat membuat API sederhana:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} dapat berisi garis miring saat blok mencantumkan file dalam subdirektori (src/script.js), sehingga rute file harus cocok dengan jalur bersarang.
CLI tidak bergantung pada cara endpoint ini diimplementasikan. Alat ini mengirim permintaan GET biasa dan mengharapkan isi respons berupa konten file.
Contoh: 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);
Contoh: 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
Jika CLI berjalan di lingkungan yang memperhatikan CORS (kemungkinan kecil untuk Node.js CLI, tetapi mungkin untuk alat berbasis web di masa mendatang), pastikan server Anda mengirim header Access-Control-Allow-Origin yang sesuai.
Caching
CLI menyimpan file registry.json yang diambil di memori selama satu kali eksekusi perintah. Cache tidak disimpan di antara eksekusi. Untuk mengoptimalkan registri besar, tambahkan header cache HTTP standar (Cache-Control, ETag) pada respons server Anda.
Registri internal/perusahaan
Untuk tim yang ingin berbagi blok secara internal:
- Host registri di server internal atau URL yang dapat diakses melalui VPN
- Setiap pengembang menambahkan registri URL ke
blocks.jsonproyeknya - CLI mengambil data dari URL seperti dari registri lainnya
Tidak diperlukan penyiapan khusus. Selama URL dapat dijangkau dari mesin pengembang, semuanya berfungsi.