Orbit 배포 파이프라인

The Pipeline tab is a single page that answers "what happens when we push". It shows every way a deploy can be triggered, every gate that can stop one, the state of each environment, and which build…

Pipeline 탭은 "푸시할 때 무엇이 일어나는가"라는 질문에 답하는 단일 페이지입니다. 배포를 트리거할 수 있는 모든 방식, 배포를 중단할 수 있는 모든 게이트, 각 환경의 상태, 어떤 빌드 기능이 켜져 있는지를 모두 보여주며, 이 모든 정보는 프로젝트의 실제 구성에서 읽어온 것입니다.

Pipeline이 위치한 곳

Orbit을 열고 프로젝트를 클릭한 다음 프로젝트 탭 스트립의 Deployments 그룹 아래에서 Pipeline을 선택하십시오. 이 페이지는 Deployment pipeline이라고 표시됩니다.

이것은 읽기 전용 대시보드입니다. 여기서는 아무것도 구성되지 않으며, 모든 섹션은 실제 설정이 있는 곳으로 연결됩니다. 이것이 이 페이지의 가치입니다. 여덟 개의 설정 카드를 읽는 대신 한 화면에서 프로젝트를 이해할 수 있습니다.

Orbit 프로젝트의 배포 파이프라인 개요

상단의 알림

두 개의 배너가 해당하는 경우 표시됩니다:

Deploy lock active, Manage 링크 포함. 푸시로 트리거된 배포가 건너뛰어지고 있습니다.
N deployments awaiting approval, Review 링크 포함. 누군가 배포를 승인하거나 거부해야 합니다.

둘 중 하나가 표시되고 있고 푸시가 배포되지 않은 이유가 궁금하다면, 더 이상 읽을 필요 없이 답을 얻을 수 있습니다.

빌드 통계

작은 패널에 최근 빌드에 대한 성공률, 평균 빌드 시간, 성공한 빌드의 수를 표시합니다. 이것은 분석보다는 상태 점검입니다. 전체 그림을 보려면 Orbit Project Analytics와 Orbit Build Insights를 참조하십시오.

트리거 소스

이 섹션은 이 프로젝트에 대한 배포의 모든 경로를 나열합니다:

소스	표시 내용
Git push	연결된 저장소 또는 No repo connected
Branch previews	모든 브랜치에서 자동으로 미리보기가 생성되는지 여부
Git tag	구성된 경우 태그 패턴
Manual deploy	항상 사용 가능

배포에 놀랐을 때마다 이것을 읽으십시오. 빌드가 나타났는데 아무도 푸시하지 않았다면, 이 중 하나가 설명입니다: 태그, 배포 훅 또는 누군가가 버튼을 누른 것입니다.

게이트 및 안전

가장 큰 섹션은 게이트 목록으로, 각 게이트는 현재 상태를 Configure 링크와 함께 표시하여 관련 설정 카드로 이동합니다.

게이트	역할
Approval gate	프로덕션 배포에는 명시적 승인 필요
Staging prerequisite	프로덕션이 같은 커밋의 스테이징을 대기
CI checks	통과해야 하는 필수 확인 또는 No checks required
Freeze window	주말 차단, 커스텀 시간 또는 동결 일정 없음
Deploy lock	활성 또는 잠금 없음
Health check	배포 후 확인된 경로 또는 Disabled
Auto-rollback	상태 확인 실패 시 되돌림
Skew protection	이전 자산의 보관 기간
Auto retry	인프라 실패를 재시도하는 횟수

이 게이트 중 대부분은 푸시로 트리거된 배포에만 적용됩니다. 패널의 수동 배포 및 배포 훅은 직접 통과합니다. 예외는 다르게 작동하며, 각 게이트의 세부 사항은 Deploying Your Project에서 다룹니다. 게이트를 제어로 사용하기 전에 먼저 읽으십시오.

게이트를 체크리스트로 읽기

중요한 프로젝트의 경우, 합리적인 기본 설정은:

Health check: 설정됨, 캐시된 셸이 아닌 앱을 실행하는 경로를 가리킴.
Auto-rollback: 켜짐. 상태 확인이 없으면 작동할 것이 없으므로 두 가지가 함께 작동합니다.
Auto retry: 하나 또는 두 개. 네트워크 오류 같은 인프라 오류로 실패한 빌드를 다시 큐에 넣으며, 코드 오류는 재시도하지 않으므로 비용이 없지만 시간을 절약합니다.
Approval gate: 잘못된 배포가 비용이 많이 드는 모든 것에는 켜짐, 보호하는 것보다 속도를 더 많이 떨어뜨리는 경우에는 꺼짐.

페이지에 Health check Disabled와 Auto-rollback이 켜져 있으면, 그 조합은 아무것도 하지 않습니다. 이것은 몇 개월간 눈에 띄지 않고 수행할 수 있는 가장 쉬운 잘못된 구성 중 하나이며, 이 페이지가 이를 발견하는 곳입니다.

환경 흐름

Environment flow 섹션은 각 환경을 현재 상태(LIVE, BUILDING 또는 PAUSED)와 함께 카드로 그리며, 추적하는 브랜치 및 현재 배포가 재시도인 경우 재시도 번호를 표시합니다.

각 카드의 배지는 해당 환경에 대해 활성화된 항목을 표시합니다:

Smoke tests, 각 배포 성공 후 선택된 경로에 대해 실행되는 GET 요청.
Auto-promote, 일정 시간의 정상 작동 후 스테이징을 프로덕션으로 승격.
Canary, 카나리 배포의 트래픽 비율.
Inherits prod vars, 스테이징이 낮은 우선순위로 프로덕션 환경 변수를 병합하는 곳.
Scheduled rebuild, 프로덕션이 간격으로 다시 빌드되는 곳.

각 카드는 그 환경의 배포로 연결됩니다. 환경이 No deployments yet이라고 표시되면, 구성에는 존재하지만 아무것도 배포되지 않았습니다.

활성 기능

마지막 섹션은 빌드 수준 설정을 요약합니다:

기능	값
Server mode	SSR 활성화 또는 정적만 해당
Auto-create on push	브랜치 푸시가 환경을 생성하는지 여부
Health checks	켜짐 또는 꺼짐
Build retry	최대값 또는 꺼짐
Deploy groups	다른 프로젝트와 그룹화 또는 독립 실행형
Build timeout	빌드당 제한
Preview expiry	미리보기가 일시 중지되기 전의 일 수 또는 절대 안 함

Server mode는 사람들이 걸리기 쉬운 것입니다. 서버에서 렌더링하는 프레임워크는 켜야 하고, 정적 내보내기는 켜지 않습니다. 프로젝트가 잘 빌드되지만 홈 페이지 외의 모든 경로에서 빈 페이지 또는 404를 제공하는 경우, 먼저 이것을 확인하십시오. Frameworks Orbit Supports를 참조하십시오.

Preview expiry는 하우스키핑 관련 항목입니다. 절대 안 함으로 설정하면 미리보기 환경이 무기한 누적됩니다.

Pipeline 페이지 사용

누군가를 온보딩할 때. 먼저 여기로 보내십시오. 어떤 문서보다 더 빠르고 정확한 설명입니다. 왜냐하면 실시간 구성에서 생성되기 때문입니다.

배포가 일어나지 않았을 때. 위에서 아래로 작업하십시오: 배너, 트리거 소스, 게이트. 셋 중 하나가 설명할 것입니다.

위험한 릴리스 전에. 게이트 섹션이 생각하는 대로 읽히는지 확인하십시오. 이것은 auto-rollback이 있다고 믿는 것과 실제로 있는 것의 차이입니다.

사고 중에. 환경 흐름은 어디에 실시간인지, 무엇인가 빌드 중인지를 알려줍니다.

문제 해결

페이지에 No repo connected가 표시됩니다. 프로젝트에 저장소가 없습니다. 연결하십시오: Connecting a GitHub Repository를 참조하십시오.

게이트가 켜져 있는데 배포가 여전히 진행됩니다. 푸시로 트리거된 것만 해당됩니다. 배포 훅 또는 수동 패널 배포는 영향을 받지 않습니다.

환경에 PAUSED가 표시됩니다. 미리보기 환경은 만료된 후 자동으로 일시 중지됩니다. 재배포하여 다시 가져오십시오.

Auto-promote가 표시되었지만 아무것도 승격되지 않습니다. 스모크 테스트가 통과하는 상태에서 구성된 시간 수가 필요하며, 즉시가 아닌 주기적으로 평가됩니다.

다음 단계

Deploying Your Project 각 게이트가 실제로 무엇을 차단하는지.
Orbit Project Settings 이 중 아무것이나 변경하려면.
Rolling Back a Deployment 게이트가 당신을 구하지 못했을 때.