아키텍처
에이전트의 변경 사항이 비공개 미리보기와 사람의 승인을 거쳐 라이브 사이트가 되는 흐름입니다.
Showly의 공개 아키텍처는 고객이 신뢰할 수 있는 배포 수명 주기를 설명합니다. 클라우드 제공업체, 배포 리전, 네트워크 토폴로지, 리소스 이름, 내부 서비스 경계는 구현 세부 정보이므로 공개 문서에 포함하지 않습니다.
배포 수명 주기
- 작업공간 연결. 사용자가 사이트를 연결하고 접근할 수 있는 팀원, API 토큰, MCP 클라이언트를 결정합니다.
- 변경 준비. 에이전트 또는 연동 서비스는 허용된 범위의 컨텍스트만 읽고 계획과 변경 파일을 제출합니다.
- 비공개 미리보기 생성. Showly는 격리된 환경에서 변경 사항을 빌드하고 필요한 검사를 실행한 뒤 보호된 미리보기 URL을 반환합니다. 현재 라이브 버전은 변경되지 않습니다.
- 검토 및 승인. 사용자가 미리보기, 차이점, 검사 결과를 확인합니다. 승인 정책이 있는 작업공간은 게시 전에 해당 정책을 완료해야 합니다.
- 라이브 게시. Showly는 검토된 버전을 게시하고 작업을 감사 기록에 남깁니다. 이전 버전은 작업공간의 보존 정책과 요금제 한도에 따라 롤백에 사용할 수 있습니다.
flowchart LR
accTitle: Showly 배포 아키텍처
accDescr: 팀원, 에이전트 및 자동화는 범위가 지정된 접근 경로를 사용하며, 변경 사항은 작업공간 권한 확인, 비공개 미리보기, 사람의 승인, 라이브 게시 및 버전 기록을 거칩니다.
subgraph access["접근 경로"]
direction TB
member["팀원"] --> web["Showly Web"]
agent["에이전트"] --> mcp["MCP 도구"]
automation["자동화"] --> api["REST API"]
end
subgraph workspace["작업공간 경계"]
direction TB
auth["범위가 지정된 권한"]
change["변경 계획 및 파일"]
preview["비공개 미리보기 및 검사"]
gate{"사람의 확인 또는 승인"}
auth --> change --> preview --> gate
end
subgraph delivery["관리형 배포"]
direction TB
live["라이브 사이트"]
versions["버전 기록"]
live --> versions
versions -->|"롤백"| live
end
web --> auth
mcp --> auth
api --> auth
gate -->|"승인"| live
gate -->|"수정 요청"| change제품 경계
작업공간 경계. 사이트, 배포, 토큰, 역할, 감사 기록은 작업공간에 속합니다. 데이터를 반환하거나 변경하기 전에 해당 작업공간에 대한 권한을 확인합니다.
미리보기 경계. 미리보기는 라이브 사이트와 분리되고 접근이 제어됩니다. 미리보기를 만들거나 업데이트해도 자동으로 라이브 게시되지 않습니다.
게시 경계. 라이브 환경을 변경하는 작업에는 명시적인 확인 또는 작업공간 승인 절차가 필요합니다. 에이전트는 이 단계를 우회할 수 없습니다.
버전 경계. 각 게시는 검토된 특정 버전을 가리킵니다. 롤백은 현재 라이브 결과를 직접 수정하는 대신 이전 버전을 선택합니다.
인증 및 감사
- 사용자는 자신의 로그인 세션으로 Showly 웹 애플리케이션을 사용합니다.
- 스크립트는 개인 액세스 토큰을, 에이전트는 범위가 지정된 MCP 토큰을 사용합니다.
- 토큰은 허용된 작업공간, 리소스, 작업으로 제한됩니다.
- 에이전트와 외부 연동에는 Showly의 호스팅 자격 증명이 제공되지 않습니다.
- 읽기, 빌드, 게시, 롤백, 파괴적 작업은 관련 제품 화면이 지원하는 범위에서 감사 기록에 남습니다.
공개 권한 계약은 MCP 범위 및 토큰과 RBAC 및 승인을 참조하세요.
호스팅 및 데이터 위치
Showly는 관리형 서비스입니다. 클라우드 제공업체, 배포 리전, 네트워크 구성, 저장 기술, 서비스 토폴로지는 공개 API나 배포 흐름을 변경하지 않고 바뀔 수 있습니다.
저장소 코드, 응답 메타데이터, DNS 레코드 또는 과거 문서를 근거로 계약상 호스팅 위치를 추정하지 마세요. 조직에 데이터 상주, 규제 또는 자체 클라우드 요구 사항이 있다면 프로덕션 데이터를 등록하기 전에 현재 제공되는 옵션을 Showly에 확인하세요.
배포 방식
Showly는 정적 출력과 일부 서버 렌더링 애플리케이션을 지원합니다. 활성화된 방식과 기능은 작업공간 및 환경에 따라 다를 수 있으므로 제품이 반환하는 배포 대상 기능을 기준으로 삼으세요. 기반 인프라는 Showly가 관리하며 고객 설정 항목이 아닙니다.