bfexport 참조

bfexport 명령을 사용하여 이름 지정된 XML 파일로 프로젝트 데이터를 내보내거나 표시 터미널(stdout)로 보려는 프로젝트 데이터를 보냅니다. 내보내기 파일에는 단일 프로젝트 또는 프로젝트 스냅샷의 프로젝트 구성 데이터가 포함됩니다.

구문

bfexport

bfexport [-l]
bfexport [-l] <project_name>
bfexport [-c "<comment>"] [-f <file_name>] [-g] [-s] [-C] [-L ] [-n ] 
<project_name> | <project_name> <snapshot_name> | <project_id>

사용법

공통 프로젝트 내보내기 태스크를 완료하려면 다음 명령 옵션을 사용하십시오.
  • 명령 구문을 표시하려면 옵션 없이 bfexport를 사용하십시오.
  • Build Forge 데이터베이스에 저장된 프로젝트 이름과 프로젝트 ID를 나열하려면 bfexport -l을 사용하십시오.

    스냅샷 이름이 명령 출력의 프로젝트 이름에 추가됩니다(<project_ID>: <project_name> – <snapshot_name>).

  • 프로젝트 데이터를 XML 파일로 전송하려면, bfexport -f <file_name>을 사용하십시오. 프로젝트 데이터를 가져오는 데 사용할 수 있는 파일을 생성하려면 -f <file_name> 옵션을 지정해야 합니다.
  • z/Linux 플랫폼에서는 명령을 bfexport.pl로서 실행해야 합니다. 다른 모든 플랫폼의 경우 명령에 확장자가 필요하지 않습니다.

전제조건 및 제한사항

Build Forge 설치 디렉토리에서 bfexport 유틸리티를 찾으십시오.

서버의 서버 권한 비밀번호는 내보내기 파일에 포함되지 않으므로 가져오기 후 UI에서 서버 권한 비밀번호를 수동으로 입력해야 합니다.

bfexport 명령은 buildforge.conf 파일을 찾고 Build Forge 데이터베이스에 액세스할 수 있어야 합니다. buildforge.conf가 있는 디렉토리에서 bfexport를 실행하십시오. <bfinstall>(Windows) 및 <bfinstall>/Platform(UNIX 및 Linux)에 있습니다.

예제:

출력을 파일에 쓰려면 -f <file_name> 옵션을 사용하십시오. 다음 예제에서는 helloworld가 출력 파일 이름이고 프로젝트 이름 대신 프로젝트 ID가 사용됩니다.

bfexport -c "Saving a copy of project before making changes" 
 -f helloworld 675B57CC-8366-11DD-B2E0-043C04E44E1A

기본 프로젝트 스냅샷만 내보내려면 <project_name>을 사용하십시오.

bfexport -f helloworld test_project

프로젝트의 스냅샷 하나를 내보내려면 <project_name> <snapshot_name>을 사용하십시오.

bfexport -f helloworld test_project snapshot_1

상위 프로젝트 스냅샷이 기본 프로젝트가 아닌 경우 <project_name> 다음에 상위 키워드를 지정하여 상위 프로젝트 스냅샷을 내보내야 합니다.

bfexport -f helloworld test_project parent

옵션 설명

옵션 설명
<project_name> 내보낼 프로젝트의 이름. 프로젝트 이름 또는 프로젝트 ID가 필요합니다. 프로젝트 이름에 공백이 포함되는 경우 이름을 따옴표로 묶어야 합니다.

프로젝트 이름은 명령 옵션 다음에 지정하십시오.

<snapshot_name> 내보낼 프로젝트 스냅샷의 이름. 다음 구문과 같이 프로젝트 이름이 필요합니다.
<project_name> <snapshot_name>

프로젝트 이름과 스냅샷 이름은 명령 옵션 다음에 지정하십시오. 프로젝트 또는 스냅샷 이름에 공백이 포함되는 경우 이름을 따옴표로 묶어야 합니다.

<project_id> 내보낼 프로젝트의 ID. 프로젝트 ID는 UUID입니다. 프로젝트 ID 또는 프로젝트 이름이 필요합니다.

프로젝트 ID는 명령 옵션 다음에 지정하십시오.

-f <file_name> bfexport 출력의 XML 파일 이름. 경로 이름을 제공하지 않으면 현재 작업 디렉토리가 사용됩니다. 파일 이름에 공백이 포함되는 경우 이름을 따옴표로 묶어야 합니다.

파일 이름을 제공하지 않으면 bfexport 출력을 stdout로 보냅니다.

참고: stdout는 보기용으로만 사용하십시오. stdout를 파일로 재지정하지 마십시오. 결과 파일에는 로깅 메시지가 포함되며 bfimport 명령 또는 UI 가져오기 유틸리티에 대한 가져오기 파일로 사용할 수 없습니다.
상위 상위가 기본 프로젝트 스냅샷이 아닌 경우 상위 프로젝트 스냅샷을 내보내는 데 필요한 키워드.

상위 키워드는 다음과 같이 프로젝트 스냅샷 이름 다음에 지정하십시오.

bfexport -f helloworld test_project parent
-l 데이터베이스의 프로젝트를 이름과 프로젝트 ID별로 나열합니다. -l 옵션은 다른 옵션과 함께 사용할 수 없습니다.
-c "<comment>" 주석을 포함합니다. 주석은 따옴표로 묶어야 합니다(예: "my project version 50"). 주석은 <buildforge> XML 요소에 추가됩니다.
-g 알림을 수신하도록 지정된 액세스 그룹의 구성원인 사용자를 XML 파일에 저장합니다. 사용자 및 해당 특성이 <user> XML 요소에 나열됩니다. -s가 필요합니다.
-s 관리 콘솔에서 정의된 서버를 XML 파일에 저장합니다. 서버 및 해당 특성이 연관된 <auth> 및 <collector> 정보와 함께 <server> XML 요소에 나열됩니다.
-L UI에서 정의된 LDAP 도메인 제어기를 XML 파일에 저장합니다. LDAP 도메인 제어기 및 해당 특성이 <ldap> XML 요소에 나열됩니다.
-n 프로젝트와 단계에 지정된 알림 템플리트를 XML 파일에 저장합니다. 알림 템플리트 및 해당 특성이 <mail-template> XML 요소에 나열됩니다.
-C 프로젝트의 서버에 지정된 콜렉터를 XML 파일에 저장합니다. 콜렉터 및 해당 특성이 <collector> XML 요소에 나열됩니다. -s가 필요합니다.

문제점 해결

보고서 파일 또는 라이브러리를 찾을 수 없다는 오류가 발생하는 경우 라이브러리 경로가 올바르게 설정되었는지 확인하십시오.

올바른 설정은 <bfinstall>/rc/buildforge입니다. 해당 파일에 라이브러리 경로 변수 및 기타 변수가 설정되었는지 확인하십시오. 필요에 따라 해당 변수를 재설정한 후 내보내십시오.


피드백