Skip to content

feat: ✨ Distribute scouterctl through npm, Scoop and Homebrew - #94

Draft
oxspan wants to merge 7 commits into
developfrom
feature/package-managers
Draft

oxspan wants to merge 7 commits into
developfrom
feature/package-managers

Conversation

@oxspan

@oxspan oxspan commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

변경 이유

ZIP을 직접 내려받는 방식에 더해 npm, Scoop, Homebrew로 설치하고 업데이트할 수 있게 합니다. Java 21 이상은 외부 런타임으로 유지하고, 각 설치 방식에서 설정을 보존합니다.

선행 PR: #93. 현재 브랜치는 해당 PR의 커밋을 기반으로 하며, 이 PR의 직접 변경은 패키지매니저 배포와 검증입니다.

주요 변경

  • npm에 JVM 의존성을 모두 포함해 설치 스크립트나 추가 다운로드 없이 설치합니다. Windows에는 ZIP과 같은 native 실행 파일을 넣어 한글·이모지 인자를 보존합니다.
  • 이 저장소에서 Scoop bucket과 Linux x64 Homebrew tap을 제공합니다. Java 의존성을 선언하고 공개된 ZIP의 체크섬을 사용합니다.
  • Windows에서 만든 동일한 npm 파일을 Windows와 Linux에서 검증한 뒤 릴리스에 사용합니다. 릴리스 후 Scoop·Homebrew 정의 갱신 PR을 만들고, npm은 관리자 설정 후 OIDC로 게시하도록 구성합니다.
  • Windows CI에서 Java가 없는 상태의 Scoop 자동 의존성 설치, 기본 junction, 1.0.0에서 후보 ZIP으로 업데이트, Unicode 설정과 삭제 후 보존을 검사합니다.

검증

  • 로컬 Linux 전체 테스트 325개 통과. LINE 94.97%, BRANCH 81.06%. 명령 ZIP과 npm 배포 파일 검증 통과.
  • 실제 Windows Gradle로 만든 npm 파일을 두 운영체제에서 설치·업데이트·다운그레이드·삭제했습니다. global/project 설치, Unicode 설정 쓰기, TCP fixture 인증, 비밀번호 입력 중 Ctrl-C 종료 코드 130을 확인했습니다.
  • Homebrew·Scoop의 Java 자동 설치와 실행, 업데이트·삭제 후 설정 보존을 확인했습니다.
  • npm 게시 dry-run, actionlint, PowerShell 구문 분석, Bash·Node 구문, checked JS 타입·lint·format 검사 통과.
  • 최종 CI 통과: Linux 전체 테스트 325개, Windows 전체 테스트 323개, 실패·오류·건너뜀 0. 로컬 공유 드라이브에서 실행하지 못한 심볼릭 링크 검사도 실제 Windows에서 통과했습니다.
  • Scoop의 자동 Java 설치, 기본 junction 생성, 공개 1.0.0 → 후보 1.1.0 업데이트, Unicode 설정과 삭제 후 보존을 실제 Windows에서 확인했습니다. Windows에서 만든 동일한 npm 파일의 Linux 설치 검사도 통과했습니다.
  • npm 실제 게시와 게시 후 registry 설치, 실제 Collector 연결은 이번 배포 검증에서 실행하지 않았습니다.

호환성과 주의점

지원 대상은 Linux x64와 Windows x64이며 Homebrew는 Linux x64만 지원합니다. npm은 Node.js 22 이상과 Java 21 이상이 필요합니다. Scoop과 Homebrew는 Java를 의존성으로 설치합니다. CLI 옵션·JSON·종료 코드·캡처 형식은 유지합니다.

npm 첫 게시, 패키지 소유권, trusted publisher 및 GitHub 배포 환경 설정은 별도 작업입니다. 관리자 활성화 전까지 npm 자동 게시는 꺼져 있습니다. Scoop·Homebrew 정의는 현재 공개된 1.1.0을 가리키며 새 릴리스 뒤 갱신 PR을 병합해야 버전이 바뀝니다.

@github-actions

github-actions Bot commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Linux CI: success · Commit c2eef2b

Test results (Linux)

Total Passed Failed Errors Skipped
325 325 0 0 0

Test coverage

Metric Covered / total Coverage Minimum Result
LINE 2471 / 2602 94.97% 90.00% PASS
BRANCH 1494 / 1843 81.06% 80.00% PASS

Includes the test JVM and CLI subprocesses. Excludes optional real-Collector smoke tests.

Workflow logs and report artifacts

Updated on each CI run. Windows checks, when required, are reported separately in the workflow.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant