SCMLoop - 외부 저장소 연결
이 문서에서는 Codebeamer SCMLoop 구성 요소를 설치하는 방법에 대해 설명합니다. Codebeamer에서는 관리되는 저장소에 대한 지원을 기본적으로 제공합니다. 관리되는 저장소는 Codebeamer에서 직접 작성 및 유지 관리하는 SCM 저장소이므로, 이 문서를 읽을 필요가 없습니다.
SCMLoop는 알림 메커니즘으로, Codebeamer의 작업 항목과 SCM(소스 코드 관리) 저장소에 커밋을 연관시킬 수 있습니다.
현재 SCMLoop는 다음 SCM 시스템에 사용할 수 있습니다.
• Git(Linux/Unix만 해당)
• Subversion
• Mercurial(Hg)
• Perforce
관리되는 저장소(Git, Mercurial 및 Subversion)의 고유한 특징은 저장소를 작성 및 관리하기(액세스 제어 포함) 위해 Codebeamer와 원활하게 통합된다는 점입니다.
(외부) Subversion, Git, Mercurial을 예를 들어 SCM 변경 집합(커밋)을 Codebeamer 작업 항목에 연관시키기 위해 Codebeamer 서버에서 실행 중이 아닌 Codebeamer에 연결하려는 경우에만 이미 있는 추가 SCMLoop 구성 요소를 수동으로 설정해야 합니다.
SCMLoop 설치
연결할 SCM 저장소를 호스팅하는 모든 서버에 SCMLoop 구성 요소를 설치해야 합니다.
CB/tomcat/webapps/cb/scmloop.zip의 SCMLoop 배포 아카이브를 공개적으로 액세스 가능한 디렉터리/폴더로 압축을 풉니다. SCM 저장소를 호스팅하는 각 서버 또는 각 SCM 호스트에서 액세스할 수 있는 네트워크 폴더에 있습니다.
JRE 버전은 SCMLoop 배포의 원래 Codebeamer 버전과 동일합니다.
SCMLoop가 작동하려면 구성을 현재 환경에 맞게 조정해야 합니다.
Windows 시스템에서는 스크립트 scmloop/scmloop.bat를, Unix 시스템에서 scmloop/scmloop를 편집하고 다음 변수의 값을 수정해야 합니다.
변수 | 설명 |
SCM_DIR | scmloop[ .bat] 스크립트 자체에 대한 경로입니다. |
CB_BASE_URL | Codebeamer 웹 응용 프로그램의 기본 URL입니다. 예: http://localhost:8080/cb. |
JAVA | 사용할 JRE의 java 실행 파일을 가리킵니다. |
SCM_TOKEN | Codebeamer 릴리스 2.0.0.1 이후 Codebeamer SCM 저장소에 대한 무단 호출을 방지하기 위해 SCMLoop 토큰이 도입되었습니다. 토큰을 찾을 수 있음 • 응용 프로그램 구성의 "scc" 노드에서: "scc" : { "scmLoop" : { "token" : "CB-ENCRYPTED-**-**-**" } 응용 프로그램 구성에서 토큰이 자동으로 생성되고 암호화됩니다. 토큰을 삭제하고 저장을 클릭하면 토큰이 자동으로 재생성됩니다. 암호가 해독된 새 토큰을 추가하고 저장을 클릭하면 Codebeamer에서는 새 토큰을 저장하고 자동으로 암호화합니다. • 암호가 해독된 토큰이 저장되는 로컬에 설치된 Codebeamer 인스턴스의 CB/repository/scmloop/scmloop 파일에서 | 응용 프로그램 구성에서 SCMLoop 토큰이 변경된 경우 변경 내용도 CB/repository/scmloop/scmloop 파일에 저장됩니다. 그러나 로컬 scmloop 파일에서 토큰을 수정하더라도 응용 프로그램 구성에서는 토큰이 업데이트되지는 않습니다. SCMLoop 토큰은 응용 프로그램 구성 및 로컬 scmloop 파일에서 일치해야 합니다. Codebeamer에서는 적절한 SCMLoop 토큰 없이 호출이 푸시된 경우 오류 메시지를 표시합니다. |
내부 저장소만 사용되는 경우 사용자가 토큰을 관리할 필요가 없습니다. Codebeamer는 처음 설치하는 동안 자동으로 토큰을 생성하고 SCMLoop 스크립트를 자동으로 편집합니다. 토큰 생성 및 SCMLoop 스크립트 편집은 Codebeamer를 업그레이드할 때도 수행됩니다. 외부 SCMLoop 설치를 사용하는 경우 다음 작업을 수행합니다. 1. application_configuration에서 토큰을 한 번 이상 덮어써야 합니다. 2. 암호화되지 않은 형태의 토큰을 저장합니다. 3. 외부 SCMLoop 설치의 셸 스크립트에서 SCM_LOOP 환경 변수를 암호화되지 않은 형태의 토큰으로 설정합니다. Codebeamer를 업그레이드할 때 이전 클라이언트가 토큰을 보낼 수 없으므로 기존 외부 SCMLoop 설치를 업데이트해야 합니다. |
모든 SCM 사용자가 scmloop[ .bat] 스크립트에 액세스하여 실행할 수 있는지 확인합니다. Linux/Unix 시스템에서는 scmloop 스크립트를 실행 가능한지 확인해야 합니다(예: chmod 명령 사용).
SCMLoop를 성공적으로 설치하고 구성하면 이제 SCM 저장소의 계측을 시작할 수 있습니다.
Mercurial 설치
Mercurial 1.8 이상을 설치하고(
http://mercurial.selenic.com/wiki/Download
)
hg를
PATH에 추가합니다. Windows에서는
setx PATH %PATH%;MERCURIAL_HOME을 사용합니다.
Linux에서는 export PATH=$PATH:MERCURIAL_HOME을 사용합니다. 여기서 MERCURIAL_HOME은 Mercurial을 설치한 디렉터리입니다.