플러그인 레지스트리는 샌드박스 플러그인을 위한 지원되는 카탈로그입니다. 누구나 plugins.emdashcms.com에서 게시된 플러그인을 탐색할 수 있습니다. 관리자는 EmDash 관리자 패널의 Registry 섹션에서 플러그인을 검토하고 설치할 수 있습니다.
EmDash는 사이트에 플러그인 샌드박스가 활성화되어 있을 때 기본적으로 https://registry.emdashcms.com에서 호스팅되는 레지스트리를 사용합니다.
플러그인 공개 이름
모든 레지스트리 플러그인에는 게시자의 현재 Atmosphere 계정 핸들과 패키지 슬러그로 구성된 공개 이름이 있습니다. 예를 들어, example.com에 의해 게시된 my-gallery 슬러그를 가진 패키지는 @example.com/my-gallery로 표시됩니다.
공개 이름은 레지스트리 결과와 설치 후 Plugins 아래에 나타납니다. 플러그인 상세 페이지를 열려면 선택하거나, 레지스트리 검색에 완전한 이름을 붙여넣어 정확한 패키지를 찾습니다. EmDash는 패키지를 로드하기 전에 핸들을 게시자의 안정적인 계정 식별자로 해결합니다.
핸들이 게시자로 결정적으로 해결되지 않으면 EmDash는 INVALID HANDLE을 표시하고 패키지 상세 페이지에서 새 설치를 방지합니다. 기존 설치는 현재 상태로 유지되므로 신원 조회가 실행 중인 사이트를 비활성화할 수 없습니다. 설치된 플러그인을 검토하고 업데이트하기 전에 게시자에게 문의하세요. 임시 조회 실패는 잘못된 핸들을 보고하는 대신 안정적인 게시자 식별자를 Handle unavailable과 함께 표시합니다.
레지스트리 설치 활성화
레지스트리에서 플러그인을 설치하려면 스토리지와 사용 가능한 샌드박스 러너를 구성합니다. 먼저 플랫폼별 플러그인 샌드박스 설정을 완료하세요.
astro.config.mjs의 emdash() 구성에 Cloudflare 샌드박스 러너를 추가합니다:
import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";
export default defineConfig({
integrations: [
emdash({
sandboxRunner: sandbox(),
}),
],
});샌드박스 러너가 구성되면 EmDash는 Registry 카탈로그를 표시합니다. 다른 애그리게이터를 선택하거나, 레지스트리 정책을 설정하거나, 발견을 비활성화하려면 registry 구성 참조를 참조하세요.
레지스트리 플러그인 설치
- 관리자 패널에서 Registry를 엽니다.
- 제목, 설명 또는
@example.com/my-gallery와 같은 완전한 공개 이름으로 검색한 다음 플러그인의 상세 페이지를 엽니다. - 릴리스를 선택하고 게시자, 메타데이터, 요청된 권한 및 확인 상태를 검토합니다.
- Install을 선택합니다.
- 동의 대화상자에서 확인 상태와 권한을 검토한 다음 확인합니다.
동의 대화상자를 표시하기 전에 EmDash는 다운로드된 번들의 체크섬, 이름, 버전 및 권한을 확인합니다. 게시자가 빌드 출처를 요구하는 경우 EmDash는 해당 증거도 확인합니다. 확인이 실패하면 설치가 중지됩니다. 동의 대화상자는 설치 전에 확인 상태와 정확한 권한을 표시합니다.
레지스트리 업데이트는 이러한 확인을 반복합니다. 업데이트가 권한 또는 MCP 도구를 추가하거나 경로를 인증됨에서 공개로 변경할 때 확인을 기다립니다. 제거는 번들을 제거하고 Also delete plugin storage data를 선택하지 않는 한 플러그인 스토리지 데이터를 보존합니다. 공유 업데이트 및 제거 단계는 플러그인 설치를 참조하세요.