이 문서는 Artifactory에서 지원하는 두 가지 데이터 가져오기 및 내보내기의 가이드를 공유하기 위해 작성되었다.


도구명JFrog Artifactory
문서 작성 기준 버전7.84.14
지원 Edition

 

목차


저장소 가져오기 및 내보내기

  1. 저장소 내보내기 설정
     - Target Local Repository : 대상 Repository 선택
     - Export Path on Server : 서버의 내보내기 대상 디렉토리
     - Exclude Metadata : 메타데이터 제외 옵션
     - Create .m2 Compatible Export : 설정 시 Maven 2 저장소 메타데이터 및 체크섬 파일이 내보내기의 일부로 포함됨
     - Output Verbose Log : 선택하면 로그 수준을 "Debug"로 설정하고, 표준 로그의 출력을 가져오기-내보내기 로그로 리다이렉션
  2. 저장소 가져오기 설정
     - Target Local Repository : 대상 Repository 선택
     - Import Path on Server : 서버의 가져오기 소스 디렉토리
     - Exclude Metadata : 메타데이터 제외 옵션
     - Output Verbose Log : 선택하면 로그 수준을 "Debug"로 설정하고, 표준 로그의 출력을 가져오기-내보내기 로그로 리다이렉션

Docker 저장소에서 작업하려면 해당 저장소의 메타데이터가 그대로 있어야 합니다.
따라서 Docker 저장소에서 가져오거나 내보낼 때 Exclude Metadata가 미선택 상태이어야 합니다.

원격 저장소 캐시로 가져오기

로컬 환경에 이미 다운로드한 원격 저장소를 활용하고, 이를 로컬 저장소로 직접 가져올 수 있습니다.

예를 들어, 로컬 Maven 저장소 (일반적으로 ~/.m2 하위에 위치) 를 가져와서 Artifactory에 업로드하면 이미 다운로드한 모든 아티팩트를 서버에서 사용할 수 있게 됩니다.

가져오기 저장소 레이아웃

가져온 저장소는 Maven2 저장소 레이아웃을 사용하여 구성해야 합니다.

  1. 단일 저장소를 가져올 때, 가져오기 폴더 내의 파일 구조는 
    IMPORT_FOLDER/ZIP_FILE
|
|--LIB_DIR_1
  2. 모든 저장소를 가져올 때
    IMPORT_FOLDER/ZIP_FILE
|
|--REPOSITORY_NAME_DIR_1
| |
| |--LIB_DIR_1

모든 저장소를 가져올 때 아카이브에 있는 저장소를 나타내는 디렉토리 이름이 Artifactory에 있는 대상 저장소의 이름과 일치하는지 확인해야 합니다.

시스템 가져오기 및 내보내기

(정보) Artifactory는 시스템 가져오기를 수행할 때 모든 보안 엔터티 (사용자, 그룹, 권한 및 액세스 토큰)를 유지 관리합니다.
(정보) DB에 저장된 데이터만 마이그레이션되며, 아티팩트 자체는 마이그레이션되지 않습니다.

master.key 복사는 Artifactory에서 데이터베이스의 공유 데이터를 암호화 및 복호화하는 데 사용하는 AES 비밀키이므로 가져오기 프로세스에 필수적입니다.
master.key는 $JFROG_HOME/artifactory/var/etc/security/master.key에 있습니다.

(오류) Artifactory의 다른 버전 간의 Import & Export는 권장하지 않습니다.

다만, 6.x에서 내보낸 파일에서 7.x 설치 파일로 가져올 때는 내보낸 파일의 logback.xml을 7.x로 바꿔야 합니다.
그렇지 않으면, 가져오는 동안의 로깅이 중단됩니다.


  1. 시스템 데이터 내보내기 설정
     - Export Path on Server : 내보낸 파일의 대상 디렉토리
     - Exclude Content : 저장소 바이너리가 내보내기에서 제외되는 옵션
     - Exclude Metadata : Maven2를 제외한 메타데이터를 제외하는 옵션
     - Create .m2 Compatible Export : 설정 시 Maven2 저장소 메타데이터 및 체크섬 파일이 일부 포함되는 옵션
     - Create a Zip Archive : zip 아카이브를 생성하여 내보내는 옵션
     - Output Verbose Log : 선택하면 로그 수준을 "Debug"로 설정하고, 표준 로그의 출력을 가져오기-내보내기 로그로 리다이렉션
  2. 시스템 데이터 가져오기 설정
     - Import Zip or Path on Server : 가져올 소스 파일의 경로
     - Exclude Content : 바이너리와 메타데이터가 가져오기에서 제외됨
     - Exclude Metadata : Maven2를 제외한 메타데이터를 제외하는 옵션
     - Output Verbose Log : 선택하면 로그 수준을 "Debug"로 설정하고, 표준 로그의 출력을 가져오기-내보내기 로그로 리다이렉션

HA 클러스터의 시스템 가져오기 및 내보내기

클러스터 노드 동기화 확인 절차

  1. 소스 클러스터에서 시스템 내보내기 수행
  2. 타겟 클러스터에서 하나의 노드만 실행 상태로 유지하고, 나머지 노드는 정상 종료
  3. 실행 중인 하나의 노드 타켓 클러스터에 시스템 가져오기 수행
  4. 7.12.0 미만의 Artifactory 버전에서는 실행 중인 노드를 종료 후 재시작
  5. 추가 노드마다 다음 폴더 삭제
    $JFROG_HOME/artifactory/var/etc/access

$JFROG_HOME/artifactory/var/etc/security

$JFROG_HOME/artifactory/var/etc/artifactory/ui

$JFROG_HOME/artifactory/var/etc/artifactory/plugins
  6. 실행 중인 노드에서 추가 노드로 $JFROG_HOME/artifactory/var/etc/security/master.key를 복사
  7. 추가 노드 실행 시작
  8. 가져오기 완료 후, Distribution, Xray, Pipelines, Insight 서비스 재시작
  9. 모든 노드와 서비스가 온라인인지 확인 (다음 첨부된 링크의 문서 확인 right arrow JFrog 플랫폼 모니터링하기 (Topology))


참조