Özel sunucu
GitHub ihtiyaçlarınızı karşılamıyorsa, herhangi bir HTTP sunucusundan kayıt deposu barındırabilirsiniz. Tek gereklilik, registry.json ve blok dosyalarına URL’leri üzerinden erişilebilmesidir.
Statik dosya sunucusu
En basit seçenek. registry.json ve blocks/ klasörünü herhangi bir statik barındırma hizmetine koyun:
- Nginx/Apache: dizini doğrudan sunun
- Vercel/Netlify: dizini statik site olarak dağıtın
- S3/R2/GCS: dosyaları herkese açık erişimi olan bir kovaya yükleyin
- CDN: dosyaları Cloudflare, Fastly veya herhangi bir CDN arkasına koyun
CLI dosyalara yalnızca GET erişim gerektirir. API, dinamik rotalar veya sunucu tarafı mantık gerekmez.
Dinamik sunucu
registry.json değerini dinamik olarak üretmek (ör. e.g bir veritabanından veya erişim denetimi eklemek) istiyorsanız basit bir API oluşturabilirsiniz:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file}, blok alt dizinlerdeki dosyaları listelediğinde eğik çizgi içerebilir (src/script.js); bu nedenle dosya rotası iç içe yollarla eşleşmelidir.
CLI bu uç noktaların nasıl uygulandığını önemsemez. Düz GET istekleri gönderir ve yanıt gövdesinin dosya içeriği olmasını bekler.
Örnek: 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);
Örnek: 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’in önemli olduğu bir ortamda çalışıyorsa (Node.js CLI için olası görünmese de gelecekte web tabanlı araçlar için mümkün), sunucunuzun uygun Access-Control-Allow-Origin başlıklarını gönderdiğinden emin olun.
Önbelleğe Alma
CLI, tek bir komut çalıştırması sırasında alınan registry.json dosyalarını bellekte önbelleğe alır. Önbellekleri çalıştırmalar arasında saklamaz. Büyük kayıt defterleri için optimizasyon yapmak istiyorsanız sunucu yanıtlarınıza standart HTTP önbellekleme başlıkları (Cache-Control, ETag) ekleyin.
Dahili/kurumsal kayıt defterleri
Blokları kendi içinde paylaşmak isteyen ekipler için:
- Kayıt defterini dahili bir sunucuda veya VPN üzerinden erişilebilen bir URL üzerinde barındırın
- Her geliştirici, kayıt defteri URL’sini projesinin
blocks.jsondosyasına ekler - CLI, diğer kayıt defterlerinde olduğu gibi bu URL üzerinden veri alır
Gerekli özel bir kurulum yoktur. URL geliştiricinin makinesinden erişilebilir olduğu sürece çalışır.