Lewati ke konten

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:

Kode
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

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

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

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:

  1. Host registri di server internal atau URL yang dapat diakses melalui VPN
  2. Setiap pengembang menambahkan registri URL ke blocks.json proyeknya
  3. CLI mengambil data dari URL seperti dari registri lainnya

Tidak diperlukan penyiapan khusus. Selama URL dapat dijangkau dari mesin pengembang, semuanya berfungsi.