Atlassian Downloader (Portable)

다양한 액션 지원

이 도구는 다음과 같은 다양한 액션을 통해 Atlassian 제품 정보를 유연하게 처리할 수 있습니다:

• Download: 기본 액션으로, 모든 피드에서 사용 가능한 모든 파일을 다운로드합니다.
• ListURLs: 다운로드 가능한 URL 목록만 출력하고 실제 다운로드는 수행하지 않습니다.
• ListVersions: 피드에서 발견된 모든 버전 번호를 출력합니다.
• ShowRawJson: 가져온 피드 데이터를 원본 JSON 형태로 출력합니다.
• Plugin: 특정 Marketplace 플러그인의 모든 버전을 아카이브로 다운로드하며, –plugin-id 옵션이 필요합니다.

유연한 피드 설정

사용자는 –custom-feed 옵션을 통해 내장된 Atlassian 피드 대신 자신만의 피드 URI를 지정할 수 있습니다. 이 옵션은 여러 번 반복하여 여러 피드를 동시에 사용할 수 있도록 지원합니다.

고급 다운로드 옵션

불안정한 네트워크 환경이나 rate limiting을 고려하여 다음과 같은 고급 옵션을 제공합니다:

• –random-delay 및 –min-delay/–max-delay로 다운로드 간 지연 시간을 무작위화
• –random-user-agent로 실행 시마다 사용자 에이전트를 무작위 선택
• –max-retries 및 –delay-between-retries로 실패 시 재시도 횟수와 간격 조정
• –skip-file-check로 기존 파일과의 크기 비교를 생략하여 다운로드 속도 향상

다운로드·설치 방법

Atlassian Downloader(Portable)는 설치 없이 바로 사용할 수 있는 portable 버전으로 제공됩니다. 사용 방법은 다음과 같습니다:

1. 공식 GitHub 저장소의 Releases 페이지에서 최신 버전의 zip 파일을 다운로드합니다.
2. 다운로드한 zip 파일을 압축 해제하면 atlassian-downloader.exe 실행 파일을 확인할 수 있습니다.
3. 명령 프롬프트 또는 PowerShell을 열고 해당 디렉토리로 이동한 후, 실행 파일을 직접 실행합니다.
4. 예시: atlassian-downloader.exe --output-dir "C:Atlassian" 명령으로 C:Atlassian 폴더에 제품을 다운로드할 수 있습니다.

또한 Chocolatey 패키지 관리자를 통해 choco install atlassian-downloader 명령으로 설치할 수도 있습니다.

기본 사용법/명령어

Atlassian Downloader는 다양한 명령줄 옵션을 지원합니다. 주요 사용 예시는 다음과 같습니다:

전체 제품 다운로드 (기본 동작)

모든 Atlassian 제품의 최신 버전을 다운로드하려면 다음과 같이 실행합니다:

atlassian-downloader.exe --output-dir "D:Atlassian-Backup"

사용자 정의 피드로 특정 제품만 다운로드

예를 들어 Bamboo 제품만 다운로드하려면 커스텀 피드를 지정합니다:

atlassian-downloader.exe --output-dir "D:Atlassian-Backup" --custom-feed https://my.atlassian.com/download/feeds/current/bamboo.json

다운로드 URL 목록만 출력

실제 다운로드 없이 다운로드 대상 URL만 확인하려면 다음과 같이 실행합니다:

atlassian-downloader.exe --action ListURLs

특정 플러그인의 모든 버전 아카이브

Jira용 특정 플러그인의 모든 버전을 다운로드하려면 다음과 같이 실행합니다 (–plugin-id 필수):

atlassian-downloader.exe --action Plugin --plugin-id com.atlassian.jira.plugin.system.issuetabpanels

크론 작업으로 자동화 예시

리눅스 환경에서 매주 일요일 자정에 자동 실행하도록 크론 작업에 등록할 수 있습니다:

0 0 * * 0 /opt/epicmorg/atlassian-downloader/atlassian-downloader --output-dir "/mnt/nfs/atlassian"

지원 환경·시스템 요구사항

Atlassian Downloader는 다음과 같은 런타임 식별자(RID)를 지원하여 다양한 플랫폼에서 자체 포함(self-contained) 바이너리로 제공됩니다:

• Windows: win-x86, win-x64, win-arm64
• Linux: linux-x64, linux-musl-x64, linux-arm, linux-arm64, linux-bionic-x64
• macOS: osx-x64, osx-arm64

Windows에서는 코드 서명이 적용된 바이너리를 제공하지만, Linux 및 macOS에서는 서명 없이도 완전한 기능을 제공하는 바이너리를 생성합니다. 개발 또는 빌드를 위해서는 .NET 10.0 SDK와 Visual Studio 2022가 필요합니다.

최신 버전·업데이트

현재 버전은 2.0.0.9이며, 자세한 변경 사항은 저장소의 CHANGELOG.md 파일을 참조하십시오. 최신 릴리스 정보와 다운로드 통계는 GitHub 저장소의 Releases 섹션에서 확인할 수 있습니다.

제한 사항·확인 사항

다음 사항을 사용 시 참고하시기 바랍니다:

• SourceTree 제품은 Atlassian에서 공식 피드를 제공하지 않기 때문에, 해당 제품의 데이터는 커뮤니티 유지 미러(atlassian-json)에서 스크래핑한 정보를 기반으로 제공됩니다.
• 일부 Atlassian 제품(Clover, Crucible, FishEye 등)의 EAP(Early Access Program) 버전은 공식 피드에서 제공되지 않을 수 있습니다.
• 피드가 일시적으로 접근 불가능하거나 파싱 오류가 발생한 경우, 해당 피드는 건너뛰고 나머지 피드 처리를 계속합니다. 오류 내용은 로그에 기록됩니다.
• Windows가 아닌 플랫폼에서 릴리스 빌드를 생성할 경우, 코드 서명 단계가 자동으로 건너뛰어 서명되지 않은 바이너리가 생성됩니다.