이 문서는 JFrog Artifactory에서 Artifact Repository Browser를 이용하여 패키지를 배포하는 방법에 대한 가이드를 공유하기 위해 작성되었다.


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

COMMUNITY PRO PRO X ENTERPRISE X ENTERPRISE +

목차



개요

Artifact Repository Browser에서는 Artifacts 모듈에서 Deploy 버튼을 클릭하여 로컬 저장소에 아티팩트를 배포할 수 있습니다. 아티팩트는 개별 또는 여러 개를 한 번에 배포할 수 있습니다.


아티팩트 배포 시 유의사항

  • 100MB 이상 아티팩트 업로드 불가 (UI기준)
    • Artifactory UI에서는 100MB를 초과하는 아티팩트 배포를 지원하지 않으며, 이 경우 JFrog CLI 또는 패키지 매니저를 사용해야 합니다.
  • 아티팩트 이름 주의 사항
    • 다음 특수 문자는 오류를 유발할 수 있으므로 사용을 피해야 합니다: |, *, ?, "
    • & 문자는 이름의 일부로는 사용할 수 있으나, 경로 구분자(/)로는 사용할 수 없습니다.
    • / 앞에 공백이 있는 경우는 허용되지 않습니다.
  • 전체 저장소 배포 시 imort 기능 사용
    • 저장소 전체를 배포하려면 Administration > Artifactory > Import & Export > Repositories 메뉴에서 Import Repository 기능을 사용해야 합니다.
  • 패키지 형식과 다른 콘텐츠 업로드 주의
    • 각 패키지 타입의 저장소는 해당 형식에 최적화된 인덱싱 및 성능 최적화 로직을 가지고 있습니다.
      이미지나 일반 텍스트 파일 등 형식에 맞지 않는 콘텐츠는 성능 저하를 유발할 수 있으므로,
      Generic 저장소에 업로드하는 것이 권장됩니다.


단일 아티팩트 배포

배포 대화 상자의 필드에 값을 입력하고 배포를 클릭합니다.

  • Target Repository : 업로드할 아티팩트가 저장될 Artifactory의 특정 저장소를 지칭합니다.
  • Repository Layout : Artifactory에서 아티팩트를 저장하고 구성하는 방법을 결정하는 규칙입니다.
  • Target Path : 업로드할 아티팩트가 저장될 경로를 지정합니다.


레이아웃에 따라 배포

Deploy According to Layout 옵션을 선택하면 해당 레이아웃의 토큰에 맞는 입력 필드가 표시됩니다. 이 필드를 채워 넣으면 구성된 레이아웃에 따라 아티팩트를 배포할 수 있습니다.

Maven 레이아웃에 맞는 아티팩트를 배포할 때는 Deploy as Maven Artifact 옵션을 사용하면 GroupID, ArtifactID, Version 등 Maven 속성 입력 필드가 노출됩니다. 파일명 기반으로 자동 채워지며, 수정하면 Target Path에도 반영됩니다.


타겟 저장소에 POM이 없다면 내부 POM을 사용하거나 기본 POM을 생성하도록 설정할 수 있습니다. 직접 POM을 수정할 경우 유효성을 주의해야 합니다.


여러 파일 배포

여러 파일을 동시에 배포하려면, Deploy Type을 Multi로 설정한 후 나머지 필드를 입력하고 Deploy를 클릭하면 됩니다.


아티팩트 번들 배포

아티팩트 번들은 zip, tar, tar.gz, tgz 확장자의 아카이브로 구성된 여러 아티팩트를 묶은 형태입니다.
Artifactory에서 번들로 배포하면, 업로드 시 아카이브가 자동으로 압축 해제되어 대상 레포지토리에 배포됩니다.

1. Deploy 다이얼로그에서 배포할 아카이브 파일을 업로드합니다.

2. Deploy as Bundle Artifact 체크박스를 선택합니다.

3. Deploy를 클릭하면, 아카이브 내부 구조 그대로 레포지토리에 배포됩니다.


업로드 실패

업로드가 실패되는 가장 일반적인 이유는 다음과 같습니다.

  • 권한 부족

  • 대상 저장소의 includeexclude 패턴과 충돌

  • 대상 저장소의 스냅샷/릴리스 처리 정책과 충돌이 발생합니다.



참조