콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Aggrega 설치

Aggrega에는 두 가지가 필요합니다. 설치된 aggrega 바이너리, 그리고 AI 어시스턴트로 작성하려면 바이너리에 포함된 MCP 서버에 연결된 어시스턴트의 클라이언트입니다. 명령을 먼저 보여 주고, 각 명령이 하는 일과 다른 설치 방법은 그 뒤에 설명합니다.

바이너리 설치

Linux와 macOS에서는 터미널에서 다음을 실행합니다:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

Windows에서는 PowerShell에서 다음을 실행합니다:

Terminal window
irm https://aggrega.ai/install.ps1 | iex

Homebrew로, macOS와 Linux에서:

Terminal window
brew install aggrega-ai/tap/aggrega

Scoop으로, Windows에서:

Terminal window
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket
scoop install aggrega

winget으로, Windows에서:

Terminal window
winget install Cognitio.Aggrega

그런 다음 실행되는지 확인합니다:

Terminal window
aggrega version

버전 문자열이 출력되면 바이너리를 찾을 수 있고 실행할 수 있다는 뜻입니다. MCP 서버에 필요한 것은 그것이 전부입니다. 설치 방법별 상세 설명에서는 각 명령이 하는 일, 바이너리를 두는 위치, Windows 설치 프로그램이나 수동으로 설치하는 방법을 설명합니다.

MCP 클라이언트 연결

AI 어시스턴트의 클라이언트는 aggrega mcp를 실행하여 Aggrega의 MCP 서버를 시작하며, 서버를 추가하는 명령이나 항목은 MCP 서버 연결에 클라이언트별로 나와 있습니다. 플러그인을 설치하는 어시스턴트에서는 Aggrega 플러그인이 서버와 Aggrega 스킬을 한 단계로 추가합니다. 플러그인 설치를 참조하십시오.

설치 방법별 상세 설명

Aggrega는 단일 실행 파일로 배포됩니다. 명령 하나로 설치할 수 있으며, 그 뒤에 나오는 수동 단계로도 같은 작업을 직접 할 수 있습니다. 두 방법 모두 매번 같은 사용자 소유 폴더 하나에 설치하며, 어느 쪽도 관리자 권한이 필요하지 않습니다. Linux와 macOS에서는 ~/.local/bin/aggrega, Windows에서는 %LOCALAPPDATA%\Programs\aggrega\aggrega.exe입니다. Windows에서는 Windows 설치 프로그램과 winget도 같은 폴더에, 역시 관리자 권한 없이 설치하며, 설치된 앱 목록에 등록합니다. Windows 설치 프로그램으로 설치와 winget으로 설치를 참조하십시오. macOS와 Linux의 Homebrew, Windows의 Scoop으로도 설치할 수 있으며, 각각 자체 폴더에 설치합니다. 패키지 관리자로 설치를 참조하십시오.

명령 하나로 설치

설치 명령은 Linux와 macOS에서는 curl -fsSL https://aggrega.ai/install.sh | sh, Windows의 PowerShell에서는 irm https://aggrega.ai/install.ps1 | iex로, 바이너리 설치의 처음 두 명령입니다. 이 두 주소는 최신 릴리스에 첨부된 설치 스크립트로 리디렉션되므로, 같은 명령을 릴리스 자체의 주소로도 실행할 수 있습니다:

Terminal window
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | sh
Terminal window
irm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iex

이 명령이 하는 일:

  • 최신 릴리스에서 컴퓨터에 맞는 기본 바이너리를 고릅니다. 대상은 64비트 x86 또는 64비트 ARM의 Linux와 macOS, 64비트 x86의 Windows입니다. 그 밖의 시스템이나 프로세서에서는 무엇을 발견했는지 또는 대신 무엇을 이용해야 하는지 알려 주는 메시지와 함께 거부합니다. Apple silicon Mac에서는 Rosetta 2를 통해 실행되는 셸에서도 Apple silicon 바이너리를 고릅니다.
  • 릴리스의 SHA256SUMS로 바이너리를 검사합니다. 이 검사는 무엇이든 설치하기 전에 이루어집니다. 다운로드한 파일의 SHA-256 다이제스트가 목록의 값과 다르면 파일은 삭제되고, 아무것도 설치되지 않으며, 명령은 두 다이제스트를 모두 밝히는 메시지와 함께 중단됩니다.
  • 바이너리를 현재 사용자 전용으로 설치합니다. Linux와 macOS에서는 ~/.local/bin/aggrega로, Windows에서는 %LOCALAPPDATA%\Programs\aggrega\aggrega.exe로 설치하며, 폴더가 없으면 만들고 그곳에 있던 이전 사본을 한 번에 교체합니다. 따라서 명령을 다시 실행하면 가지고 있는 사본이 업데이트됩니다. sudo는 절대 사용하지 않습니다. Windows에서는 수동 단계의 Unblock-File처럼, 인터넷에서 다운로드한 파일에 붙을 수 있는 표시도 제거합니다. macOS에서는 curl로 다운로드하므로 설치되는 바이너리에는 격리 표시가 없습니다(macOS용 사전 빌드된 바이너리 참조).
  • 명령을 실행할 수 있게 만듭니다. Linux와 macOS에서는 폴더가 PATH에 없으면, 셸이 시작할 때 읽는 파일에 폴더를 추가하는 명령을 출력합니다. zsh는 ~/.zshrc, bash는 ~/.bashrc(macOS에서는 ~/.bash_profile), fish는 ~/.config/fish/config.fish(fish_add_path 줄 사용), 그 밖의 셸은 ~/.profile입니다. 그 명령을 직접 실행하지는 않으므로, 명령을 실행하고 새 터미널을 여십시오. Windows에서는 폴더가 사용자 PATH에 없으면 추가하고, 명령이 실행 중인 PowerShell 창의 PATH에도 추가하므로, 그 창과 이후에 여는 모든 터미널에서 aggrega가 실행되며, 폴더를 추가했다고 알려 줍니다.
  • 설치된 바이너리가 실행되는지 확인하며, 실행되지 않으면 다른 것을 설정하기 전에 메시지와 함께 멈춥니다. PATH에서 설치한 것보다 앞에 다른 aggrega가 있으면 그에 대한 참고를 덧붙입니다.
  • 설치된 버전을 출력하며, 설치한 바이너리를 전체 경로로 실행하므로 PATH가 그 폴더를 포함하기 전에도 버전이 표시됩니다.
  • 마지막으로 다음 단계를 보여 주며, Next: 아래에 한 줄씩 표시됩니다. 시작하기에서 설명하는, AI 빠른 시작을 실행하는 명령, 설치하면서 어시스턴트 스킬 추가하기에서 설명하는, 머신의 AI 어시스턴트에 Aggrega 스킬을 추가하는 aggrega skills install --global, 그리고 셸 자동 완성과 위의 MCP 클라이언트 연결을 위한 이 페이지의 주소입니다. 옵션으로 스킬이 이미 설치된 경우 해당 줄은 생략됩니다.

출력되는 내용은 짧습니다. 버전과 설치 대상 시스템, 다운로드가 체크섬과 일치하면 표시되는 한 줄, 그리고 설치한 경로입니다. 시작하기에서 전체 실행 예를 볼 수 있습니다. --verbose를 아래 옵션들처럼 sh -s -- 뒤에 지정하면 체크섬 목록의 주소, 릴리스 파일의 이름, 그 파일을 다운로드하는 주소도 출력합니다. install.ps1에는 같은 스위치가 -Verbose로 있으며, 인수를 붙여 스크립트를 실행할 때 사용하는데, irm … | iex로는 스크립트에 인수를 줄 수 없습니다. 명령이 거부하거나 단계가 실패하면 그 사실을 한 줄로 알려 주며, install.sh에서는 표준 오류로, install.ps1에서는 PowerShell이 표시하는 오류나 경고로 나타납니다:

aggrega install: error: <what went wrong> - <what to do>

Linux 및 macOS 스크립트인 install.sh에는 curl 또는 wget, uname, 그리고 sha256sum 또는 shasum이 필요합니다. Windows 스크립트인 install.ps1은 Windows PowerShell 5.1과 PowerShell 7에서 실행됩니다.

설치 내용을 바꾸는 설정이 두 가지 있으며, 각각 스크립트가 실행되는 환경에서 읽습니다:

  • **AGGREGA_VERSION**은 설치할 릴리스를 지정합니다. 예를 들어 0.8.7처럼 쓰며, 앞의 v는 붙여도 되고 붙이지 않아도 됩니다. 설정하지 않으면 명령은 최신 릴리스, 즉 GitHub가 latest로 표시한 릴리스를 설치합니다. 이 릴리스는 결코 사전 릴리스가 아니므로, 사전 릴리스는 여기에서 지정할 때만 설치됩니다.
  • **AGGREGA_INSTALL_DIR**은 기본 폴더 대신 설치할 폴더를 지정합니다. 그곳의 바이너리 이름은 aggrega(Windows에서는 aggrega.exe)이며, 명령은 위와 같이 그 폴더를 실행 가능한 위치로 만듭니다.

Linux와 macOS에서는 스크립트가 설정을 받을 수 있도록 설정을 curl 앞이 아니라 sh 앞에 둡니다:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> sh

PowerShell에서는 먼저 창에서 설정합니다. 이 설정은 Remove-Item Env:AGGREGA_VERSION으로 제거할 때까지 그 창에 유지됩니다:

Terminal window
$env:AGGREGA_VERSION = "<version>"
irm https://aggrega.ai/install.ps1 | iex

설치하면서 셸 자동 완성 설정하기

--completion을 지정하면 install.sh는 셸 자동 완성도 설정하여 Tab 키로 aggrega 명령과 플래그를 완성할 수 있게 합니다. 옵션은 sh -s -- 뒤에 두며, 이는 sh가 파이프에서 읽는 스크립트에 옵션을 넘깁니다:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion

irm … | iex는 스크립트에 옵션을 전달하지 않습니다. PowerShell에서는 설치가 끝난 뒤, 셸 자동 완성에서 설명하는 대로 aggrega completion powershell이 작성하는 스크립트로 자동 완성을 설정합니다. install.ps1도 인수를 붙여 스크립트를 실행할 때 -Completion을 받습니다.

자동 완성은 관리자 권한 없이 해당 사용자에게만, SHELL 설정이 가리키는 셸에 대해, PowerShell에서는 실행 중인 PowerShell에 대해 설정됩니다. 설치된 바이너리 자체의 aggrega completion이 생성하는 스크립트를 사용하며, 쓰거나 변경하는 모든 파일의 이름을 알려 줍니다:

  • bash: 스크립트를 ~/.local/share/bash-completion/completions에 씁니다. 이 폴더는 bash-completion 패키지가 사용자 자신의 자동 완성을 읽는 곳입니다. aggrega의 Bash 자동 완성에는 이 패키지가 필요합니다.
  • zsh: _aggrega를 ~/.local/share/zsh/site-functions에 쓰고, ~/.zshrc에 세 줄을 추가합니다. 이 줄들은 그 폴더를 zsh의 함수 경로에 넣고 불러오며, 파일에서 앞서 실행한 곳이 없으면 compinit를 실행합니다.
  • fish: aggrega.fish를 ~/.config/fish/completions에 씁니다. fish는 이 폴더를 자동으로 읽습니다.
  • PowerShell: 스크립트를 %LOCALAPPDATA%\aggrega\completion.ps1로 쓰고, 이를 불러오는 두 줄을 실행 중인 PowerShell의 모든 호스트용 프로필인 $PROFILE.CurrentUserAllHosts에 추가합니다. Windows PowerShell과 PowerShell 7은 프로필을 따로 두므로, 사용하는 각각에서 실행하십시오. 프로필은 새 창에 적용되는 실행 정책이 RemoteSigned, Unrestricted, Bypass 중 하나일 때만 실행됩니다. Restricted 같은 다른 정책에서는 아무것도 쓰지 않고 어떤 정책을 발견했는지 알려 줍니다. 정책을 변경하는 일은 없습니다.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR, ZDOTDIR는 각 셸이 읽는 방식대로 이 폴더와 파일의 위치를 바꿉니다. 새 터미널이나 창에서 자동 완성이 로드됩니다. 명령을 다시 실행하면 설치된 aggrega가 다른 스크립트를 생성할 때만 스크립트를 다시 쓰고, ~/.zshrc나 프로필에는 줄을 한 번만 추가합니다. 명령이 그 과정에서 바이너리를 다시 설치하므로, 이미 있는 설치에 자동 완성을 추가하는 방법도 이와 같습니다.

설치하면서 어시스턴트 스킬 추가

--skills(PowerShell에서는 -Skills)를 지정하면 설치 명령은 컴퓨터에 있는 AI 어시스턴트를 위해 모든 프로젝트에 Aggrega 스킬, 즉 AI 어시스턴트에게 Aggrega를 설치하고 사용하는 방법을 가르치는 지침도 설치합니다. 두 옵션을 함께 지정할 수 있습니다:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skills

irm … | iex가 옵션을 전달하지 않는 PowerShell에서는 설치가 끝난 뒤 aggrega skills install --global을 실행합니다. 이것이 -Skills가 실행하는 명령입니다.

설치된 바이너리 자체의 aggrega skills install --global을 실행합니다. 이 명령은 컴퓨터에 있는 어시스턴트, 즉 구성 폴더가 홈 디렉터리에 있거나 명령이 PATH에 있는 각 어시스턴트를 찾고, 찾은 각 어시스턴트와 무엇으로 찾았는지를 출력합니다. 그런 다음:

  • 터미널에서는 먼저 묻습니다. Enter 키를 누르면 찾은 어시스턴트에 스킬을 설치하고, 다른 어시스턴트를 추가하려면 공백이나 쉼표로 구분하여 식별자를 입력합니다. aggrega skills list가 식별자를 출력합니다. curl … | sh에서는 스크립트가 파이프에서 자신을 읽으므로 대신 터미널을 통해 묻습니다.
  • 물어볼 터미널이 없으면, 예를 들어 스크립트에서는, 찾은 어시스턴트에 설치합니다.
  • 어시스턴트를 직접 선택하려면 옵션 뒤에 쉼표로 구분하여 지정합니다: --skills claude-code,cursor 또는 --skills=claude-code,cursor, PowerShell에서는 -Skills claude-code,cursor. 그러면 지정한 어시스턴트에 설치하고 다른 어시스턴트는 찾지 않습니다.

작성한 각 스킬 폴더를 출력합니다. 예를 들어 Claude Code의 경우 ~/.claude/skills/aggrega이며, 모두 홈 디렉터리 아래에 있습니다. 명령을 다시 실행하면 이전 실행이 작성한 복사본을 교체하며, 이렇게 해서 스킬이 바이너리를 따라 새 버전으로 갱신됩니다. aggrega skills에서 명령, 각 어시스턴트가 읽는 폴더, 각 어시스턴트를 무엇으로 찾는지를 설명합니다.

단계를 수행할 수 없을 때

자동 완성을 설정할 수 없을 때(dash처럼 설정을 지원하지 않는 셸, 쓸 수 없는 폴더, 또는 프로필을 실행하지 않는 PowerShell 실행 정책) 또는 스킬을 설치할 수 없을 때(찾은 어시스턴트도 지정한 어시스턴트도 없음, 알 수 없는 식별자, 또는 설치가 작성하지 않은 파일이 스킬 폴더에 있음)에도 바이너리는 설치되어 실행됩니다. 명령은 단계가 실패한 이유를 알리고, 다음 단계를 출력한 뒤, 어느 단계가 실패했는지 나타내는 상태로 끝납니다. 상태는 다음과 같습니다:

상태의미
0aggrega가 설치되었고, 옵션이 요청한 모든 단계가 성공했습니다
1아무것도 설치되지 않았거나, 설치된 aggrega가 실행되지 않았습니다
2명령이 받지 않는 옵션이나 어시스턴트를 하나도 지정하지 않은 목록이 주어졌습니다. 아무 작업도 하지 않았습니다
3aggrega가 설치되어 실행되지만, 셸 자동 완성 설정에 실패했습니다
4aggrega가 설치되어 실행되지만, 스킬 설치에 실패했습니다
5aggrega가 설치되어 실행되지만, 두 작업 모두 실패했습니다

PowerShell 스크립트는 실행 중인 창을 닫지 않으므로 상태를 $LASTEXITCODE에 남기며, 0을 제외한 모든 상태는 오류로 끝나고, powershell -Command와 pwsh -Command는 이를 종료 상태 1로 보고합니다.

Windows 설치 프로그램으로 설치

각 릴리스에는 릴리스 페이지 https://github.com/aggrega-ai/aggrega-cli/releases에 Windows 설치 프로그램 aggrega-<version>-windows-amd64-setup.exe가 포함되어 있습니다. 내려받아 실행하십시오. 짧은 마법사를 통해 기본 aggrega.exe를 현재 사용자 전용으로, 관리자 권한 없이 그리고 권한을 요청하지도 않고 설치합니다:

  • 시작 페이지, 이어서 라이선스, 즉 Aggrega의 Apache License 2.0: I Agree를 누르기 전에는 아무것도 설치되지 않습니다. 이어서 구성 요소: 항상 설치되는 Aggrega 자체와, 선택되어 있는 Add to PATH.
  • 설치 폴더, 다른 폴더를 선택하지 않으면 %LOCALAPPDATA%\Programs\aggrega이며, 설치 명령이 사용하는 폴더입니다.
  • 진행 상황, 이어서 완료 페이지. 완료 페이지는 폴더를 보여 주고 이번 설치가 그 폴더를 PATH에 추가했는지 알려 주며 다음 단계를 안내합니다. aggrega skills install --global로 Aggrega 스킬을 설치하는 것과, MCP 클라이언트 연결에서 설명하는 대로 AI 클라이언트를 연결하는 것입니다.

하는 일:

  • Add to PATH가 선택되어 있으면 설치 폴더를 사용자 PATH에 추가합니다(이미 있으면 추가하지 않습니다). 설치 후에 연 터미널은 aggrega를 찾을 수 있지만, 이미 열려 있던 터미널은 시작할 때의 PATH를 그대로 유지합니다. 선택을 해제하면 PATH에 아무것도 추가되지 않으며, 터미널에서는 aggrega.exe를 전체 경로로 실행합니다. 이전 설치가 추가한 항목은 그대로 남습니다.
  • Aggrega를 설치된 앱 목록에 등록하며, 게시자는 Cognitio s.r.l.이므로 다른 앱과 마찬가지로 설정 → 앱에서 제거할 수 있습니다. 제거 프로그램은 확인을 요청한 다음, 설치 프로그램이 폴더에 넣은 파일, PATH 항목, 그 목록의 항목을 제거하고, 폴더에 아무것도 남지 않으면 폴더도 제거합니다.
  • 다시 실행하면 기존 설치 위에 덮어 설치하며, 마지막으로 설치한 폴더를 제시하므로 이후 릴리스의 설치 프로그램으로 가지고 있는 사본을 업데이트할 수 있고 PATH에는 항목이 하나만 유지됩니다.
  • 이 폴더에는 aggrega.exe 옆에 uninstall.exe, 라이선스 텍스트가 담긴 LICENSE, 그리고 EnVar.dll(설치 프로그램과 제거 프로그램이 PATH를 편집하는 데 사용하는 구성 요소)이 함께 있습니다.

편집기나 AI 클라이언트가 시작한 aggrega.exe가 실행 중이면 설치 프로그램은 이를 교체할 수 없으며, 그렇다는 메시지와 함께 중단됩니다. 이를 시작한 프로그램을 닫고 설치 프로그램을 다시 실행하십시오. 제거 프로그램도 아무것도 제거하기 전에 같은 방식으로 중단됩니다.

창 없이 설치하려면, 스크립트나 여러 컴퓨터에 소프트웨어를 설치하는 도구에서 대문자로 쓴 /S를 붙여 설치 프로그램을 실행합니다. 그러면 창이나 질문 없이, 이전 설치가 사용한 폴더에, 그렇지 않으면 기본 폴더에 Add to PATH를 적용하여 설치하며, 실패는 0이 아닌 종료 코드로 보고합니다. 제거 프로그램도 같은 스위치를 받습니다:

Terminal window
.\aggrega-<version>-windows-amd64-setup.exe /S
& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /S

설치 프로그램은 실행 파일과 마찬가지로 게시자 **Cognitio S.r.l.**와 타임스탬프로 서명되어 있습니다. Windows용 사전 빌드된 바이너리의 검사 방법은 aggrega.exe에서처럼 설치 프로그램에도 적용되며, 다운로드한 파일에 대해 Windows가 표시할 수 있는 메시지에 관한 설명도 마찬가지입니다. SHA256SUMS에는 릴리스의 다른 모든 파일과 마찬가지로 설치 프로그램의 다이제스트도 나열되어 있습니다.

설치 프로그램이 맞지 않는 경우, 위의 설치 명령과 수동 단계로 같은 aggrega.exe를 같은 폴더에 설치할 수 있습니다.

패키지 관리자로 설치

모든 릴리스는 Homebrew formula와 Scoop 매니페스트도 업데이트하므로, 이미 사용하는 패키지 관리자로 Aggrega를 설치하고 최신 상태로 유지할 수 있습니다. 둘 다 설치 명령과 같은 기본 바이너리를 설치하며, 릴리스의 SHA256SUMS에 나온 SHA-256 다이제스트로 검사합니다.

macOS와 Linux에서는 brew install aggrega-ai/tap/aggrega로 Homebrew를 사용해 설치합니다. Homebrew는 처음에 aggrega-ai/tap tap을 추가하고 시스템과 프로세서에 맞는 바이너리를 설치합니다. 대상은 Apple silicon 또는 Intel의 macOS, 64비트 x86 또는 64비트 ARM의 Linux입니다. 새 릴리스가 나오면 brew upgrade가 설치한 다른 모든 formula와 함께 이를 업데이트합니다.

Windows에서는 Scoop을 사용해 scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket으로 Aggrega bucket을 한 번 추가하고, scoop install aggrega로 그 bucket에서 설치합니다. Scoop은 Windows 바이너리를 aggrega.exe로 설치하고, PATH에 유지하는 shim 폴더를 통해 aggrega로 실행할 수 있게 합니다. 새 릴리스가 나오면 scoop update가 bucket을 새로 고치고 scoop update aggrega가 Aggrega를 업데이트합니다.

Homebrew와 Scoop은 각각 ~/.local/bin이나 %LOCALAPPDATA%\Programs\aggrega가 아닌 자체 폴더에 설치하며, 자신이 설치한 사본만 업데이트합니다. 한 컴퓨터에서는 설치 방법을 하나만 사용하십시오. 설치 명령이나 수동으로 설치한 사본과 Homebrew 또는 Scoop으로 설치한 사본은 별개의 두 사본이며, PATH에서 먼저 나오는 폴더가 어느 쪽이 실행될지 결정합니다.

winget으로 설치

Windows에서는 winget install Cognitio.Aggrega로 Windows 패키지 관리자인 winget을 사용해 설치합니다. winget은 릴리스 페이지에서 해당 릴리스의 Windows 설치 프로그램을 내려받아, 패키지 매니페스트에 나온 SHA-256 다이제스트로 검사한 뒤 무인 모드로 실행합니다. 결과는 설치 프로그램 자체의 결과와 같습니다. aggrega.exe가 %LOCALAPPDATA%\Programs\aggrega 또는 이전 설치가 사용한 폴더에 놓이고, 그 폴더가 사용자 PATH에 추가되며, Aggrega가 설치된 앱 목록에 표시되고, 이 모두가 관리자 권한 없이 이루어집니다. winget은 자신이 실행되는 터미널의 PATH를 변경하지 않으므로, aggrega version을 실행하기 전에 새 터미널을 여십시오.

winget upgrade Cognitio.Aggrega는 이후 릴리스를 덮어 설치하고, winget uninstall Cognitio.Aggrega는 제거 프로그램을 실행합니다. 설치 프로그램에서 다른 폴더를 선택하지 않는 한 winget, 설치 프로그램, 설치 명령은 모두 같은 폴더에 설치하므로, 마지막으로 실행된 것이 그곳에 aggrega.exe를 둡니다.

수동으로 설치

각 릴리스에는 64비트 x86 및 64비트 ARM용 Linux, 64비트 x86용 Windows, Apple silicon 및 Intel용 macOS의 사전 빌드된 바이너리가 릴리스 페이지 https://github.com/aggrega-ai/aggrega-cli/releases에 포함되어 있습니다. 운영 체제와 프로세서에 맞는 실행 파일을 내려받고(아래의 파일 선택에서 각 파일 이름을 알려 줍니다), 그곳에 설명된 대로 릴리스의 SHA256SUMS로 검사합니다. 그런 다음 실행 권한을 부여하고 ~/.local/bin/aggrega로 옮깁니다. Linux에서는 다운로드한 파일이 있는 디렉터리에서 다음을 실행합니다. <version>은 내려받은 버전으로 바꾸고, 64비트 ARM에서는 amd64를 arm64로 바꿉니다:

Terminal window
chmod +x aggrega-<version>-linux-amd64
mkdir -p ~/.local/bin
mv aggrega-<version>-linux-amd64 ~/.local/bin/aggrega

Windows의 경우 아래의 Windows용 사전 빌드된 바이너리를, macOS의 경우 macOS용 사전 빌드된 바이너리를 참조하십시오.

~/.local/bin이 PATH에 없으면, 셸이 시작할 때 읽는 파일(zsh는 ~/.zshrc, bash는 ~/.bashrc, macOS에서는 ~/.bash_profile)에 다음 줄을 추가하고 새 터미널을 여십시오:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

소스에서 빌드하려면, Go 툴체인이 설치된 상태에서 소스 트리로부터 aggrega 명령을 빌드하고 생성된 바이너리를 같은 폴더에 둡니다.

바이너리 설치의 마지막 부분처럼 aggrega version으로 설치를 확인합니다.

파일 선택

릴리스는 각 실행 파일의 이름을 aggrega-<version>-<system>-<processor>로 지정하며, Windows에서는 .exe가 붙습니다:

시스템프로세서파일
Linux64비트 x86(uname -m이 x86_64 출력)aggrega-<version>-linux-amd64
Linux64비트 ARM(uname -m이 aarch64 출력)aggrega-<version>-linux-arm64
Windows64비트 x86aggrega-<version>-windows-amd64.exe
macOSApple siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

이 파일이 설치 명령이 설치하는 파일이자 수동으로 내려받을 파일입니다. 그 옆에는 두 가지 변형이 있습니다. 설치 명령은 둘 다 설치하지 않으며, 각각 같은 방법으로 수동 설치합니다:

  • **aggrega-debug-<version>-…**는 디버거나 프로파일러가 읽는 디버그 정보를 포함한 같은 프로그램입니다. 기본 파일과 똑같이 실행되고 버전을 보고하며, 크기가 더 큽니다.
  • **aggrega-light-<version>-…**는 내장 플러그인 없이 빌드되었습니다. 핵심 플러그인을 자기 내부에서 찾는 대신, 워크스페이스 구성에 따라 플러그인 캐스케이드를 통해 모든 플러그인을 해석합니다.

Windows용으로 릴리스에는 기본 파일을 설치해 주는 Windows 설치 프로그램인 aggrega-<version>-windows-amd64-setup.exe도 포함되어 있습니다.

각 릴리스에는 SHA256SUMS도 포함되어 있습니다. 여기에는 두 설치 스크립트를 포함해 릴리스에 첨부된 다른 모든 파일의 SHA-256 다이제스트가 sha256sum이 읽는 형식으로 나열되어 있습니다. 설치 명령은 이 검사를 스스로 수행합니다. Linux에서 다운로드한 파일을 수동으로 검사하려면 SHA256SUMS를 같은 디렉터리에 두고 다음을 실행합니다:

Terminal window
sha256sum --check --ignore-missing SHA256SUMS

내려받은 파일은 OK로 보고됩니다. 다른 보고는 그 파일이 릴리스가 게시한 파일이 아니라는 뜻입니다.

Windows용 사전 빌드된 바이너리

Windows 실행 파일은 aggrega-<version>-windows-amd64.exe입니다(릴리스에서 그 옆에 있는 debug 및 light 변형도 같은 방법으로 설치합니다). 파일 이름을 aggrega.exe로 바꾸고, 설치 명령이 사용하는 폴더인 %LOCALAPPDATA%\Programs\aggrega로 옮긴 다음, 그 폴더를 사용자 PATH에 추가합니다. Windows는 .exe로 끝나는 파일을 실행 권한 부여 없이 실행하며, 이 이름으로 두면 aggrega 명령으로 찾습니다. 예를 들어 PowerShell에서는 다음과 같습니다. <version>은 내려받은 버전으로 바꿉니다:

Terminal window
$dir = "$env:LOCALAPPDATA\Programs\aggrega"
New-Item -ItemType Directory -Force $dir | Out-Null
Move-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"
Unblock-File "$dir\aggrega.exe"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

이후에 연 터미널은 aggrega를 찾습니다. 이미 열려 있던 터미널은 시작할 때의 PATH를 그대로 유지합니다.

실행 파일은 서명되어 있습니다. 각 파일에는 Windows가 확인하는 코드 서명인 Authenticode 서명이 있으며, Windows가 표시하는 게시자는 **Cognitio S.r.l.**입니다. 각 서명에는 타임스탬프도 포함됩니다. 서명에 사용된 인증서는 며칠 동안만 유효하며, 인증서가 만료된 후에도 서명이 유효하게 유지되는 것은 타임스탬프 덕분입니다. 내려받은 파일을 실행하기 전에 확인하려면:

  • 파일 탐색기에서는 파일의 속성을 열고 디지털 서명 탭을 엽니다. 서명 목록에 **Cognitio S.r.l.**이 표시됩니다. 이를 선택한 다음 자세히를 선택하면 *이 디지털 서명이 정상입니다.*라고 표시됩니다.

  • PowerShell에서는 위 예제와 같이 $dir을 설정한 상태에서:

    Terminal window
    $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"
    $signature.Status
    $signature.SignerCertificate.Subject

    Status는 Valid를 보고하고, 주체는 CN=Cognitio S.r.l.로 시작합니다. NotSigned 또는 HashMismatch는 파일이 릴리스에서 게시한 파일이 아니거나 서명된 후 변경되었음을 의미합니다.

서명은 게시자를 나타낼 뿐, 모든 경고를 없애 주지는 않습니다. 어떤 경고가 표시되는지는 파일을 받은 방식과 실행하는 방식에 따라 다릅니다:

  • 다운로드하는 동안 브라우저가 일반적으로 다운로드되는 파일이 아니라고 경고하며 보관할지 물을 수 있습니다. 보관을 선택하면 파일이 다운로드된 상태로 저장됩니다.
  • 파일 탐색기나 브라우저에서 실행하면 Windows가 Windows의 PC 보호를 표시할 수 있습니다. 이 메시지는 Microsoft Defender SmartScreen에서 표시하며, SmartScreen은 파일과 게시자가 쌓아 온 평판을 따지므로 새로 릴리스된 버전은 서명되어 있더라도 자체 평판이 쌓일 때까지 이 메시지가 표시될 수 있습니다. 서명된 파일의 경우 메시지에 게시자가 표시됩니다. 추가 정보를 선택하고 **Cognitio S.r.l.**과 내려받은 파일 이름이 표시되는지 확인한 다음 실행을 선택합니다. 대신 PowerShell이나 명령 프롬프트에서 실행하면 같은 파일이 이 메시지 없이 실행될 수 있으며, 그 여부는 Windows 버전과 설정에 따라 다릅니다.
  • Unblock-File은 이 메시지에 미리 응답합니다. 내려받은 파일에는 인터넷에서 온 파일이라는 표시가 붙으며, Windows의 PC 보호 검사는 이 표시를 기준으로 합니다. 위 예제와 같이 PowerShell에서 Unblock-File을 실행하면 이 표시가 제거되며, 파일 탐색기에서 파일 속성의 일반 탭에 있는 차단 해제 확인란도 같은 역할을 합니다.
  • 스마트 앱 컨트롤이 켜져 있으면(Windows 11) 프로그램을 실행할 때 이를 검사합니다. Microsoft의 설명에 따르면 스마트 앱 컨트롤은 먼저 Microsoft의 클라우드 보안 서비스에 프로그램이 안전한지 묻고, 해당 서비스가 확실한 예측을 내리지 못하면 서명을 확인하여 유효한 서명이 있는 프로그램은 실행을 허용하고 서명이 없거나 서명이 유효하지 않은 프로그램은 차단합니다. 켜져 있는지 여부는 Windows 보안의 앱 및 브라우저 컨트롤에서 확인할 수 있습니다.

macOS용 사전 빌드된 바이너리

macOS 실행 파일은 Apple silicon Mac용 aggrega-<version>-darwin-arm64와 Intel 프로세서 Mac용 aggrega-<version>-darwin-amd64입니다. Apple 메뉴의 이 Mac에 관하여에서 어느 쪽인지 확인할 수 있습니다. 릴리스에서 그 옆에 있는 debug 및 light 변형도 같은 방법으로 설치합니다. Apple silicon Mac은 Rosetta 2가 설치되어 있으면 이를 통해 Intel 파일도 실행하지만, Apple silicon용으로 빌드된 것은 Apple silicon 파일입니다.

파일 이름을 aggrega로 바꾸고 실행 권한을 부여한 다음, 설치 명령이 사용하는 폴더인 ~/.local/bin으로 옮깁니다. 예를 들어 터미널에서 다운로드한 파일이 있는 디렉터리에서 다음을 실행합니다. <version>은 내려받은 버전으로 바꾸고, Intel Mac에서는 arm64를 amd64로 바꿉니다:

Terminal window
chmod +x aggrega-<version>-darwin-arm64
mkdir -p ~/.local/bin
mv aggrega-<version>-darwin-arm64 ~/.local/bin/aggrega

mkdir은 폴더가 아직 없으면 폴더를 만듭니다. ~/.local/bin은 macOS가 새 터미널에 제공하는 PATH에 포함되어 있지 않으므로, 이미 추가되어 있지 않다면 수동으로 설치의 줄을 ~/.zshrc에, bash의 경우 ~/.bash_profile에 추가하십시오.

실행 파일은 서명 및 공증되어 있습니다. 각 파일에는 **Cognitio s.r.l.**의 Developer ID(Apple이 Mac App Store 밖에서 배포되는 소프트웨어를 위해 개발자에게 발급하는 인증서)로 만든 코드 서명이 강화된 런타임 및 보안 타임스탬프와 함께 들어 있으며, Apple의 공증 서비스가 각 파일을 검사하고 공증했습니다. 인터넷에서 받은 소프트웨어를 검사하는 macOS 기능인 Gatekeeper는 격리 표시(웹 브라우저가 내려받은 파일에 추가하는 표시)가 있는 프로그램을 평가하고, Apple이 공증한 프로그램은 허용합니다. 따라서 릴리스 페이지에서 내려받은 파일은 그대로 실행됩니다. 공증 티켓은 단일 실행 파일에 첨부할 수 없으므로 Gatekeeper는 파일이 처음 실행될 때 온라인으로 티켓을 찾습니다. 그 순간 Mac이 오프라인이면 Gatekeeper는 Mac이 Apple에 연결될 수 있을 때까지 파일을 차단할 수 있습니다.

다운로드한 파일을 실행하기 전에 검사하려면, 터미널에서 내려받은 파일 이름으로 다음을 실행합니다:

Terminal window
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64
codesign --display --verbose=2 aggrega-<version>-darwin-arm64

첫 번째는 파일이 valid on disk이며 satisfies its Designated Requirement라고 보고합니다. 두 번째는 서명의 인증 기관을 나열하는데, 첫 번째 항목은 Developer ID Application: COGNITIO SRL이고 그 뒤에 괄호 안의 팀 식별자가 오며, Timestamp도 함께 표시됩니다. 둘 중 하나라도 통과하지 못하는 파일은 릴리스가 게시한 파일이 아니거나 서명된 뒤에 변경된 것입니다.

curl로 가져온 파일에는 격리 표시가 없으므로 Gatekeeper는 이를 전혀 평가하지 않습니다. curl은 브라우저처럼 표시를 추가하지 않기 때문입니다. 설치 명령이 배치하는 바이너리가 그 평가 없이 실행되는 이유도 이것입니다.