Kapsule Orbit 프로젝트 설정

Orbit 프로젝트의 모든 설정은 Settings 탭에 있으며, 일반 정보, 빌드 및 배포, 보안, 알림, 통합, 사용량 제한, 배포 자동화, 네트워킹, 관찰성, 공유 및 하단의 위험 영역으로 분류되어 있습니다.

Settings의 위치

Orbit을 열고 프로젝트를 클릭한 다음 프로젝트 탭 스트립에서 Settings를 선택합니다. 이 페이지는 프로젝트 이름, 빌드 명령 및 Git 통합을 구성하는 것으로 설명되지만, 실제로는 훨씬 더 많은 기능을 가지고 있습니다.

이 가이드는 지도입니다. 각 주제에 대한 별도의 문서가 있으면 링크를 제공합니다.

일반

Project info에는 URL 슬러그, 생성 날짜, 연결된 저장소 및 프로덕션 URL이 표시되며, 프로젝트 Name과 Description을 변경할 수 있습니다.

Git에는 Production branch가 있습니다. 해당 브랜치로의 푸시는 프로덕션 배포를 트리거합니다.

Status badge는 라이브 배포 상태 SVG를 제공하며, URL, 마크다운 및 HTML의 복사 버튼이 있어 README에 붙여넣을 수 있습니다. Viewing Your Project README In Orbit를 참조하세요.

Public status page는 상태 페이지 구성으로 연결됩니다. Orbit Status Page를 참조하세요.

빌드 및 배포

Build settings는 Orbit이 자동으로 감지하고 재정의할 수 있는 5개 필드입니다: 설치 명령, 빌드 명령, 출력 디렉토리, 루트 디렉토리 및 Node.js 버전입니다. 감지된 값을 유지하려면 필드를 비워둡니다. 자세한 내용은 Configuring Your Build Command and Output Directory를 참조하세요.

Runtime에는 이해할 가치가 있는 4개의 스위치가 있습니다:

• Server mode는 각 배포 후 시작 명령을 실행하는 빌드 머신을 활성 상태로 유지합니다. 정적 파일을 내보내기보다는 서버에서 렌더링하는 모든 것에 필요합니다.
• Branch previews는 프로덕션이나 스테이징이 아닌 모든 브랜치 푸시에 대해 환경을 자동으로 생성하며, 각각 branch-*.kaps.run 아래의 자신의 URL을 갖습니다. Branch Previews를 참조하세요.
• Auto-rollback on failure는 배포 실패 시 마지막으로 정상인 프로덕션 배포를 복원합니다.
• Scheduled rebuild는 프로덕션을 시간별에서 주별 간격으로 다시 빌드하며, Git 푸시 없이 새로고침이 필요한 콘텐츠 관리 사이트에 적합합니다.

Build auto-retry는 네트워크 문제나 타임아웃과 같은 인프라 오류로 인해 실패한 빌드를 최대 3회까지 다시 큐에 넣습니다. 코드 오류는 다시 시도하지 않으므로 손상된 빌드를 숨길 수 없습니다.

Ignored paths와 Branch ignore patterns은 불필요한 빌드를 중단합니다: 변경 사항이 배포되지 않아야 하는 파일의 글로브 패턴, 그리고 dependabot/*과 같이 배포를 트리거하지 않아야 하는 브랜치의 패턴입니다.

Git tag deploys는 태그 푸시를 프로덕션 배포로 변환하는 태그 패턴을 설정합니다. Orbit Releases를 참조하세요.

배포 자동화 및 보호

Deploy protection에는 2개의 게이트가 있습니다: Require approval for production은 누군가 승인할 때까지 푸시로 트리거된 프로덕션 배포를 일시 중지하고, Require staging success before production은 스테이징이 동일한 커밋을 성공적으로 배포할 때까지 프로덕션을 보류합니다.

CI required checks는 자신의 CI에서 배포를 게이트합니다. GitHub에서는 작업 이름을 나열하며 모두 통과해야 하고, GitLab에서는 0이 아닌 모든 값이 전체 파이프라인을 기다립니다. CI 실패는 배포를 취소합니다.

Deploy freeze schedule은 승인된 기간 외에 푸시로 트리거된 배포를 차단하며, 주말 또는 UTC 시간 범위일 수 있습니다. 수동 배포 및 배포 훅은 영향을 받지 않습니다.

Branch protection은 일치하는 브랜치에 대한 배포를 차단하는 글로브 패턴 규칙을 추가하며, 필수 외부 검사가 통과되고 선택적으로 사람의 승인을 기다립니다.

Auto-promote staging은 스테이징이 구성된 시간 동안 상태 실패 없이 실행되고 스모크 테스트가 통과된 후 스테이징을 프로덕션으로 자동 승격합니다.

이 모든 항목은 Orbit Deployment Pipeline 탭의 한 뷰에 요약되어 있습니다.

상태 및 품질 게이트

Health check는 모든 프로덕션 배포 후 선택한 경로를 가져옵니다. 15초 이내에 2xx가 아닌 응답은 이전의 정상 배포를 복원합니다.

Smoke tests는 각 성공적인 배포 후 최대 10개의 쉼표로 구분된 경로에 대해 GET 요청을 실행하고 통과 또는 실패를 기록합니다. 자동 롤백과 결합하면 실패한 스모크 테스트가 배포를 롤백합니다.

Performance budgets는 임계값을 초과하는 빌드를 경고하거나 실패시킵니다: MB 단위의 총 아티팩트 크기, 글로브로 일치하는 kB 단위의 개별 파일 크기 또는 초 단위의 빌드 시간입니다. 각 예산은 경고 또는 빌드 실패 중 하나로 설정됩니다.

스테이징

스테이징은 자체 카드 세트를 가지고 있습니다: staging branch, 암호를 사용한 access protection, IPv4 주소 및 CIDR 범위를 한 줄씩 허용하는 IP allowlist, auto-rollback on failure, 스테이징이 더 낮은 우선 순위의 프로덕션 환경 변수를 상속하는지 여부, 그리고 설치, 빌드, 출력 및 루트 디렉토리에 대한 build overrides입니다.

암호 및 IP 허용 목록은 공개하지 않으려는 스테이징 환경에 설정해야 할 두 가지입니다. 둘 다 비워두면 스테이징 URL은 해당 URL을 가진 모든 사람이 접근할 수 있습니다.

네트워킹

Custom domains는 인증서 프로비저닝을 포함한 프로덕션 환경의 도메인을 추가하고 검증합니다. Adding a Custom Domain to Orbit를 참조하세요.

Redirects and rewrites는 제공 전에 적용되는 경로 기반 규칙으로, 순서대로 테스트되며 첫 번째 일치가 우선합니다. 리다이렉트는 브라우저를 301 또는 302로 새 URL로 보냅니다. 리라이트는 URL 변경 없이 다른 경로를 자동으로 제공합니다. 패턴은 정확한 일치, 와일드카드, 명명된 매개변수 및 스플릿을 지원합니다. Redirects and Rewrites in Orbit를 참조하세요.

Response headers는 일치하는 경로에 사용자 정의 HTTP 헤더를 적용하며, HSTS, CSP, no-embed, no-sniff, referrer policy 및 CORS에 대한 사전 설정이 있습니다. 일치하는 모든 규칙이 적용되며, 동일한 키에 대해 나중의 항목이 이전 항목을 덮어씁니다.

Skew protection은 새 배포가 라이브되는 후 보존 기간 동안 저장소에 이전 빌드 아티팩트를 유지하므로, 이전 버전을 로드한 방문자는 404를 가져오는 대신 여전히 해당 아셋을 가져올 수 있습니다.

The config store는 배포가 런타임에 읽는 키/값 설정을 보유하며, 기능 플래그 및 재배포 없이 변경되는 설정용입니다. Storage에서 관리되며 여기서는 아니며, 무료입니다: 읽기 요금이 없고 쓰기 요금도 없습니다. 값은 일반 텍스트로 저장되므로 절대 비밀을 하나에 넣지 마세요. 프로젝트당 최대 100개 항목, 키는 최대 200자, 값은 최대 4096자입니다. 매일 밤 모든 항목의 스냅샷을 찍고 모든 플랜에서 30밤을 유지하므로, 삭제한 항목을 복원할 수 있습니다: Snapshots and restore를 참조하세요.

사용량 및 제한

Build usage는 이 프로젝트가 실행한 빌드를 보여줍니다.

Spending cap은 월별 초과 지출의 최대값을 설정하며, 플랜 할당을 초과하는 빌드 분 및 대역폭 초과분을 포함합니다. 최솟값은 US$6.32이고 최댓값은 US$6,315.79입니다. 알림은 50% 및 80%에서 발생하며, 100%에서 제한을 올릴 때까지 제공이 일시 중지됩니다. Orbit Spending Cap을 참조하세요.

Build spending cap은 별도의 더 단순한 제한입니다: 월별 총 빌드 분의 상한으로, 이후에는 새 빌드가 다음 달이나 제한을 올릴 때까지 큐에 들어가지 않습니다.

Artifact retention은 환경당 유지할 성공적인 빌드 아티팩트의 개수를 설정합니다. 더 이전 것들은 매일 삭제되며, 현재 라이브 배포는 제한과 관계없이 항상 유지됩니다.

Preview expiry는 프리뷰 환경을 7, 14, 30 또는 60일 후에 일시 중지하거나 절대 일시 중지하지 않습니다. 일시 중지된 프리뷰는 24시간 내에 저장소가 회수됩니다.

Artifact size alert는 빌드 아티팩트가 설정한 크기를 초과할 때 이메일을 보냅니다.

알림, 통합 및 관찰성

Deploy email notifications에는 3가지 설정이 있습니다: 모든 배포, 실패만 또는 끄기입니다. notification webhook URL을 함께 설정할 수 있으며, 모든 성공 또는 실패에 게시됩니다.

Notification channels은 더 풍부한 버전이며, 이벤트별 선택, 전달 기록 및 테스트 버튼이 있습니다. 전체 웹훅 제어는 자체 탭에 있습니다: Orbit Webhooks을 참조하세요.

Deploy hooks는 무언가 POST할 때 배포를 트리거하는 비밀 URL을 생성합니다. Triggering Deployments Via Deploy Hooks를 참조하세요.

Log drains는 각 배포 후 빌드 로그를 관찰성 플랫폼으로 전송하며, Datadog, Logtail, Axiom 및 New Relic에 대한 기본 지원이 있거나 사용자 정의 웹훅이 있으며, 선택적으로 한 환경으로 필터링됩니다.

Web Analytics는 Core Web Vitals 수집 스니펫을 제공합니다. Orbit Web Vitals를 참조하세요.

Cron triggers는 선택한 환경에 대한 HTTP 요청을 예약하며, 프로젝트당 최대 10개입니다. 더 크고 프로덕션 전용인 버전은 자체 탭에 있습니다: Orbit Cron Jobs을 참조하세요.

공유 및 팀

Team은 3가지 역할(관리자, 개발자 및 뷰어)을 가진 협력자를 관리합니다.

Share links는 외부 검토자가 암호나 계정 없이 환경을 볼 수 있도록 임시 암호 없는 링크를 생성합니다. 각 링크는 1시간, 24시간, 7일 후에 또는 절대 만료되지 않을 수 있으며 방문 횟수를 표시합니다. 언제든지 하나를 철회하세요.

Deployment group은 이 프로젝트를 그룹에 조인하므로 관련 프로젝트가 함께 배포되며, 선택적으로 브랜치로 필터링됩니다.

Clone environment과 Clone project는 구성을 복제합니다. 프로젝트를 복제하면 빌드 설정, 환경 구성 및 비밀이 아닌 환경 변수가 복사됩니다. 비밀은 복사되지 않습니다.

위험 영역

Clear build cache는 모든 환경에 대한 캐시된 종속성을 삭제하므로 다음 배포는 처음부터 전체 설치를 실행합니다. 실행 취소할 수 없지만, 다음 빌드에서 캐시가 자동으로 다시 빌드됩니다.

Transfer project는 프로젝트를 다른 Kapsule 계정으로 이동합니다. Transferring an Orbit Project를 참조하세요.

Archive project는 즉시 트래픽 제공을 중단합니다. Orbit 목록에서 30일 내에 복원할 수 있으며, 그 후에는 영구적으로 삭제됩니다.

다음 단계

• Orbit Deployment Pipeline에서 모든 설정의 효과를 한 뷰에서 확인하세요.
• Shared Environment Variable Groups에서 프로젝트 간에 사용되는 값을 확인하세요.
• Orbit Plan Limits에서 플랜이 허용하는 것을 확인하세요.