외부 버전 관리 사용
개요
- Git과 SVN 저장소 워크플로의 기본적인 차이점을 이해합니다.
- Projects 및 Storage Manager 패널에서 파일 상태를 확인하고, 리비전 이력에 접근하며, 버전 관리 작업을 수행하는 위치를 알아봅니다.
- Schematic 및 PCB 비교 기능이 공유 설계 작업을 수행하는 팀을 어떻게 지원하는지 살펴봅니다.
전자 저작 및 편집 환경의 가장 큰 장점 중 하나는 파일을 쉽게 생성하고 수정할 수 있다는 점입니다. 이 기능 덕분에 아이디어를 빠르게 기록하고 탐색하며 발전시킬 수 있지만, 소스 코드나 전자 설계 데이터와 같은 중요한 파일의 변경 사항을 추적하기 어려울 수도 있습니다.
파일의 변경 사항을 추적해야 할 필요성과 전자 형식으로 기록된 소스를 체계적으로 관리할 솔루션의 필요성이 맞물려 버전 관리 시스템(VCS)이 등장했습니다. 버전 관리 시스템은 파일의 여러 버전에 대한 이력을 유지할 뿐만 아니라 해당 파일의 모든 리비전을 열고 임의의 두 버전 간 변경 사항을 비교할 수 있도록 지원하는 소프트웨어 도구입니다. 일반적으로 VCS는 폴더와 파일에 대한 추가 버전 관리 기능과 작업을 제공하여 로컬 운영 체제(OS)와 통합됩니다.
버전 관리 시스템은 파일 생성에 사용되는 저작 및 편집 환경과 완전히 독립적으로 운영할 수 있습니다. 일반적으로 파일을 추가(Add)한 후 저장소라는 중앙 저장 영역에 Commit할 수 있는 인터페이스, 저장소의 파일을 작업 폴더로 복사하는 체크아웃(Checkout) 기능, 변경 사항을 저장소에 다시 반영하는 Commit 기능, 변경 정보를 기록하는 방법 등 다양한 기능을 제공합니다.
이러한 기능은 Tortoise 클라이언트와 같은 Windows 셸 확장 프로그램에서 제공되며, Altium Designer 자체에도 포함되어 있습니다. OS 파일 시스템에 액세스할 필요 없이 Altium Designer 환경 내에서 VCS 작업을 수행할 수 있습니다.
버전 관리 시스템에서 사용하는 용어를 이해해 두면 도움이 됩니다. 다양한 시스템이 있지만 일반적으로 기능을 설명하는 데 유사한 용어를 사용합니다.
버전 관리의 기본 사항
Altium Designer는 Subversion(SVN) 및 Git 버전 관리 시스템(VCS)을 지원합니다. 이러한 시스템을 내부적으로 지원하므로 Altium Designer 내에서 Commit, 업데이트(Update) 등 일반적인 SVN/Git 파일 처리 명령을 사용할 수 있으며, SVN 저장소 생성과 같은 추가 Subversion 기능도 제공합니다. 이는 Schematic 및 PCB 비교 기능과 통합되어 두 Schematic 또는 PCB 문서 리비전 간의 차이를 빠르게 비교하고 식별할 수 있으며, PCB 설계에서는 동시 수정으로 발생한 리비전 충돌을 해결할 수 있습니다.
버전 관리 시스템(VCS)을 사용하는 기본 방식은 저장소에서 작업할 프로젝트 파일의 사본을 가져와 Altium Designer에서 편집한 다음, 수정된 파일을 저장소에 다시 ‘Commit’하는 것입니다. 저장소와의 상호 작용은 버전 관리 시스템 인터페이스를 통해 이루어지며, Altium Designer에서는 이 인터페이스가 Storage Manager Panel 및 Projects Panel에 내장되어 있습니다.
버전 관리 시스템의 핵심 작동 원리는 작업 폴더를 통해 저장소에서 가져온 파일의 상태를 모니터링하여 현재 작업 중인 리비전과 수정 여부를 추적하는 것입니다. 결과는 같지만 저장소와 작업 파일의 구성 방식은 버전 관리 시스템 유형(Git 또는 SVN)에 따라 다릅니다.
Git VCS
아래 그림은 설계 파일의 리비전 이력(리비전 5까지)을 보관하는 원격 Git 공유 저장소의 개념을 보여줍니다. 이 저장소의 콘텐츠는 일반적으로 원격 저장소를 복제(Clone)하거나 데이터를 작업 저장소로 가져오기(Pull)하여 로컬 작업 Git 저장소에 복사됩니다. 작업 저장소의 파일을 Altium Designer 환경에서 열면 Altium Designer는 프로젝트 파일이 Git 버전 관리 대상임을 인식하고, 현재 버전 관리 상태를 Storage Manager 및 Projects Panel 모두에 표시합니다.
► 자세한 내용은 Git 기반 버전 관리 페이지를 참조하세요.
Subversion VCS
아래 그림은 설계 파일의 리비전 이력(리비전 5까지)을 보관하는 Subversion 저장소의 개념을 보여주며, 최신 사본이 작업 폴더에 체크아웃(File » Check Out)되어 있습니다. 작업 폴더의 파일을 Altium Designer 환경에서 열면 Altium Designer는 프로젝트 파일이 SVN 버전 관리 대상임을 인식하고, 현재 버전 관리 상태를 Storage Manager 및 Projects Panel 모두에 표시합니다.
► 자세한 내용은 SVN 기반 버전 관리 페이지를 참조하세요.
위의 두 VCS 시스템 모두에서 소스 저장소와 작업 위치 간의 연결 정보는 작업 위치의 VCS 데이터베이스(.svn 또는 .git 시스템 하위 폴더)에 기록됩니다.
Altium Designer에서 VCS 작업 파일을 연 상태에서는 Storage Manager Panel 및 Projects Panel의 마우스 오른쪽 버튼 클릭 메뉴를 통해 변경된 파일을 중앙 저장소(SVN) 또는 작업 저장소(Git)에 Commit하는 등의 표준 VCS 작업을 수행할 수 있습니다.
버전 관리 기능에 액세스
Altium Designer에서는 Projects 및 Storage Manager Panel을 통해 VCS 관련 작업을 수행할 수 있으며, Storage Manager Panel에서는 추가 VCS 명령과 정보에 직접 액세스할 수 있습니다. Altium Designer에서 프로젝트 문서를 열면 해당 문서와 관련 VCS 상태가 이 Panel들에 표시됩니다.
이 Panel들은 워크스페이스 오른쪽 하단의
버튼 메뉴 또는 기본 View » Panels 메뉴에서 열 수 있습니다.
Projects Panel
Projects Panel에는 현재 Altium Designer에 열려 있는 모든 프로젝트와 각 프로젝트를 구성하는 문서, 각 파일의 관련 버전 관리 상태가 표시됩니다.
Panel의 VCS 파일 상태는 버전 제어 시스템에서 감지한 특정 파일 상태에 해당하는 일련의 아이콘으로 표시됩니다. 각 파일의 상태는 일반적으로 연결된 저장소에서 버전 제어 중인 해당 파일과 비교한 상태를 나타냅니다. Projects Panel의 VCS 명령은 Panel의 마우스 오른쪽 버튼 클릭 컨텍스트 메뉴에 있는 Version Control 옵션에서 액세스할 수 있습니다.
Projects Panel에 표시되는 버전 제어 아이콘
► 자세한 내용은 Projects Panel 페이지를 참조하세요.
Storage Manager Panel
Storage Manager Panel은 파일 저장 관점에서 활성 문서에 대한 상세 정보를 제공하며, 로컬 문서 기록 기능과 버전 제어 상태/명령에 액세스할 수 있도록 합니다.
Panel의 VCS 파일 상태는 버전 제어 시스템에서 감지한 특정 파일 상태에 해당하는 일련의 설명과 아이콘으로 표시됩니다. 각 파일의 상태는 일반적으로 연결된 저장소에서 버전 제어 중인 해당 파일과 비교한 상태를 나타냅니다.
Storage Manager Panel의 VCS 명령은 마우스 오른쪽 버튼 클릭 컨텍스트 메뉴에서 액세스할 수 있습니다. 특정 파일에 대해 VCS 작업을 수행하려면 Panel에서 해당 항목을 마우스 오른쪽 버튼으로 클릭하고 원하는 명령(예: Commit, 업데이트, 충돌 해결 등)을 선택하세요.
선택한 파일의 리비전 기록과 로컬 문서 기록은 Panel 하단에서 확인할 수 있으며, 마우스 오른쪽 버튼 클릭 옵션에서 '클래식 보기'로 전환하면 전체 이벤트 타임라인을 볼 수 있습니다 – Switch to Classic View . 표시된 리비전 번호는 VCS Commit을 수행할 때마다 증가하며, 첫 번째 리비전(리비전 1)은 파일을 추가하기 전에 VCS 프로젝트 폴더를 생성한 시점에 해당합니다.
► 자세한 내용은 Storage Manager Panel 페이지를 참조하세요.
버전 제어 상태
Projects 및 Storage Manager Panel 모두에서 버전 제어 중인 각 파일의 현재 VCS 상태가 Panel의 해당 항목과 함께 표시됩니다.
버전 제어 시스템은 기본적으로 작업 폴더의 파일을 모니터링하고 설계 저장소의 해당 파일과 비교합니다. Altium Designer는 VCS 인터페이스를 통해 버전 제어 시스템에 정보를 요청하고 교환하며, 파일 비교 결과에 따른 상태에 맞게 대응합니다. 실제로 이러한 동작은 Projects 및 Storage Manager Panel의 파일 아이콘, 다양한 VCS 알림, 사용 가능한 파일 관리 명령의 적절한 변경으로 나타납니다.
아이콘과 그 의미는 프로젝트 문서 관리 페이지의 버전 제어 상태 아이콘 섹션에 설명되어 있습니다.
다중 사용자 액세스
대부분의 경우 기업의 버전 제어 인프라는 중앙 SVN 또는 Git 저장소를 기반으로 하며, 사용 가능한 프로토콜 방식(svn, svn+ssh, https 등) 중 하나를 사용하여 네트워크를 통해 제공됩니다. 이를 통해 네트워크의 모든 사용자는 권한에 따라 액세스할 수 있으며, 단일 소스를 기반으로 프로젝트를 공동 개발할 수 있습니다.
이러한 다중 액세스 기능을 통해 각 팀원은 다른 사람이 파일을 다시 체크인할 때까지 기다릴 필요 없이 프로젝트 작업을 독립적으로 계속할 수 있습니다. 분산형 Git 버전 제어 시스템은 이러한 이점을 한 단계 더 발전시켜, 작업 중에 파일을 로컬 작업 저장소에 Commit하고 나중에 언제든지 Commit된 변경 사항을 중앙 Git 저장소로 ‘푸시’할 수 있도록 합니다. 따라서 그때까지는 네트워크 연결이 필요하지 않습니다.
그럼에도 불구하고 팀 작업을 지원하는 VCS에는 두 사용자가 동일한 파일을 수정하는 불가피한 상황을 해결할 수 있는 도구와 기법이 필요합니다. 이러한 기능이 갖춰져야 진정한 다중 사용자 설계 협업과 그에 따른 이점을 실현할 기반이 마련됩니다.
이러한 상황을 지원하기 위해 Altium Designer에는 Storage Manager Panel에서 사용할 수 있는 Schematic 및 PCB 비교('diff') 기능이 포함되어 있습니다.
VCS 저장소
확인된 소스 파일 세트를 기반으로 작업하는 가장 좋은 방법은 버전 제어 저장소와 같이 통제된 환경에 설계 프로젝트를 저장하는 것입니다. 이는 올바른 소스 파일에서 출력물이 생성되었음을 보장하는 유일한 방법이 다음과 같기 때문에 중요합니다.
- 소스 파일 세트가 최신 상태인지 확인합니다.
- 해당 파일의 스냅샷을 생성합니다.
- 해당 스냅샷에서 출력물을 생성합니다.
Altium Designer에서는 이러한 저장소를 Design Repository(이)라고 합니다. 설계 팀이 소유하는 설계 저장소에는 설계 프로세스의 상세한 이력이 담겨 있으며, 설계 팀의 주요 협업 도구로 사용됩니다.
설계 저장소는 여러 팀원이 데이터를 체크인하고 체크아웃할 수 있는 중앙 저장소 역할을 하며, 설계에 적용된 모든 변경 사항의 전체 리비전 기록을 유지합니다. 따라서 설계는 이를 구성하는 프로젝트 및 소스 문서의 일련의 버전으로 저장되어, 시간에 따른 설계자의 의도가 점진적으로 드러납니다. 버전 제어되는 설계 저장소를 사용하면 설계의 어떤 리비전도 손실되지 않도록 보장되므로, 지리적으로 떨어져 있는 팀원들도 동일한 설계에서 안전하게 협업할 수 있습니다. 버전 제어 시스템은 그 특성상 설계에 대한 감사 추적 기록을 제공합니다. 누가, 어떤 소스 문서에서, 무엇을, 언제 변경했는지 투명하게 확인할 수 있으므로 책임 소재가 명확해집니다. 시스템은 버전 제어되는 여러 설계 저장소를 지원할 수 있으며, 특정 저장소와의 연결은 프로젝트 폴더 내의 버전 제어 링크를 통해 설정됩니다.
버전 제어를 사용하기 전에 VCS와 Altium Designer 모두에서 프로젝트 파일이 버전 제어 중인 것으로 인식되어야 합니다. 이 과정은 VCS 방식과 애플리케이션에 따라 다를 수 있지만, 기본적으로 설계 저장소를 생성하거나 기존 저장소에 연결하고 해당 저장소에 설계 프로젝트 파일을 추가하는 작업으로 이루어집니다.
설계 저장소는 데이터베이스 구조를 기반으로 하며, 내부적으로 파일 트리라고 하는 파일 및 디렉터리의 계층 구조에 정보를 저장합니다. 실제로 연결하는 저장소는 중앙 SVN 저장소, 원격 Git 저장소와 연결된 Git 작업 저장소 또는 로컬 PC나 공유 네트워크 위치와 같이 액세스 가능한 위치에 생성한 저장소일 수 있습니다.
새 변경 사항을 버전 관리에 반영
프로젝트를 버전 관리에 추가하면 로컬 작업 프로젝트 폴더가 VCS 저장소의 해당 폴더에 연결됩니다. 이는 Storage Manager 패널의 프로젝트 폴더 항목에 표시되는 링크 아이콘으로 확인할 수 있습니다. 연결된 폴더와 저장소의 위치를 확인하려면 패널에서 파일 항목을 마우스 오른쪽 버튼으로 클릭하고 VCS Properties 옵션을 선택합니다(Git 사용 시에는 사용할 수 없음). 이어서 표시되는 Properties 대화 상자에는 연결된 위치의 경로와 최신 VCS 리비전 정보가 포함되어 있습니다.
링크 아이콘으로 표시된 파일과 최신 VCS 리비전 정보가 포함된 해당 Properties 패널
Properties 대화 상자는 다음 정보를 제공합니다(정보는 보기 전용이며 편집할 수 없습니다).
- Path - 작업 폴더에 있는 로컬 문서의 경로.
- URL - VCS 저장소에서 문서가 있는 위치의 URL.
- Repository Root - 저장소 루트.
- Repository UUID - 저장소 UUID.
- Revision - 로컬 작업 폴더에 있는 문서의 현재 리비전.
- Last Change Author - 마지막 변경 작성자.
- Last Change Revision - 마지막 변경 리비전.
- Last Change Time - 마지막 변경 날짜 및 시간.
- Conflicted - 문서의 충돌 여부.
등록된 VCS 링크를 통해 버전 관리 시스템은 로컬 프로젝트 폴더의 파일과 VCS 저장소 폴더의 해당 파일 간 차이를 모니터링하고 감지할 수 있습니다. Altium Designer에서 설계 파일을 편집하고 저장하는 등의 차이가 감지되면 버전 관리 시스템은 로컬 파일의 상태를 Modified(으)로 변경하고, Altium Designer는 패널의 마우스 오른쪽 버튼 클릭 메뉴에 적절한 VCS 명령을 제공합니다.
변경 사항 Commit
Altium Designer에서 프로젝트 문서 파일을 편집하고 저장하면 해당 파일에 Modified 플래그가 지정되며, Projects 및 Storage Manager 패널에 모두 이 상태가 표시됩니다. 이러한 변경 사항을 VCS의 새 리비전으로 커밋하려면 패널에서 파일 항목을 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 Commit 명령을 선택하거나, 기본 메뉴에서 Project » History & Version Control » Commit 명령을 선택합니다.
Commit Whole Project 명령을 사용하여 프로젝트에서 수정된 모든 파일을 커밋할 수도 있습니다. 전체 프로젝트를 커밋하면 Commit to Version Control 대화 상자가 열립니다.

Commit to Version Control 대화 상자
버전 관리에 Commit 대화 상자의 옵션 및 컨트롤
상단 창
상단 창에는 선택한 프로젝트의 모든 파일과 각 파일의 VCS 포함 여부가 나열됩니다. 파일이 추가 또는 삭제 대상으로 표시되어 있는지 여부를 비롯한 관련 정보도 함께 표시됩니다. 설계자는 버전 관리에 커밋할 파일을 선택할 수 있습니다. Path 열에는 각 파일의 경로가 표시되고, Status 열에는 파일의 현재 상태가 표시됩니다. 이 영역에는 다음 옵션을 제공하는 간단한 마우스 오른쪽 버튼 클릭 메뉴도 있습니다.
- Select All - 클릭하면 대화 상자에 나열된 모든 파일을 선택합니다. 선택한 파일은 VCS에 추가됩니다.
- Select None - 클릭하면 대화 상자에 나열된 모든 파일의 선택을 해제합니다. 이 파일들은 VCS에 추가되지 않습니다.
- Select Project Documents - 클릭하면 프로젝트 문서만 선택합니다. 선택한 파일만 VCS에 추가됩니다.
하단 창
- Comment - 설계자는 파일을 버전 관리에 커밋하기 전에 이 텍스트 상자에 설명을 작성할 수 있습니다.
- Commit and Push - 이 명령은 선택한 파일(Storage Manager 패널의 Files 영역에 있는 파일)의 작업 사본에 적용한 수정 사항을 VCS 저장소에 체크인하고 프로젝트 업데이트를 서버로 푸시하는 데 사용됩니다. 수정된 파일은 Modified 상태로 구분됩니다.
- Commit - 드롭다운에서 Commit 버튼에 액세스할 수 있습니다. 이 버튼을 사용하면 선택한 파일(Storage Manager 패널의 Files 영역에 있는 파일)의 작업 사본에 적용한 수정 사항을 VCS 저장소에 체크인할 수 있습니다. 수정된 파일은 Modified 상태로 구분됩니다.
-
When using Subversion (SVN): 커밋 프로세스는 업데이트된 파일을 로컬 폴더에서 저장소로 복사하고, VCS 항목의 리비전 번호를 증가시키며, 파일 상태를 다시
No Modification(으)로 설정합니다. -
When using Git: 커밋 프로세스는 로컬 작업 저장소 VCS를 업데이트하고 항목의 리비전 번호를 증가시키며 파일 상태를
Ahead of Server(으)로 설정합니다. 작업 저장소에서 파일을 계속 편집, 저장 및 커밋할 수 있으며, Push 명령을 사용하여 원격 Git 저장소를 업데이트함으로써 새 변경 사항을 확정할 수도 있습니다. 그러면 파일 상태가 다시No Modification(으)로 돌아갑니다.
Storage Manager 패널을 열어 VCS Revisions 섹션에서 작업 순서를 확인합니다. 여기에는 해당 파일에 대한 새 VCS 리비전(증가된 리비전 번호)의 생성 내역이 포함됩니다. 이 예에서는 리비전 3 및 추가된 설명이 표시됩니다.
아이콘은 선택한 파일의 최신 리비전이자 현재 리비전, 즉 버전 관리 용어로 Head 리비전을 나타냅니다.
Storage Manager Panel의 VCS 리비전 섹션
리비전 항목과 기록 이벤트 항목을 함께 보려면 마우스 오른쪽 버튼 클릭 컨텍스트 메뉴에서 Switch to Combined View을 선택하여 싱글 Timeline 보기로 전환하세요.
버전 관리에서 체크아웃
위에서 설명한 대로, 버전 관리에 추가된 로컬 프로젝트는 프로젝트의 로컬 폴더에서 Altium Designer로 편집할 수 있으며, 변경 사항은 이후 VCS 저장소에 업데이트됩니다. 로컬 폴더와 저장소 폴더는 VCS를 통해 연결되며 최종적으로 동기화됩니다.
원본 폴더가 사용자 PC에 로컬로 존재하므로 해당 폴더의 프로젝트에 액세스할 수 없는 다른 사용자는 Clone(Git) 또는 Check Out (SVN) 프로세스를 사용하여 프로젝트가 호스팅된 VCS 저장소에서 파일의 자체 사본을 가져올 수 있습니다. 프로젝트 설계에 공동으로 참여하려는 모든 사용자는 이 공통 설계 저장소에 연결해야 하며, 일반적으로 이 저장소는 로컬 네트워크나 서버를 통해 액세스할 수 있도록 구성됩니다.
선택한 저장소 프로젝트 폴더와 그 안의 파일은 지정된 로컬 폴더로 체크아웃되어 Altium Designer에서 열립니다. 이 로컬 폴더는 선택한 저장소의 체크아웃 폴더로 정의된 폴더이며, 체크아웃된 프로젝트는 이후 VCS 저장소의 해당 프로젝트와 연결됩니다. VCS 연결을 통해 버전 관리 시스템은 로컬 체크아웃 폴더의 파일과 VCS 저장소 폴더의 해당 파일 간 차이를 모니터링하고 감지합니다.
파일 편집이 완료되면 변경 사항을 Commit하세요. 그러면 설계 저장소의 파일이 체크아웃 폴더의 파일과 일치하도록 동기화되고 새 VCS 리비전이 생성됩니다.
체크아웃과 프로젝트 열기 비교
local 프로젝트가 버전 관리에 추가되면 실제로 다음 두 가지 방법으로 편집하고 VCS에 업데이트할 수 있습니다.
-
Altium Designer에서 로컬 프로젝트(File » Open Project)를 연 다음, 저장된 변경 사항을 VCS 저장소에 Commit합니다. 이 경우 로컬 프로젝트 폴더와 저장소의 해당 폴더는 VCS를 통해 연결됩니다.
-
VCS 저장소에서 프로젝트를 체크아웃(File » Check Out)한 다음, Altium Designer에서 편집하고 저장한 변경 사항을 저장소에 다시 Commit합니다. 이 경우 지정된 체크아웃 폴더의 프로젝트와 저장소의 해당 프로젝트는 VCS를 통해 연결됩니다.
로컬 프로젝트는 다른 사용자와 공유하는 VCS 프로젝트의 소스, 즉 원본입니다. 원하는 작업 방식에 따라 이 로컬 원본 버전을 삭제하거나 보관용 프로젝트 소스로 잠근 다음, Check Out 방식을 사용하여 추가로 편집할 수 있습니다. 또는 로컬 '원본' 폴더(Open Project)에서 프로젝트 파일을 계속 열고 작업할 수도 있습니다.
두 옵션은 서로 다른 위치의 작업 폴더, 즉 로컬 원본 프로젝트 폴더 또는 지정된 VCS 체크아웃 폴더를 사용하므로 한 가지 방식만 일관되게 사용하는 것이 가장 좋습니다. 체크아웃 방식을 권장합니다. 반대로 두 방식을 모두 사용하면 로컬 PC에 동일한 프로젝트의 활성 사본이 여러 개 존재하게 됩니다. 하지만 편집할 때마다 이러한 버전을 중앙 VCS 저장소에 빠짐없이 Commit하면 저장소에는 의도한 대로 항상 프로젝트의 최신 리비전이 유지됩니다.
또한 VCS 저장소에서 프로젝트를 처음 체크아웃한 후에는 프로젝트가 로컬에 존재하므로 체크아웃 폴더(File » Open Project)에서 바로 다시 열 수 있습니다. 이 경우에도 VCS에서 프로젝트를 체크아웃하거나 로컬 버전을 여는 방법 중에서 선택할 수 있지만, 로컬 사본은 항상 하나만 존재합니다. 실제 VCS 작업 측면에서 두 방식은 매우 유사하지만, 특정 상황에서는 다르게 동작합니다. 예를 들어 로컬 파일이 누락된 경우 체크아웃 프로세스는 파일을 복원하지만, Open Project 명령은 프로젝트에서 해당 파일을 제거합니다.
버전 관리 리비전
Altium Designer에서 버전 관리 대상인 설계 문서로 작업할 때 중앙(공유) VCS 저장소에서 가져온 설계 파일은 해당 파일의 최신 리비전입니다. 로컬 편집을 완료하고 공유 VCS 저장소에 다시 Commit하거나 Git의 경우 푸시하면, 이 파일 버전이 최신 리비전이 됩니다.
따라서 프로젝트 설계가 진행됨에 따라 체크아웃, 편집, 저장, Commit(그리고 Git의 경우 Push)의 일반적인 순서를 거치면서 중앙 VCS에 새 파일 리비전이 계속 추가됩니다. 그러나 여러 설계자가 프로젝트를 공동 개발하는 경우에는 어느 설계자든 언제든지 새 리비전을 중앙(공유) 저장소에 Commit할 수 있습니다.
최신이 아닌 리비전
여러 설계자와 중앙 저장소 간의 상호 작용은 다양한 형태로 나타날 수 있습니다. 그중 하나는 로컬에서 열려 있는 프로젝트가 더 이상 최신 리비전이 아닌 경우입니다. 저장소에서 체크아웃했거나 로컬 작업 폴더에서 연 프로젝트가 Projects Panel에서 Out of date 상태로 표시됩니다.
이 경우 로컬에서 마지막으로 편집한 이후 다른 사용자가 동일한 프로젝트를 편집하여 저장소에 Commit한 것입니다. 예를 들어 로컬 사용자 Barry이 프로젝트에서 작업하고 Revision 14을 Commit했지만, 아래 Storage Manager Panel에 표시된 것처럼 다른 사용자 Harold이 그 이후에 Revision 15을 Commit한 경우입니다. VCS가 로컬 작업 폴더의 파일과 저장소의 해당 파일(이 경우 더 최신인 파일) 간 차이를 감지하므로, 시스템은 가장 최근의 local 리비전아이콘으로 표시)을 최신이 아닌 것으로 판단합니다.
이 상황은 Projects 또는 Storage Manager Panel의 마우스 오른쪽 버튼 클릭 컨텍스트 메뉴에서 Update 명령을 사용하여 로컬 파일을 중앙 VCS 저장소의 파일과 일치하도록 업데이트하면 해결됩니다. 그러면 두 파일 버전이 동기화되고, 사용자 Barry의 로컬 버전이 최신 리비전(이 예에서는 Revision 15)으로 업데이트됩니다. 파일이 Out of date 상태로 지정되어 있을 때 Save하면 VCS가 작업 폴더에서 파일의 이전 리비전이 업데이트되었음을 감지하여 VCS Conflict 상황이 발생합니다.
의 중앙 저장소 및 로컬 리비전Update Whole Project 명령을 선택하여 공유 저장소에서 체크아웃할 파일을 선택할 수 있는 Update from Version Control 대화 상자에 액세스할 수도 있습니다. 프로젝트에서 최신이 아니거나 충돌이 있는 모든 문서가 이 대화 상자에 표시됩니다. 특정 문서만 선택하여 업데이트하거나 모든 문서를 한 번에 업데이트할 수 있습니다. 선택한 문서는 저장소에서 업데이트되며, 최신이 아닌 모든 문서는 기본적으로 선택되어 있습니다. 선택한 모든 문서는 저장소의 최신 버전으로 업데이트됩니다.

Update from Version Control 대화 상자
Path 열에는 파일 디렉터리가 표시됩니다. Status 열에는 파일의 현재 상태가 표시됩니다. 파일 상태가 Conflict로 표시되는 경우 OK을 클릭하여 파일을 업데이트하면 확인 대화 상자가 나타납니다. OK을 클릭하면 저장소의 최신 버전으로 업데이트되고, Cancel을 클릭하면 종료하고 변경 사항을 현재 저장소에 있는 버전에 저장합니다.
리비전 충돌
여러 설계자와 중앙 저장소 간의 상호 작용으로 인해 두 Altium Designer 사용자가 동일한 파일을 로컬에서 편집하고 저장한 후, 그중 한 명이 변경 사항을 커밋한 상황이 발생할 수도 있습니다.
이는 한 설계자의 작업 순서(체크아웃, 편집, 저장, 커밋)가 다른 설계자의 작업 순서와 겹쳤다는 의미입니다. 따라서 사용자가 편집하기 위해 저장소에서 체크아웃한 파일이 작업 중에 최신 리비전으로 remain되지 않을 수 있습니다. 그사이에 다른 사용자가 리비전을 업데이트했기 때문입니다. 이 경우 편집 내용을 저장소에 먼저 커밋하는 사용자가 새 리비전을 생성하여 우선권을 갖게 되며, 동일한 파일을 편집하고 저장한 다른 사용자는
아이콘으로 표시되는 Conflict 상황에 놓이게 됩니다.
작업 폴더의 파일과 저장소의 파일을 비교하는 VCS 관점에서 충돌은 작업 폴더에 있는 파일의 오래된 리비전이 편집되고 저장된 상태를 의미합니다.
Storage Manager Panel의 Git VCS 리비전
파일이 Conflict 상태일 때 사용할 수 있는 명령 옵션은 Projects Panel의 History & Version Control 마우스 오른쪽 버튼 클릭 메뉴, Project » History & Version Control 기본 메뉴 및 Storage Manager Panel에서 액세스할 수 있습니다.
-
Commit – 이 옵션을 사용하면 Subversion 오류가 발생합니다. 로컬에서 편집한 리비전(예:
Revision 15)을 커밋하면 다른 사용자가 이미 커밋한 최신 리비전(Revision 16)을 덮어쓰게 되기 때문입니다. -
Update – 이 옵션은 로컬 파일 리비전을 중앙 저장소의 최신 버전(
Revision 16)으로 업데이트하므로,Revision 15에 적용한 모든 로컬 변경 사항이 손실됩니다. -
Resolve Conflict – 이 옵션은 마지막으로 업데이트한 이후 저장소에 커밋된 변경 사항을 삭제합니다. 명령을 실행하면 확인 대화 상자가 나타납니다. 계속하려면 Yes을 클릭합니다. 작업 폴더의 프로젝트 파일은 다른 사용자가 저장소에 체크인한 최신 리비전으로 업데이트되지만, Editor에는 이전 리비전에 적용한 변경 사항이 유지됩니다. 따라서 로컬 파일은 Modified 상태가 되며, Commit 명령 또는 Commit Whole Project 명령을 사용하여 해당 변경 사항을 저장소의 새 리비전으로 커밋할 수 있습니다. 프로젝트 파일을 커밋하면 저장소에 더 새로운 리비전이 생성되므로, 다른 사용자에게는 해당 파일이 Out of date로 표시됩니다.
Subversion 시스템이 차이점을 로컬 파일에 병합하려고 시도하므로, 이 옵션은 text 파일에 충돌이 발생한 경우에만 권장됩니다. 이 과정에서 설계 문서와 같은 다른 파일 형식이 손상될 수 있으므로, 최신 소스 리비전으로 업데이트하거나 로컬 변경 사항을 되돌리는 것이 충돌을 해결하는 가장 좋은 방법입니다.
-
Revert – 이 옵션은 로컬 변경 사항을 삭제(실행 취소)하고 로컬 파일을 기본 리비전(여기서는
Revision 15)으로 되돌립니다. 이로써 리비전 충돌은 해결되지만, 저장소에 더 새로운 리비전(Revision 16)이 있으므로 파일은Out of date로 표시됩니다.
리비전 비교
버전 제어 작업의 유용한 기능 중 하나는 설계 파일의 이전 리비전을 비교하는 기능입니다. 이 기능은 Altium Designer에 내장된 차이점 비교기에서 제공하며, Storage Manager Panel에서 액세스할 수 있습니다. Differences Panel과 함께 사용하면 영향을 받는 객체를 대화형으로 살펴보면서 VCS 리비전 간의 논리적 또는 그래픽 비교를 수행할 수 있습니다. Schematic 및 PCB 리비전을 모두 비교할 수 있습니다.
► 차이점을 탐색하는 방법에 대한 자세한 내용은 Differences Panel 페이지를 참조하십시오.
두 리비전을 비교하려면 Storage Manager Panel의 VCS Revisions 목록에서 표준 Ctrl+click 방법을 사용하여 두 항목을 선택한 다음, Panel의 마우스 오른쪽 버튼 클릭 컨텍스트 메뉴에서 Compare 명령을 선택합니다.
Storage Manager Panel의 Compare 명령
두 파일 리비전은 화면 분할 모드로 열리므로 시각적으로 비교할 수 있습니다. 표시되는 차이점은 Options for Project 대화 상자의 Comparator 탭에서 Physical 비교 유형에 대해 선택한 옵션에 따라 결정됩니다(Project » Project Options).
비교 차이점을 찾고 확인하는 핵심 도구는 문서 간의 논리적 또는 그래픽 차이점을 선택 가능한 목록으로 제공하는 Differences Panel입니다. Panel에 나열된 각 문서 리비전의 항목은 Editor와 연동되므로, 감지된 차이점(예: 이동된 객체)을 선택하면 그래픽으로 강조 표시됩니다.
Differences Panel에서 비교 차이점 찾기 및 확인
비교 기능은 Schematic 및 텍스트 기반 문서의 리비전뿐 아니라 PCB 문서의 리비전에도 적용됩니다.
- Schematic 또는 PCB(설계 또는 라이브러리) 문서의 경우 그래픽 비교가 수행되며, 감지된 차이점이 Differences Panel에 나열됩니다. 설계 Editor 창에서 문서의 두 버전을 나란히 열어 놓고 차이점을 그래픽으로 살펴볼 수 있습니다. 감지된 차이점의 최상위 폴더를 클릭하면 두 문서에서 해당 차이점이 동시에 강조 표시됩니다.
- 텍스트 기반 ASCII 문서의 경우, CompareForm 대화 상자가 나타나 문서의 두 버전 간 차이를 그래픽으로 보여줍니다. 선택한 문서는 나란히 표시됩니다. 이 대화 상자는 비교 전용이므로 불러온 문서를 수정할 수 없습니다. 대화 상자는 색상 구분을 통해 두 문서 버전 간의 다양한 차이점, 즉 추가된 줄(분홍색), 수정된 줄(녹색), 삭제된 줄(파란색)을 강조 표시합니다. 변경 사항 요약과 색상 범례는 대화 상자의 왼쪽 하단에 표시됩니다.
Compare 명령은 현재 로컬 리비전(작업 폴더에 있음)과 저장소의 최신 리비전을 포함하여 어떤 리비전 쌍에도 적용할 수 있습니다. 이 경우 최신 로컬 리비전은 Storage Manager 패널에 Out of date(으)로 표시되지만, 다른 사용자가 저장소에 추가한 더 새로운 리비전과 비교할 수 있습니다.
로컬 리비전은 Storage Manager 패널에 Out of date로 표시됩니다
이 방법을 사용하면 새 리비전으로 업데이트할 때 적용될 변경 사항을 그래픽으로 미리 확인할 수 있습니다. 위 예시 이미지에서 현재 로컬 리비전아이콘으로 표시됨)은 Revision 19이지만, 다른 사용자가 새 리비전(Revision 22)을 저장소에 커밋했습니다. Revision 19과 Revision 22을 시각적으로 비교하면 저장소의 새 변경 사항을 수락할지 충분히 검토하여 결정할 수 있습니다. 이에 따라 Update 명령을 적용할지, 아니면 로컬 파일을 다시 저장하여 충돌 상태를 유발한 다음 로컬 버전을 우선하도록 충돌을 해결하여 해당 변경 사항을 무시할지 결정할 수 있습니다.
버전 관리 용어
| 용어 | 의미 |
|---|---|
| Base | 로컬 Working Copy(으)로 체크아웃한 저장소의 리비전입니다. 체크아웃된 리비전이라고도 합니다. |
Check-in |
파일의 작업 사본을 저장소에 저장하는 작업입니다. Altium Designer에서는 Commit(이)라고 합니다. |
Check-out |
VCS 저장소에서 파일 사본을 작업 폴더로 가져오는 작업입니다. 일반적으로 파일의 최신 리비전을 가져오지만, 이전의 모든 리비전도 체크아웃할 수 있습니다. VCS에 따라 파일을 단순 체크아웃 또는 독점 체크아웃(잠금) 상태로 표시할 수 있습니다. |
Clone |
원격 Git 저장소를 로컬 폴더의 작업용 Git 저장소로 복사(복제)하면서 HEAD(최신) 버전을 해당 폴더에 자동으로 체크아웃하는 Git 명령입니다. 로컬 저장소에는 원격 저장소(이 경우 |
Commit |
파일의 작업 사본을 저장소에 다시 저장하는 작업입니다. 일부 버전 관리 시스템에서는 Check-in(이)라고 합니다. Altium 설계 소프트웨어에서 일반적인 Save 명령은 편집한 파일을 작업 폴더에 저장하는 반면, Commit 명령은 해당 폴더의 파일을 새 리비전(버전)으로 저장소에 저장합니다. |
Conflict |
두 Altium Designer 사용자가 동일한 파일의 동일한 영역에 영향을 주는 변경 사항을 커밋하려고 할 때 발생하는 상황입니다. 병합 도구를 사용하거나 수동으로 해결하거나, 어떤 버전을 우선할지(새 리비전으로 만들지) 결정하여 해결해야 합니다. |
Database |
버전(또는 소스) 관리 대상인 모든 파일을 보관하는 중앙 저장 공간으로, 실무에서는 Repository (이)라고도 합니다. |
Git |
Git은 오픈 소스 버전 관리 시스템입니다. Altium Designer에는 VCS Provider - Git 확장 기능을 통해 Git 기능이 통합되어 있어, Storage Manager 및 Projects 패널에서 리비전을 직접 추적하고 액세스할 수 있습니다. |
Head |
버전 관리 시스템에 커밋된 최신 리비전입니다. |
Log message |
리비전을 저장소에 다시 체크인(커밋)할 때 해당 리비전의 변경 사항에 대해 남기는 설명입니다. 로그 메시지는 파일의 변경 진행 상황을 요약하는 데 사용할 수 있습니다. |
Project |
많은 버전 관리 시스템이 프로젝트 개념을 지원합니다. VCS 프로젝트는 한 번에 체크인/체크아웃할 수 있는 관련 파일 모음입니다. VCS는 프로젝트의 모든 파일에 버전 번호를 설정하는 등 다른 프로젝트 관련 기능도 지원할 수 있습니다. 이는 Add Project Folder to Version Control 명령을 사용하여 버전 관리에 추가할 수 있는 Altium Designer 프로젝트의 개념과는 다릅니다. |
Push |
로컬 작업 저장소의 파일로 원격 Git 저장소를 업데이트하는 작업으로, 로컬 저장소와 원격 저장소를 동기화합니다. 이 명령은 로컬 Git 저장소의 파일이 원격 Git 저장소의 해당 파일보다 최신일 때 사용할 수 있습니다. 개념적으로 Git Pull 명령과 상호 보완 관계에 있습니다. |
Repository |
버전(또는 소스) 관리 대상인 모든 파일을 보관하는 중앙 저장 공간으로, Database(이)라고도 합니다. |
Revision |
파일 또는 파일 모음의 이력에 커밋된 변경 사항입니다. VCS가 보관 중인 파일의 서로 다른 판본(버전)을 추적하기 위해 제공하는 영숫자 참조입니다. |
Sandbox |
작업할 수 있도록 저장소에서 파일을 체크아웃하는 대상 폴더로, Working Folder(이)라고도 합니다. Altium 설계 소프트웨어에서 체크아웃한 파일은 자동으로 불러옵니다. |
| SVN | Subversion은 오픈 소스 버전 관리 시스템입니다. Altium Designer에는 VCS Provider - SVN 확장 기능을 통해 SVN 기능이 통합되어 있어, Storage Manager 및 Projects 패널에서 리비전을 직접 추적하고 액세스할 수 있습니다. |
Update |
저장소에 있는 파일 버전의 변경 사항을 확인하여 작업 사본으로 '가져오는' 작업입니다(Commit 또는 Check-in와 상호 보완 관계). 차이점을 병합하려면 병합 도구를 사용하거나 수동으로 업데이트해야 합니다. |
VCS |
버전 관리 시스템(Version Control System): 파일 버전 이력 관리와 파일 검색 및 가져오기가 가능한 모든 도구를 가리키는 일반적인 용어입니다. |
Version |
버전이라는 용어는 일반적으로 관리 대상 파일 또는 그 출력물(예: 소스 코드의 경우)에 사람이 부여한 외부 참조 번호를 의미합니다. 대부분의 경우 리비전으로 간주됩니다. |
Working Copy |
변경 작업을 수행하는 파일의 '로컬' 사본으로, 일반적으로 Working Folder에 있습니다. |
Working Folder |
작업할 수 있도록 저장소에서 파일을 체크아웃하는 대상 폴더입니다. Git에서는 로컬 작업 저장소에 해당합니다. Altium Designer에서 체크아웃한 파일은 자동으로 불러옵니다. |
참고 자료
- SVN 웹사이트: http://subversion.apache.org/
- SVN 온라인 매뉴얼: http://svnbook.red-bean.com/
- SharpSVN 프로젝트 홈페이지: https://sharpsvn.open.collab.net
- Git 웹사이트: https://git-scm.com/
- Git 온라인 문서: https://git-scm.com/doc
- Tortoise 클라이언트: http://tortoisesvn.net 및 https://tortoisegit.org/
- Eric Sink의 소스 관리 방법 안내: http://www.ericsink.com/scm/source_control.html






