핵심 개념

미리보기 및 게시

모든 변경 사항이 제작 전에 미리보기 URL을 통해 제공되는 이유.

Showly에 대한 가장 독단적인 점: 제작물은 이미 미리보기가 아닌 것은 아무것도 받지 않습니다. 이 페이지에서는 그 이유와 이것이 실제로 무엇을 의미하는지 설명합니다.

미리보기란 무엇인가요?

미리보기는 변경할 수 없는 빌드 아티팩트와 라우팅 가능한 URL입니다. 그것은 다음을 수행합니다:

  • 패치가 적용된 커밋 SHA
  • 라이브 프로덕션 아티팩트와의 차이점
  • 빌드 로그
  • 결과 확인(린트, 유형 확인, 사용자 정의 CI 후크)
  • 그것을 생산한 대리인이나 인간

인증된 워크스페이스의 미리보기는 격리된 네임스페이스에 있습니다. 크롤러가 차단되며(X-Robots-Tag: noindex), 만료되지 않고 프로덕션과 비밀을 공유하지 않습니다. 계정 없이 만든 미청구 공개 체험은 별도 흐름이며, 청구하지 않으면 계속 약 1시간 후에 만료됩니다.

미리보기가 실행되는 방식

빌드가 생성되는 방법에는 세 가지가 있습니다.

  • 에이전트(Claude Code / Codex MCP 이상)가 변경 준비 후 create_preview에 전화합니다.
  • 연결된 GitHub에서 빌드합니다. 웹 및 MCP는 연결된 분기를 확인하고 비밀번호로 보호된 개인 미리보기를 생성할 수 있습니다. Pro+ 워크스페이스에서는 대신 워크스페이스 구성원 액세스를 선택할 수 있습니다. 푸시 자동 배포는 기본적으로 꺼져 있으며 명시적으로 활성화되면 라이브 릴리스가 아닌 비공개 작업 영역 구성원 미리 보기만 생성됩니다. 무인 자동 배포에는 현재 Pro+ 및 정적 빌드 대상이 필요합니다. 지원되지 않는 런타임 대상은 인앱 알림으로 건너뜁니다. (소스는 빌드 환경에 절대 들어가지 않는 단기 범위의 GitHub 앱 토큰으로 복제됩니다.)
  • 재시도/재구축. 실패했거나 취소된 배포는 대시보드의 재구축 버튼이나 retry_deployment MCP 도구를 사용하여 재구축할 수 있습니다. Showly는 소스 번들을 유지하므로 다시 업로드할 필요 없이 클릭 한 번으로 다시 빌드할 수 있습니다.

모든 경로는 동일한 아티팩트 + 미리보기 URL에 연결됩니다. 미리보기 빌드는 무료입니다. 성공적인 프로덕션 배포에는 15크레딧이 소모됩니다. 실패한 생산 배포는 그렇지 않습니다. 빌드가 실패하면 배포는 실패 단계를 수행합니다. 오류 코드, 메시지 및 빌드 로그 꼬리를 통해 재시도하기 전에 이유를 확인할 수 있습니다.

비밀번호 액세스의 경우 Showly는 모호한 문자가 제거된 짧은 XXX-XXX 공유 코드를 생성합니다. 대신 6~128자의 비밀번호를 선택할 수 있습니다. 일반 텍스트는 미리보기가 생성되거나 비밀번호가 교체될 때만 표시됩니다. URL + 비밀번호 복사를 사용하여 전달할 준비가 된 자격 증명 블록을 복사하세요. 기존 비밀번호는 교체할 때까지 유효한 상태로 유지됩니다. 민감한 내부 검토를 위해서는 Pro 조직 액세스를 선호하거나 더 긴 비밀번호를 선택하세요.

게시란 무엇인가요?

게시는 _기존 미리보기 아티팩트_를 프로덕션 경로로 승격시키는 것입니다. Showly 게시 시 다시 빌드되지 않습니다. 귀하가 승인한 아티팩트는 배송되는 아티팩트입니다. 이것이 롤백을 안전하게 만드는 것입니다. 롤백은 "빌드를 다시 실행"하는 것이 아니라 "경로 포인터를 다시 바꾸는 것"입니다.

Preview와 Live는 별도의 주소입니다. 미리보기는 비공개로 유지되며 공개 URL로 전환되지 않습니다. 게시는 사이트의 라이브 주소에 대한 프로덕션 배포를 생성합니다. 소스 미리보기는 명시적으로 삭제할 때까지 계속 사용할 수 있으며 요금제에 따른 만료는 없습니다.

승인이란 무엇인가

승인은 게시 승인이 허용된 작업 영역 구성원이 기록하는 결정입니다. 역할은 owner, admin, developer, deployer, viewer입니다. MCP에서 생성된 게시 요청에는 owner 또는 admin의 승인이 한 번 필요합니다. 결정은 지속 가능합니다. 승인자가 내일 작업공간을 떠나더라도 감사 기록에서는 그를 개정 N의 승인자로 지정합니다. 요청자는 자신의 요청을 승인할 수 없으며 거부는 최종 결정입니다.

승인 워크플로는 approvalWorkflows 자격에 의해 제어됩니다. 언제 비활성화된 경우 요청자가 명시적인 브라우저 작업으로 게시하거나 상담원의 2단계 publish_site 확인. OTP/MFA 등록은 되지 않습니다. 필수이며, 면제된 승인 게이트는 감사 로그에 기록됩니다.

롤백이란 무엇입니까?

편집기의 롤백 버튼은 실시간 경로 포인터를 이전 아티팩트로 전환합니다. 롤백은 자체 확인 제어 기능을 갖춘 별도의 고위험 작업으로 남아 있습니다. 롤백된 아티팩트는 _kept_입니다. 롤백이 잘못된 호출로 판명되면 나중에 다시 승격할 수 있습니다.

게시 루프가 중요한 이유

일반적인 Showly 게시는 다음과 같습니다.

  1. 상담원이 create_change_plan로 전화 → 사람이 계획을 검토합니다.
  2. 상담원 호출 apply_site_patch + create_preview → 미리보기 URL이 생성됩니다.
  3. 인간 방문 미리보기, 중요한 흐름을 통해 실행됩니다.
  4. 선택사항: run_checks 작업공간의 사용자 정의 검사 행렬을 실행합니다.
  5. 상담원 호출 request_publish → 승인 보류가 생성됩니다. 이 도구는 webApprovalUrl 딥 링크가 포함된 승인 봉투(아래 참조)를 반환합니다.
  6. 워크스페이스 멤버가 webApprovalUrl를 열고 요청을 승인(또는 거부)합니다.
  7. 사람이 웹 UI에서 게시를 클릭합니다. OTP 설정이 필요하지 않습니다. 게시는 승인된 미리 보기 배포를 프로덕션으로 승격하고 해당 미리 보기 배포 ID에 설정된 sourceDeploymentId를 전달합니다.

request_publish 승인 봉투를 반환합니다.

{
  "approvalId": "apr_...",
  "deploymentId": "dep_...",
  "state": "pending",
  "expiresAt": "2026-05-31T10:00:00.000Z",
  "reused": false,
  "webApprovalUrl": "https://showly.ai/app/deployments/dep_.../publish"
}

state는 pending, approved, denied 또는 expired 중 하나이고, reused는 동일한 배포에 대해 보류 중인 기존 승인이 새 승인 대신 반환되는 경우 true입니다. publish_site는 2단계 배포에 따른 사람 확인 흐름으로 MCP을 통해서도 사용할 수 있습니다.

각 단계는 감사 가능합니다. 각 단계에는 프로덕션에 도달하지 못하는 명백한 실패 모드가 있습니다.

핫픽스는 어떻습니까?

핫픽스는 여전히 먼저 비공개 미리보기를 거칩니다. 비상 우회가 없습니다. 게시에는 여전히 준비된 미리보기, 명시적인 게시 확인이 필요합니다. 작업 공간에 필요한 승인은 있지만 OTP 등록은 아닙니다.