Workshop 브랜치와 리베이스

Workshop은 Global Branching에 연결하여 모듈과 설정을 브랜치에서 개발합니다. 모듈 구성의 격리와 액션이 다루는 데이터 및 외부 작업의 범위는 전역 브랜치의 해당 조건을 따릅니다.

모듈을 브랜치에 추가

브랜치 선택기에서 작업할 브랜치로 전환하고 모듈을 연 뒤 변경 내용을 저장합니다. 저장한 모듈이 해당 브랜치의 자원에 포함됩니다.

모듈 안에 Quiver 대시보드처럼 Global Branching을 지원하지 않는 비Workshop 요소가 있으면 그 요소는 브랜치에서 수정할 수 없습니다.

보호된 main 자원

main에서 보호된 모듈은 Save and publish 대신 Save to new branch를 표시합니다. 직접 main을 수정하지 않고 브랜치에서 변경하도록 하는 기능입니다.

Save to new branch를 선택하면 브랜치 이름과 온톨로지를 지정하는 창이 열립니다. main에 반영할 준비가 되면 변경 제안을 만듭니다.

변경 검토

제안을 만들면 지정한 검토자에게 알립니다. 검토자가 브랜치의 모듈을 열면 Changelog로 이동합니다. 왼쪽 Review proposed changes에서 변경을 확인하고 Approve 또는 Reject를 선택합니다.

승인과 자원별 병합 조건은 전역 브랜치 보호 정책에 따릅니다.

리베이스 시작

브랜치에 모듈을 저장한 뒤 main에 새 변경이 생겨 브랜치가 이를 반영하지 못했다면 병합 전 리베이스가 필요합니다. 리베이스는 최신 main 위에 현재 브랜치의 변경을 적용하며, 이후 병합하기 전까지 main을 바꾸지 않습니다.

먼저 진행 중인 편집을 브랜치에 저장합니다. 저장하지 않은 Workshop 편집은 리베이스에서 보존되지 않아 사라집니다.

Changelog의 알림 표시를 선택하면 Rebase를 시작할 수 있습니다.

Rebase를 누르고 Start rebasing을 선택합니다. 충돌하지 않는 main 변경은 자동으로 받고 충돌은 직접 검토합니다.

Reject all changes from main은 main의 변경을 받아들이지 않고 현재 브랜치의 모듈 전체 구성을 유지하는 선택입니다. 이후 병합하면 그 구성이 main의 모듈 변경을 덮어씁니다. 브랜치의 전체 구성으로 교체하려는 경우에만 사용합니다.

충돌이 없을 때

Changelog에 충돌이 없다면 main의 비충돌 변경과 브랜치 변경이 결합됩니다. 표시된 변경을 검토한 뒤 모듈을 저장하여 리베이스를 마치고 병합을 진행합니다.

충돌의 단위

서로 다른 구성 필드의 변경은 자동으로 합칠 수 있습니다. 예를 들어 main이 섹션 제목을 바꾸고 현재 브랜치가 색을 바꾸면 둘을 유지합니다.

같은 필드, 변수 정의나 레이아웃 위치를 양쪽에서 바꾸면 충돌로 표시합니다. 대표적인 경우는 같은 위젯이나 변수의 충돌하는 변경, main에서 삭제한 섹션을 브랜치에서 수정한 경우, 같은 위젯을 위치 A에서 각각 B와 C로 옮긴 경우입니다.

검토 중에는 세 구성을 전환하여 화면에 미치는 영향을 볼 수 있습니다.

세부적인 시각적 변경 표시는 위젯, 섹션과 변수에 제공합니다. 레이아웃과 전역 모듈 설정의 변경은 Changelog에서 확인합니다.

위젯과 섹션 비교

구성 패널의 아이콘은 다음 차이를 나타냅니다.

변경 아이콘을 선택하면 main과 브랜치를 나란히 비교합니다.

Main branch 또는 Your branch를 선택하여 모듈에 해당 구성을 적용해 보고, 필요한 경우 직접 편집하여 양쪽 변경을 합칩니다. 유지할 구성을 정한 뒤 Resolve를 선택합니다.

변수 정의 비교

Changelog에서 충돌한 변수를 선택하면 변수 편집기와 양쪽 비교를 엽니다. Main branch와 Your branch의 정의 및 설정 전체를 확인하고 필요하면 비교 영역을 확장합니다.

한쪽을 선택하거나 정의를 직접 결합한 뒤 Resolve로 결정합니다.

두 지표를 함께 유지하는 예

가상 예에서 현재 브랜치는 Fiscal Week Revenue를 추가하고 main은 Fiscal Week Sales Volume을 추가했습니다. 기존 Active Campaigns 지표는 유지합니다.

두 새 지표를 모두 남기려면 Main branch를 선택한 뒤 Fiscal Week Revenue를 직접 추가합니다. 비교 상태가 Current session으로 바뀌며 결합된 구성을 보여 줍니다. Resolve를 선택하여 유지합니다.

모든 충돌을 해결하고 결과를 검토한 뒤 저장하면 리베이스가 끝납니다. 이후 main에 병합합니다. 버전의 게시 여부는 Versions에서 관리하고 변경 내역의 읽는 방법은 Changelog에서 설명합니다.