For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
브랜치 작업
Amplitude 데이터의 브랜치는 귀하와 귀하의 팀이 비공개로 편집하는 트래킹 플랜의 시점 복사본이며, 변경 사항을 기본 트래킹 플랜에 다시 병합하기 전까지는 다른 사람에게 공개되지 않습니다. Git을 사용한 적이 있다면 모델도 같은 방식으로 작동합니다. 브랜치에서 변경사항을 격리한 다음 준비가 되면 이를 병합합니다.
Amplitude 데이터 계정을 처음 생성할 때 Amplitude는 자동으로 main이라는 기본 브랜치를 생성합니다. 여기에는 시작할 수 있는 몇 가지 샘플 이벤트와 속성이 포함되어 있습니다. 브랜치를 프로덕션 브랜치라고 생각하십시오. 이 main브랜치는 최신 공식 트래킹 플랜을 포함하고 있으며 Git의 기본 브랜치(일반적으로 master 또는 main)에 계측된 내용과 일치합니다.
main 는 Amplitude 데이터를 시작하기에 적합하며, 당분간 이 브랜치가 필요한 유일한 브랜치라는 사실을 알게 될 수도 있습니다.
트래킹 플랜의 버전을 게시하십시오
브랜치는 처음에 사용자가 변경한 내용을 스테이징 영역에 보관하며, 이 영역에서는 변경 내용을 보류 중인 상태로 유지합니다. 보류 중인 변경은 작업 진행 중인 변경입니다. 즉, 사용자와 팀원에게는 보이지만 생산 시스템에는 숨겨져 있으며 엔지니어링 팀이 아직 계측을 위해 사용할 수 없습니다.
보류 중인 변경 사항이 준비되면 이를 게시하십시오. 변경사항을 게시하면 해당 변경사항을 포함하는 새 버전의 추적 계획이 생성됩니다. 게시 작업은 또한 해당 새 버전을 계측을 위해 엔지니어링 팀에 공개합니다. 새 버전이 기본 브랜치에 있는 경우 이러한 변경 사항은 운영 시스템에도 전파됩니다.
모든 새 버전에는 버전 번호와 선택적 설명이 있으므로 나중에 버전을 구분할 수 있습니다. 버전 번호는 1에서 시작하여 새 버전을 게시할 때마다 1씩 증가합니다.
모든 브랜치에는 고유한 추적 계획 버전이 있습니다. 즉, 버전 번호가 동일한 두 가지 트래킹 플랜 버전을 가질 수 있습니다. 하나는 main에 있고, 다른 하나는 자체 브랜치에 있습니다. 이 경우 혼동을 방지하기 위해 Amplitude 데이터는 항상 브랜치의 이름을 표시합니다.
브랜치 생성 및 삭제
귀하와 귀하의 팀이 Amplitude 데이터 사용을 늘리면 main 브랜치로는 충분하지 않아 보다 강력한 워크플로우가 필요할 수도 있습니다. 이 문제는 일반적으로 다음과 같은 경우에 발생합니다.
- 너무 많은 사람들이 동시에
main에 변경 사항을 적용하고 있거나, - 기능 팀은 협업하고, 작업을 검토하며, 이해관계자의 승인을 얻기 위해 추적 계획의 별도 사본을 갖기를 원합니다.
Amplitude 데이터에서 모든 브랜치는 main에서 생성되어 다시 통합됩니다main.
새 브랜치를 생성하려면 다음 단계를 수행하십시오.
페이지 헤더에서 메인(main)을 클릭합니다.
생성하려는 브랜치의 이름을 입력합니다.
**+**를 클릭합니다.
브랜치 생성 모달에서 브랜치 이름을 확인하고 선택적 설명을 추가한 다음 생성을 클릭합니다.
main에 보류 중인 변경 사항이 있는 경우, 해당 변경 사항을 새 브랜치에 가져오거나,main에 남겨 둘 수 있습니다.
브랜치를 삭제하려면 다음 단계를 수행하십시오.
- 브랜치 이름 옆에 있는 X를 클릭합니다.
- 표시되는 모달에서 삭제를 클릭하여 선택 사항을 확인합니다.
브랜치에서 작업
브랜치가 생성된 후에는 브랜치로 작업하는 것과 같은 작업이 가능합니다main. 여러분과 여러분의 팀은 새 버전을 만들어 게시하고, 제품에서 해당 버전을 계측하며, 계측 상태에 대해 브랜치에 리포트할 수 있습니다.
이 모든 작업은 자체 브랜치에서 작업하는 다른 팀과 동시에 수행될 수 있으며 사용자에게 전체 영향을 미치지 않습니다.
때때로 브랜치를 생성한 날짜 이후에 변경된 사항을 반영하여 main브랜치를 새로 고치십시오. Amplitude 데이터가 귀하의 브랜치가 오래된 것으로 main감지하면 페이지의 도구 모음에 새로고침 버튼이 표시됩니다. 클릭하여 최신 내용을 확인하세요.
브랜치를 다시 메인으로 병합하세요
브랜치에서 변경한 내용에 만족한다면 해당 내용을 main에 다시 병합하십시오. 이는 일반적으로 제품 팀이 변경 사항을 Git의 브랜치에 병합할 main준비가 된 경우에 발생합니다.
성공적으로 병합하기 전에 해결해야 할 몇 가지 사전 요구 사항이 있습니다.
- 브랜치에 보류 중인 모든 변경 사항을 게시해야 합니다.
- 귀하의 지점은
main을 최신 상태로 유지해야 합니다. main또한 보류 중인 모든 변경 사항도 게시되어야 합니다.
변경 사항을 브랜치의 새 버전으로 게시하려면 다음 단계를 따르십시오.
- 왼쪽 사이드바에서 변경 사항 저장을 클릭합니다.
- 변경 사항 저장 모달에서 보류 중인 변경 사항을 검토합니다. 모든 것이 올바르게 표시되면 저장을 클릭합니다.
병합하려면 다음 단계를 수행하십시오.
- 활동으로 이동합니다. 새로 고침을 클릭해야 할 수도 있습니다.
- 승인을 클릭합니다.
- 병합을 클릭합니다.
프로젝트에 팀 검토가 필요한 경우 직접 병합할 수 있는 권한이 없을 수도 있습니다. 이 경우 먼저 병합 요청을 생성해야 합니다. 병합 요청은 팀 외부의 이해관계자에게 변경 사항을 검토하고 명시적인 승인을 요청하는 방법입니다. 매니저 또는 관리자 권한 관리 권한을 가진 팀원만이 변경을 승인할 수 있습니다. 이를 위해서는 Amplitude 데이터에 로그인하고 페이지의 도구 모음에서 병합을 클릭하십시오.
그러면 팀의 모든 사용자가 승인된 병합 요청을 병합할 수 있습니다.
브랜치 변경 사항을 테스트 환경에 복사
브랜치에 변경 사항을 적용한 후 해당 변경 사항을 다른 프로젝트나 환경에 복사하여 테스트할 수 있습니다.
브랜치 변경 사항을 복사하려면 다음 단계를 수행하십시오.
- 복사하려는 브랜치에서 활동 > 브랜치 변경사항으로 이동합니다.
- 브랜치 복사를 클릭합니다.
- 나타나는 모달의 드롭다운에서 브랜치를 복사할 테스트 프로젝트를 선택합니다. 그런 다음 복사를 클릭합니다.
- 복사가 완료되면 알림을 클릭하여 복사된 브랜치를 검토합니다.
- 테스트 프로젝트의 변경 사항을 검토합니다. 변경 내용이 예상대로 나타나면 병합을 클릭합니다.
관리자와 관리자 권한 보유자는 브랜치 변경 사항의 사본을 수락할 수 있는 프로젝트를 제한할 수도 있습니다.
브랜치 복사를 제한하려면 다음 단계를 수행하십시오.
- 소스 프로젝트에서 설정 > 일반으로 이동합니다.
- '지정된 테스트 프로젝트로만 브랜치 복사 제한' 옆의 확인란을 선택합니다.
- 드롭다운에서 다른 Amplitude 사용자가 브랜치 변경 사항의 사본을 저장할 수 있는 프로젝트 옆의 확인란을 선택합니다.
이 내용이 도움이 되었나요?