Preskoči na vsebino

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

  1. Datoteko registry.json s seznamom blokov
  2. Mape blokov z datotekami, navedenimi v manifestu
  3. Spletni strežnik ali storitev gostovanja, ki streže oboje

Struktura imenika

Tipičen repozitorij registra je videti takole:

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

JSON
{
  "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:

Lupina
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.