프리뷰 및 스크래치 프로젝트

두 가지 개념은 모두 중요한 업무에 영향을 주지 않도록 실험적 작업을 분리하기 위해 존재합니다.

임시 프로젝트#

임시 프로젝트는 나중에 삭제할 목적으로 만든 일반적인 프로젝트입니다. 낯선 코드베이스에서 Coroid를 테스트하거나, 정책 변경 사항을 전체에 적용하기 전에 검증하거나, 확신하지 못한 접근 방식을 탐색할 때 활용하세요.

가장 큰 장점은 격리 기능입니다. 임시 프로젝트에서 진행된 실험은 팀이 의존하는 프로젝트의 작업 이력, 지표 및 컨텍스트를 오염시키지 않습니다.

작업이 끝나면 해당 프로젝트를 삭제하세요. 6개월 이상 유지되는 임시 프로젝트는 사실상 실제 프로젝트로 전환된 것이며, 이에 따른 설정 관리 작업이 필요해집니다.

미리보기 환경#

미리보기는 작업에서 생성된 브랜치를 기반으로 실제로 동작하는 변경된 애플리케이션입니다.

이는 매우 중요합니다. 왜냐하면 일부 사항은 코드 차이만으로는 확인할 수 없기 때문입니다. 페이지가 올바르게 렌더링되는지, 전체 흐름이 제대로 작동하는지, 변경 사항이 시각적으로 적절한지 등은 실제로 동작하는 환경에서 확인해야 합니다.

미리보기는 다음과 같은 용도로 사용됩니다:브라우저 테스트가 발생하는 대상이며, 스크린샷만으로는 판단이 어려울 때 리뷰어가 직접 열어 확인하는 환경이기도 합니다.

작업 변경 사항 미리보기#

Factory에서 리뷰를 기다리는 작업을 엽니다. "변경된 내용" 섹션 아래에 있는미리보기버튼을 클릭하면 작업 브랜치가 즉시 시작됩니다.

• 시작 중: 브랜치의 종속 요소가 설치되고 애플리케이션이 시작됩니다. 첫 실행에는 몇 분 정도 소요될 수 있습니다.
• 준비됨: 동작 중인 애플리케이션이 창 내부에 표시됩니다.열기버튼을 누르면 새 탭에 해당 내용이 표시되며, 창에는 미리보기 남은 시간이 표시됩니다.
• 중지버튼을 누르면 미리보기가 조기에 종료됩니다. Coroid에서 실행되는 미리보기는 1시간 후에 자동으로 중지됩니다.

빌드에 실패한 경우,다시 시도버튼을 눌러 다시 시작하며로그 보기버튼을 누르면 오류 내용을 확인할 수 있습니다. 웹 페이지가 없는 백엔드나 라이브러리 변경 사항의 경우,브라우저에서 표시할 내용이 없습니다라는 메시지가 버튼 대신 표시됩니다.

이미 시작되거나 실행 중인 미리보기를 다시 시작해도 동일한 미리보기가 열리므로, 두 명의 리뷰어가 중복된 미리보기를 시작하는 일이 발생하지 않습니다.

미리보기가 실행되는 위치#

미리보기가 실행되는 위치는 사용자가 직접 선택할 수 없습니다:

• Coroid 샌드박스: 기본 설정입니다. Coroid는 작업 브랜치를 격리된 컨테이너에서 빌드하며, 여기에는 사용자의 비밀 정보가 포함되지 않습니다. pull request이나 푸시 작업이 필요 없으므로 Coroid 내부에 저장된 저장소에서도 정상적으로 작동합니다.
• Vercel: 프로젝트에 직접 배포를 위한 Vercel이 연동된 경우(프로젝트 설정 →연동 → 리뷰 증거메뉴에서 설정), Vercel이 브랜치를 빌드하여 Vercel 미리보기 주소로 제공합니다. Vercel 자체의 배포 보호 기능이 적용되므로 미리보기는 창 내부가 아닌 새 탭에서 열립니다.

로컬 전용 모드의 저장소는 Coroid를 벗어나지 않으며 항상 Coroid 샌드박스에서 미리보기가 실행됩니다.

미리보기 주소는 길고 추측하기 어려우나, 주소를 알고 있는 사람이라면 미리보기가 실행 중일 때 언제든지 열어볼 수 있습니다. 미공개 작업으로 연결되는 링크와 동일하게 취급하세요.

pull request에서 미리보기가 제공되는 방식#

pull request의 Coroid에서 작업에 연결된 미리보기 링크는 다음과 같습니다:Coroid에서 이 변경 사항 미리보기버튼을 누르면 작업의 리뷰 페이지가 열리고 미리보기가 시작됩니다. 이 링크를 사용하려면 Coroid에 로그인해야 하며, 미리보기 주소 자체는 풀 리퀘스트에 게시되지 않습니다.

Coroid는 호스팅 제공업체의 Git 앱이나 CI에서 제공하는 기존 미리보기 배포 환경에도 이를 연결합니다.리뷰 증거, 따라서 해당 링크는 별도로 찾아야 하는 곳이 아닌 변경 사항 옆에 바로 표시됩니다.

핵심은 검증 증거와 그 증거가 확인하는 코드가 함께 제공되어야 한다는 점입니다.

언제 어떤 것을 사용할까?#

• Coroid나 나중에 폐기할 가능성이 있는 접근 방식을 테스트할 때 →임시 프로젝트
• 특정 변경 사항이 올바르게 동작하는지 확인할 때 →미리보기

두 기능은 상호 보완적입니다. 임시 프로젝트에도 다른 프로젝트와 마찬가지로 미리보기를 적용할 수 있습니다.

관련 항목#

• 프로젝트 생성 및 구성
• 리뷰 증거
• 리뷰 증거 제공자