Plastic SCM - CLI 가이드

Plastic SCM은 시각적 버전 관리 시스템입니다. 그러나 명령줄에서도 사용이 가능합니다.

이 가이드는 사용자가 Plastic에 익숙해질 수 있도록 일반적인 명령줄 인터페이스(CLI) 시나리오를 단계별로 안내합니다.

새 워크스페이스를 생성하려면 cm workspace create 명령만 실행하면 됩니다.

그런 다음 새로 생성된 디렉토리로 이동합니다.

업데이트를 실행하지 않았기 때문에 체인지 세트는 아직 0입니다. 기본적으로 워크스페이스는 주 브랜치를 사용하도록 구성되어 있습니다.

cm status --head를 실행하여 브랜치의 최신 체인지 세트를 확인할 수 있습니다.

다음을 입력하여 최신으로 업데이트할 수 있습니다.

그러면 이 명령은 최신 상태가 될 때까지 복제 중인 파일에 대한 모든 정보를 덤프합니다.

이제 최신 체인지 세트가 573이 되었습니다.

새 브랜치를 생성하려면 간단히 cm branch(또는 cm branch create) 명령을 실행하면 됩니다.

cm status에서 확인할 수 있듯이, 새 브랜치를 생성했지만 아직 새 브랜치로 전환하지는 않은 상태입니다.

시작점을 지정하지 않았으므로 새 브랜치는 부모 브랜치의 최근 체인지 세트에서 시작하며, 이 경우 주의 체인지 세트 573입니다. --changeset 및 --label 조정값을 사용하여 주어진 체인지 세트 또는 레이블을 지정하고, 해당 위치에서 브랜치를 시작할 수 있습니다.

이제 switch 명령을 사용하여 워크스페이스를 브랜치로 전환합니다.

새 브랜치는 아직 비어 있으므로 Plastic은 사실 전환을 수행하기 위해 워크스페이스에서 아무것도 업데이트하지 않았습니다. fix-1342 지점이 동일한 체인지 세트 573을 가리키기 때문입니다.

워크스페이스에서 파일을 편집한 후 변경사항을 검색하여 이 파일을 찾습니다.

status는 앞서 확인한 wk 구성뿐만 아니라 변경, 체크아웃, 이동, 삭제 등이 이루어진 파일도 보여 줍니다.

이제 FileSystem-renamed.cs를 새 위치로 이동합니다.

그리고 status를 실행하여 이동된 파일을 찾습니다.

로컬에서 이동됨은 Plastic의 관리 범위를 벗어난 위치로 파일이 이동했다는 의미입니다만, 이동된 파일은 이전 버전과 99% 유사하므로 찾을 수 있습니다.

그리고 쉽게 변경사항을 체크인할 수 있습니다.

기본 ci 명령은 추가된 모든 파일을 체크인합니다. 기본적으로 ci --all 명령을 사용하면 변경된 모든 사항을 감지하고 체크인을 수행하라고 Plastic에 전달합니다. 또한 all은 변경, 삭제 또는 이동이 이루어진 파일을 의미합니다. ci --all --private을 사용하여 비공개 파일을 포함할 수도 있습니다.

cm log 명령을 실행하면 지정된 체인지 세트 또는 특정 체인지 세트 범위에 적용된 변경사항이 표시됩니다.

FileSystem.cs 파일을 체크인, 수정 및 이동한 마지막 체인지 세트에서 해당 내용이 어떻게 보이는지 알 수 있습니다.

cm diff 명령은 비슷하지만 항상 지정된 체인지 세트로 제한됩니다.

실험적으로 몇 가지 변경을 시도해 본 후, 대기 중인 모든 변경사항을 제거하고 없애고 다시 처음부터 시작하고 싶습니다. 이런 방식으로 작업할 경우

먼저 현재 상태를 확인합니다.

모든 변경사항을 취소하려 합니다. undo 명령을 반복하여 이 작업을 처리합니다.

이제 상태는 다음과 같습니다.

모두 정리되었습니다.

참고:

변경된 파일 하나만 되돌리려면 어떻게 해야 할까요?

다음과 같이 여러 파일을 수정했습니다.

하지만 cg_main.c 파일에 대한 변경사항만 되돌리고자 합니다. 이때 다음 명령을 실행하면 됩니다.

이번에는 특정 경로에서 몇 가지 변경사항을 되돌려야 한다고 가정해 보겠습니다.

code 아래의 변경사항만 되돌리고 merge 아래의 변경사항은 그대로 두고자 합니다.

이제 예상대로 상태는 다음과 같습니다.

와일드카드를 사용하여 대상을 더 정확하게 좁힐 수 있습니다.

이번에는 code 아래의 헤더 파일을 되돌리고 소스 파일은 그대로 두고자 합니다.

이제 예상대로 상태는 다음과 같습니다.

주어진 경로의 특정 파일만 체크인한다고 가정해 보겠습니다. 다음과 같이 수정된 파일이 여러 개 있습니다.

하지만 q3radiant\alpha 내부에 있는 파일만 체크인하려 하므로 다음과 같이 checkin을 실행합니다.

Plastic SCM에서 파일은 변경되거나 체크아웃될 수 있습니다. 따라서 편집-체크인 또는 체크아웃-편집-체크인이라는 두 가지 워크플로를 따를 수 있습니다.

파일을 체크아웃한다는 것은 Plastic에 "파일을 수정하겠다"고 알려 Plastic이 내부적으로 파일을 체크아웃된 파일 목록에 추가하게 됨을 의미합니다.

체크아웃을 주로 사용하는 3가지 이유는 다음과 같습니다.

1. Perforce(p4 편집) 또는 ClearCase(체크아웃) 방식을 사용해 보았으므로 이러한 방식으로 작업하는 데 익숙합니다. 이렇게 작업하는 사용자는 워크스페이스의 모든 파일을 읽기 전용으로 설정해 일종의 보호 상태로 만들고, 체크아웃하지 않은 파일을 수정할 경우 파일 시스템에서 경고를 표시하게 하는 방식을 선호한다고 볼 수 있습니다.
   

2. 배타적 체크아웃(잠금)을 사용해야 하는 경우 파일을 편집하기 전에 체크아웃해야 합니다. 여기에서 잠금에 대해 읽어보십시오.
3. 큰 규모의 코드베이스(파일 50만 개 초과)로 작업하는 경우 모든 작업의 속도를 높이기 위해 체크아웃을 사용하는 것이 좋을 수 있습니다. cm status 명령을 통해 워크스페이스에서 변경사항을 찾습니다. 체크아웃을 사용하는 경우 status 명령은 체크아웃 목록에 있는 파일만 나열하므로 디스크 액세스는 필요하지 않습니다.

체크아웃-편집-체크인 방식의 작업은 매우 간단합니다. 파일을 편집하기 전에 cm co 명령을 실행하기만 하면 됩니다.

이제 Bmp.cpp가 변경됨이 아닌 체크아웃됨으로 표시된 것을 확인할 수 있습니다.

다음 예에서 볼 수 있듯이 cm mv 명령을 실행하여 이동한 파일은 다른 형태로 체크아웃된 것으로 간주됩니다.

aselib.c가 "로컬에서 이동된" 것이 아니라 그냥 이동된 것임을 알 수 있습니다.

다음과 같이 두 개의 체크아웃된 파일을 체크인할 수 있습니다.

checkin에 --all 조정값을 지정하지 않았으므로 체크아웃된 파일만 체크인되었으며 Socket.cs 파일은 여전히 변경 대기 상태입니다.

CLI에서 병합하는 것은 매우 쉽습니다. cm merge 명령만 실행하면 됩니다.

지금까지는 main/fix-1342 브랜치에서 모든 것을 변경했습니다. 이제 주 브랜치로 전환하여 변경사항을 병합합니다. 이 시점의 상황은 다음과 같습니다.

주 브랜치로 전환합니다.

Socket.cs를 누락했기 때문에 아직 전환할 수 없습니다. 먼저 변경사항을 취소한 뒤 다시 전환을 시도합니다.

switch명령은 워크스페이스를 업데이트하여 브랜치에서 변경한 모든 파일을 주 브랜치의 버전으로 교체합니다.

이제 상태는 다음과 같습니다.

상태는 브랜치 탐색기에도 반영됩니다.

이제 merge 명령을 실행합니다.

조정값 없이 병합하면 병합 대상의 프리뷰만 출력되므로 앞으로의 전개 상황을 이해하는 데 매우 유용합니다.

병합을 더 흥미로운 방향으로 진행하기 위해 FileSystem-renamed.cs(이동 후 브랜치에서 이름 변경됨)를 수정하려 합니다.

이제 병합을 다시 실행하고 코멘트를 추가합니다.

FileSystem-renamed.cs는 두 명의 기여자가 수정했으므로, 마지막 줄에서 볼 수 있듯이 이제 3단계 병합이 필요합니다.

이제, 실제 병합을 수행하기 위한 --merge 조정값과 파일 콘텐츠에서 새 체인지 세트의 코멘트를 설정하기 위한 --commentsfile 조정값을 merge 명령에 추가하여 병합을 실행합니다.

모든 병합이 워크스페이스에 적용되고 FileSystem.cs에서의 충돌을 해결하기 위해 구성했던 3단계 병합 툴(기본적으로 Plastic의 Xmerge)이 실행됩니다. FileSystem.cs가 어떻게 올바르게 이동하여 이름이 변경되었고 파일 콘텐츠가 올바르게 병합되었는지 확인하십시오.

이제, status 명령을 실행하면 병합된 모든 파일이 체크아웃됨 상태가 됩니다.

현재 사용 중인 새로운 상태가 교체됨이라는 것을 볼 수 있습니다. 따라서, 효율성을 위해 버전 관리에서 파일을 복사하지 않고 브랜치에 있는 원래 위치의 포인터가 저장된 다음, FileSystem.cs 파일은 병합이 완료됐기 때문에 실제 체크아웃됨으로 표시됩니다.

이 시점에서 브랜치 탐색기는 다음과 같이 표시됩니다.

파선은 병합이 여전히 진행 중이고 체크인되지 않았다는 것을 의미합니다.

이제 cm ci 명령을 사용하여 간단하게 체크인할 수 있습니다.

새롭게 병합된 코드에 레이블을 지정하려면 다음과 같이 cm label만 실행하면 됩니다.

브랜치 탐색기가 이제 다음과 같이 표시됩니다.

repository [list] 명령을 사용하면 주어진 서버의 리포지토리를 쉽게 나열할 수 있습니다.

기본적으로 repository는 구성 마법사에서 구성하고 client.conf에 기록되어 있는 서버인 기본 서버의 리포지토리를 보여 줍니다.

repository list 명령은 다른 유형의 서버도 입력할 수 있어 서버와 관련된 연결 문제를 진단하는 데에도 매우 유용하며, 그 방법은 다음과 같습니다.

Plastic SCM은 사용자의 기기에 저장되어 있는 워크스테이션의 목록을 보관합니다. 단 이는 최소한의 정보가 알려진 경우에 한하며, 사용자가 워크스페이스를 복사했으나 Plastic에는 알려지지 않은 경우에는 이 목록에 포함되지 않을 수 있습니다.

이 가이드에서는 CLI로 처리할 수 있는 모든 종류의 작업을 설명합니다. 사용 가능한 다른 명령을 찾으려면 cm showcommands를 실행하면 됩니다.

또한 모든 명령에서 cm <command> --usage 명령을 사용해 옵션에 대한 빌트인 기술 자료를 확인할 수 있고, cm <command> --help 명령을 사용하면 예제가 포함된 포괄적인 도움말을 확인할 수 있습니다.

CLI가 예상대로 동작하지 않는 경우 Plastic 지원 팀에 연락해야 할 수 있습니다. 문제 진단에 도움이 될 수 있도록, 다음과 같이 cm support 명령을 사용하여 유용한 진단 정보가 담긴 zip 파일을 생성하고 전송할 수 있습니다.

한 스크립트를 실행하여 로컬 이동 및 삭제를 비롯해 소스 파일의 내용을 다수 변경했습니다. status는 다음과 같이 표시됩니다.

파일이 이동되거나 삭제되었는데 이러한 변경사항을 소스 제어로 가져올 방법이 있을까요? 문제 없습니다. 다음과 같이 move 또는 remove 명령을 실행해 관리되는 변경사항을 만들면 됩니다.

몇 가지 실험적인 코드 변경 작업을 진행하고 있으며, 변경사항을 소스 제어에 저장하고 동료와 공유하고 싶지만 그냥 시도 중인 아이디어일 뿐이므로 브랜치에는 체크인하지 않으려 합니다.

이러한 상황에서는 shelveset 명령을 사용하여 사실상 어떤 브랜치와도 연결되지 않은 체인지 세트를 커밋합니다.

리포지토리에 로컬 변경사항을 임시 저장했습니다. 이 브랜치를 다른 워크스페이스로 전환하고 평소와 같이 계속 작업합니다. 나중에 이렇게 실험적으로 작업 중이던 변경사항으로 되돌리고 싶을 수 있습니다. 변경사항을 되돌리려면 apply 하위 명령을 사용하여 워크스페이스에 임시 저장 세트를 적용하면 됩니다.

Plastic CLI에서 자주 간과되곤 하는 기능 중 하나로, - 옵션을 다음과 같이 사용하면 표준 입력에서 인수를 하나씩 읽을 수 있습니다.

이 기능이 유용한 이유는 다른 명령의 출력을 cm으로 파이핑할 수 있기 때문입니다.

다음 명령은 파이핑된 경로를 허용합니다.

• add
• applylocalchanges
• checkin
• checkout
• getstatus
• partialcheckin
• remove
• shelveset create
• undocheckout
• undochange
• uncounchanged
• wktreenodestatus

예를 살펴보겠습니다.

• Windows dir 명령을 사용하여 워크스페이스에서 패턴과 일치하는 모든 파일을 쉽게 제거할 수 있습니다. >dir /S /B *.txt | cm rm - Item c:\Users\pablo\wkspaces\mcga\a.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\b.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\c.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\z.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\lockwkB\file.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\src_dir\dest_dir\a.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\src_dir\dest_dir\b.txt has been removed. Item c:\Users\pablo\wkspaces\mcga\src_dir\dest_dir\c.txt has been removed.
• checkout 명령을 사용해 파이핑된 디렉터리 인수를 재귀적으로 사용할 수 있습니다. Directory of c:/mcga/pipe 11/05/2020 19:48 <DIR> . 11/05/2020 19:48 <DIR> .. 11/05/2020 17:57 <DIR> dir 11/05/2020 19:46 <DIR> dir2 11/05/2020 19:47 12 dirlist 1 File(s) 12 bytes 4 Dir(s) 23,714,631,680 bytes free c:/mcga/pipe>type dirlist dir dir2 c:/mcga/pipe>type dirlist | cm partial co -r - The selected items are about to be checked out. Please wait ... Item c:/mcga/pipe/dir was correctly checked out Item c:/mcga/pipe/dir/file was correctly checked out Item c:/mcga/pipe/dir2 was correctly checked out Item c:/mcga/pipe/dir2/file2 was correctly checked out

이제 파이프와 cm을 함께 사용하여 뛰어난 스크립트를 작성할 수 있습니다.

2020년 6월 10일

2020년 6월 8일

2020년 1월 21일

2019년 5월 16일

2019년 3월 26일

2019년 5월 14일

2019년 3월 22일

2019년 3월 21일

2019년 3월 13일

2019년 2월 8일

2018년 9월 4일

2018년 2월 26일

2015년 8월 24일