İçeriğe geç

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

Kod
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

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

Örnek: 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’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:

  1. Kayıt defterini dahili bir sunucuda veya VPN üzerinden erişilebilen bir URL üzerinde barındırın
  2. Her geliştirici, kayıt defteri URL’sini projesinin blocks.json dosyasına ekler
  3. 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.