Gostovanje registra
Register sestavljata datoteka registry.json in nabor map z bloki, dostopnih prek HTTP. Poseben strežnik ni potreben. Zadostuje vse, kar lahko streže statične datoteke.
Kaj potrebujete
- Datoteko
registry.jsons seznamom blokov - Mape blokov z datotekami, navedenimi v manifestu
- Spletni strežnik ali storitev gostovanja, ki streže oboje
Struktura imenika
Tipičen repozitorij registra je videti takole:
my-registry/
registry.json
blocks/
hero/
block.json
index.php
style.scss
tabs/
block.json
index.php
style.scss
tab-item/
block.json
index.php
registry.json kaže na imenik blocks/ kot na svoj baseUrl:
{
"name": "my-registry",
"baseUrl": "https://example.com/blocks",
"blocks": [
{
"name": "hero",
"title": "Hero",
"files": ["block.json", "index.php", "style.scss"]
}
]
}
Zahteve
Gostovanje mora podpirati neposreden dostop do datotek prek URL. CLI pridobiva datoteke tako, da sestavlja URL-je iz {baseUrl}/{block.name}/{file}.
CLI nima lastnega postopka prijave. Pri zasebnih registrih uredite nadzor dostopa na ravni gostovanja (e.g. zasebni repozitoriji GitHub z žetoni ali strežnik, ki preverja poverilnice), uporabniki pa naj poverilnice pošiljajo kot glave po meri prek oblike objektov v blocks.json.
Preizkušanje registra
Pred objavo ga lokalno preizkusite tako, da zaženete preprost strežnik HTTP:
cd my-registry
npx serve .
Nato usmerite blocks.json na http://localhost:3000/registry.json in zaženite npx blockstudio list, da preverite, ali se vse razreši. list prenaša samo registry.json. Za preizkus add med preizkušanjem nastavite baseUrl na http://localhost:3000/blocks, saj CLI prenaša datoteke blokov iz baseUrl.