레지스트리 호스팅
레지스트리는 registry.json 파일과 HTTP를 통해 제공되는 블록 폴더의 모음입니다. 전용 서버는 필요하지 않습니다. 정적 파일을 제공할 수 있는 곳이면 어디든 사용할 수 있습니다.
필요한 항목
- 블록을 나열하는
registry.json파일 - 매니페스트에서 참조하는 파일이 있는 블록 폴더
- 둘 다 제공하는 웹 서버 또는 호스팅 서비스
디렉터리 구조
일반적인 레지스트리 저장소는 다음과 같습니다:
코드
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는 blocks/ 디렉터리를 baseUrl로 가리킵니다:
JSON
{
"name": "my-registry",
"baseUrl": "https://example.com/blocks",
"blocks": [
{
"name": "hero",
"title": "Hero",
"files": ["block.json", "index.php", "style.scss"]
}
]
}
요구 사항
호스팅은 URL를 통한 직접 파일 액세스를 지원해야 합니다. CLI는 {baseUrl}/{block.name}/{file}에서 URL을 구성해 파일을 가져옵니다.
CLI에는 자체 로그인 흐름이 없습니다. 비공개 레지스트리의 경우 호스팅 계층(e.g, 토큰을 사용하는 비공개 GitHub 저장소 또는 자격 증명을 확인하는 서버)에서 액세스 제어를 처리하고, 사용자가 blocks.json개체 형식을 통해 사용자 지정 헤더로 자격 증명을 보내도록 하세요.
레지스트리 테스트
게시하기 전에 간단한 HTTP 서버를 시작해 로컬에서 테스트합니다:
셸
cd my-registry
npx serve .
그런 다음 blocks.json가 http://localhost:3000/registry.json를 가리키도록 하고 npx blockstudio list를 실행해 모든 항목이 확인되는지 검증합니다. list는 registry.json만 가져옵니다. add를 테스트하려면 테스트 중에 baseUrl를 http://localhost:3000/blocks로 설정하세요. CLI는 baseUrl에서 블록 파일을 다운로드하기 때문입니다.