Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Instalasi Aggrega

Aggrega memerlukan dua hal: biner aggrega yang terpasang, dan, untuk menulis dengan asisten AI, klien asisten Anda yang terhubung ke server MCP yang dibawa biner tersebut. Perintah-perintahnya disajikan lebih dulu; apa yang dilakukan masing-masing, serta cara instalasi lainnya, menyusul setelahnya.

Menginstal binary

Di Linux dan macOS, di terminal:

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

Di Windows, di PowerShell:

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

Dengan Homebrew, di macOS dan Linux:

Terminal window
brew install aggrega-ai/tap/aggrega

Dengan Scoop, di Windows:

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

Dengan winget, di Windows:

Terminal window
winget install Cognitio.Aggrega

Lalu periksa bahwa biner tersebut berjalan:

Terminal window
aggrega version

String versi berarti biner ditemukan dan dapat dijalankan. Hanya itu yang dibutuhkan server MCP. Setiap cara instalasi, secara rinci menjelaskan apa yang dilakukan setiap perintah, di mana biner diletakkan, dan cara memasang dengan penginstal Windows atau secara manual.

Menghubungkan klien MCP

Klien asisten AI Anda memulai server MCP Aggrega dengan menjalankan aggrega mcp, dan Menghubungkan server MCP memberikan perintah atau entri yang menambahkannya, untuk setiap klien. Pada asisten yang memasang plugin, plugin Aggrega menambahkan server dan skill Aggrega dalam satu langkah: lihat Memasang plugin.

Setiap cara instalasi, secara rinci

Aggrega didistribusikan sebagai satu executable tunggal. Satu perintah menginstalnya; langkah manual setelahnya melakukan hal yang sama secara manual. Keduanya menaruhnya di satu folder milik Anda sendiri, folder yang sama setiap kali, dan tidak satu pun memerlukan hak administrator: ~/.local/bin/aggrega di Linux dan macOS, dan %LOCALAPPDATA%\Programs\aggrega\aggrega.exe di Windows. Di Windows, penginstal Windows dan winget menginstalnya ke folder yang sama, juga tanpa hak administrator, dan mencantumkannya di antara aplikasi terinstal Anda: lihat Menginstal dengan penginstal Windows dan Menginstal dengan winget. Homebrew di macOS dan Linux, serta Scoop di Windows, juga menginstalnya, masing-masing ke folder miliknya sendiri: lihat Menginstal dengan manajer paket.

Menginstal dengan satu perintah

Perintah instalasinya adalah curl -fsSL https://aggrega.ai/install.sh | sh di Linux dan macOS serta irm https://aggrega.ai/install.ps1 | iex di PowerShell pada Windows, dua perintah pertama dari Menginstal binary. Kedua alamat tersebut dialihkan ke skrip instalasi yang dilampirkan rilis terbaru, sehingga perintah yang sama juga berjalan dengan alamat milik rilis itu sendiri:

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

Yang dilakukan perintah ini:

  • Perintah ini memilih binary default untuk mesin Anda dari rilis terbaru: Linux dan macOS pada x86 64-bit atau ARM 64-bit, Windows pada x86 64-bit. Perintah ini menolak sistem atau prosesor lain dengan pesan yang menyebutkan apa yang ditemukannya atau ke mana harus beralih. Di Mac dengan Apple silicon, perintah ini memilih binary Apple silicon, bahkan dari shell yang berjalan melalui Rosetta 2.
  • Perintah ini memeriksa binary terhadap SHA256SUMS rilis sebelum menginstal apa pun. Unduhan yang digest SHA-256-nya berbeda dari yang tercantum di daftar akan dihapus, tidak ada yang diinstal, dan perintah berhenti dengan pesan yang menyebutkan kedua digest.
  • Perintah ini menginstal binary hanya untuk Anda, sebagai ~/.local/bin/aggrega di Linux dan macOS dan sebagai %LOCALAPPDATA%\Programs\aggrega\aggrega.exe di Windows, membuat folder jika belum ada dan mengganti salinan sebelumnya di sana dalam satu langkah, sehingga menjalankan perintah lagi akan memperbarui salinan yang Anda miliki. Perintah ini tidak pernah menggunakan sudo. Di Windows, perintah ini juga menghapus tanda yang dapat dibawa file yang diunduh dari internet, seperti yang dilakukan Unblock-File dalam langkah manual. Di macOS, perintah ini mengunduh dengan curl, sehingga binary yang diinstalnya tidak membawa tanda karantina (lihat Binary siap pakai untuk macOS).
  • Perintah ini membuat perintah dapat dijangkau. Di Linux dan macOS, jika folder tidak ada di PATH Anda, perintah ini mencetak perintah yang menambahkan folder ke file yang dibaca shell Anda saat dimulai: ~/.zshrc untuk zsh, ~/.bashrc untuk bash (~/.bash_profile di macOS), ~/.config/fish/config.fish untuk fish, dengan baris fish_add_path, dan ~/.profile untuk shell lainnya. Perintah ini tidak menjalankan perintah itu sendiri: jalankan perintah itu dan buka terminal baru. Di Windows, perintah ini menambahkan folder ke PATH pengguna Anda jika belum ada di sana, dan ke PATH jendela PowerShell tempat perintah dijalankan, sehingga aggrega dapat dijalankan di jendela itu dan di setiap terminal yang dibuka setelahnya, dan perintah ini memberi tahu bahwa folder telah ditambahkan.
  • Perintah ini memeriksa bahwa binary yang terinstal dapat berjalan, dan berhenti dengan sebuah pesan sebelum hal lain disiapkan jika binary itu tidak berjalan. Perintah ini menambahkan catatan jika ada aggrega lain yang mendahului yang diinstalnya di PATH Anda.
  • Perintah ini mencetak versi yang terinstal, dengan menjalankan binary yang diinstalnya melalui path lengkapnya, sehingga versi tampil bahkan sebelum PATH Anda mencakup folder tersebut.
  • Perintah ini diakhiri dengan langkah-langkah berikutnya, di bawah Next:, masing-masing satu baris: perintah yang menjalankan quickstart AI, seperti yang dijelaskan Memulai; aggrega skills install --global, yang menambahkan skill Aggrega ke asisten AI di mesin Anda, seperti yang dijelaskan Menambahkan skill asisten saat instalasi; dan alamat halaman ini, untuk pelengkapan shell dan Menghubungkan klien MCP di atas. Jika sebuah opsi sudah menginstal skill tersebut, barisnya dihilangkan.

Yang dicetaknya singkat: versi dan sistem yang menjadi target instalasi, satu baris setelah unduhan cocok dengan checksum-nya, dan path tempat menginstalnya. Memulai menampilkan satu eksekusi lengkap. --verbose, yang diberikan setelah sh -s -- seperti opsi di bawah, juga mencetak alamat daftar checksum, nama file rilis, dan alamat tempat file itu diunduh; install.ps1 memiliki switch yang sama sebagai -Verbose, untuk eksekusi skrip dengan argumen, yang tidak dapat diberikan oleh irm … | iex. Jika perintah menolak atau sebuah langkah gagal, perintah memberitahukannya dalam satu baris, di standard error dari install.sh dan sebagai galat atau peringatan yang ditampilkan PowerShell dari install.ps1:

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

install.sh, skrip untuk Linux dan macOS, memerlukan curl atau wget, uname, dan sha256sum atau shasum. install.ps1, skrip untuk Windows, berjalan di Windows PowerShell 5.1 dan di PowerShell 7.

Dua pengaturan mengubah apa yang diinstal, masing-masing dibaca dari lingkungan tempat skrip dijalankan:

  • AGGREGA_VERSION menyebutkan rilis yang akan diinstal, misalnya 0.8.7, ditulis dengan atau tanpa v di depannya. Jika tidak ditetapkan, perintah menginstal rilis terbaru — rilis yang ditandai GitHub sebagai latest, yang tidak pernah berupa prarilis, sehingga prarilis hanya diinstal jika disebutkan di sini.
  • AGGREGA_INSTALL_DIR menyebutkan folder tujuan instalasi sebagai pengganti folder default. Binary di sana bernama aggrega, atau aggrega.exe di Windows, dan perintah membuat folder itu dapat dijangkau seperti di atas.

Di Linux dan macOS, letakkan pengaturan sebelum sh, bukan sebelum curl, agar skrip menerimanya:

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

Di PowerShell, tetapkan terlebih dahulu di jendela; pengaturan itu tetap berlaku di sana sampai Anda menghapusnya dengan Remove-Item Env:AGGREGA_VERSION:

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

Menyiapkan pelengkapan shell saat instalasi

Dengan --completion, install.sh juga menyiapkan pelengkapan shell, sehingga tombol Tab melengkapi perintah dan flag aggrega. Opsi ditulis setelah sh -s --, yang meneruskannya ke skrip yang dibaca sh dari pipa:

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

irm … | iex tidak meneruskan opsi apa pun ke skrip. Di PowerShell, siapkan pelengkapan setelah instalasi selesai, dengan skrip yang ditulis oleh aggrega completion powershell, seperti yang dijelaskan Pelengkapan shell. install.ps1 juga menerima -Completion, untuk eksekusi skrip dengan argumen.

Perintah ini menyiapkan pelengkapan hanya untuk Anda, tanpa hak administrator, untuk shell yang disebut oleh pengaturan SHELL Anda, atau di PowerShell untuk PowerShell tempat perintah ini berjalan. Perintah ini memakai skrip yang ditulis oleh aggrega completion milik biner yang terpasang, dan menyebutkan setiap file yang ditulis atau diubahnya:

  • bash: skrip ditulis ke ~/.local/share/bash-completion/completions, folder tempat paket bash-completion membaca pelengkapan milik Anda sendiri. Pelengkapan Bash untuk aggrega memerlukan paket tersebut.
  • zsh: _aggrega ditulis ke ~/.local/share/zsh/site-functions dan tiga baris ditambahkan ke ~/.zshrc yang menaruh folder itu di jalur fungsi zsh dan memuatnya, dengan menjalankan compinit jika belum ada apa pun di file tersebut yang menjalankannya lebih dulu.
  • fish: aggrega.fish ditulis ke ~/.config/fish/completions, yang dibaca fish dengan sendirinya.
  • PowerShell: skrip ditulis sebagai %LOCALAPPDATA%\aggrega\completion.ps1 dan dua baris yang memuatnya ditambahkan ke profil Anda untuk setiap host PowerShell tempat perintah ini berjalan, $PROFILE.CurrentUserAllHosts. Windows PowerShell dan PowerShell 7 menyimpan profil terpisah, jadi jalankan dari masing-masing yang Anda gunakan. Profil hanya dijalankan jika kebijakan eksekusi yang dipakai jendela baru adalah RemoteSigned, Unrestricted, atau Bypass; di bawah kebijakan lain, seperti Restricted, perintah ini tidak menulis apa pun dan menyebutkan kebijakan yang ditemukannya. Perintah ini tidak pernah mengubah kebijakan tersebut.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR, dan ZDOTDIR memindahkan folder dan file tersebut sesuai cara masing-masing shell membacanya. Terminal atau jendela baru memuat pelengkapan. Menjalankan perintah lagi hanya menulis ulang skrip jika aggrega yang terpasang menulis skrip yang berbeda, dan menambahkan baris-baris ke ~/.zshrc atau profil hanya sekali; itu juga cara menambahkan pelengkapan ke instalasi yang sudah Anda miliki, karena perintah ini memasang ulang biner sekalian.

Menambahkan skill asisten saat menginstal

Dengan --skills (-Skills di PowerShell), perintah instalasi juga menginstal skill Aggrega — instruksi yang mengajari asisten AI cara menginstal dan menggunakan Aggrega — di setiap proyek Anda, untuk asisten AI di mesin Anda. Kedua opsi dapat diberikan bersamaan:

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

Di PowerShell, tempat irm … | iex tidak meneruskan opsi apa pun, jalankan aggrega skills install --global setelah instalasi selesai: itulah perintah yang dijalankan oleh -Skills.

Perintah ini menjalankan aggrega skills install --global milik binary yang terinstal, yang mencari asisten di mesin Anda — setiap asisten yang folder konfigurasinya berada di direktori home Anda, atau yang perintahnya ada di PATH Anda — lalu mencetak setiap asisten yang ditemukannya dan apa yang menemukannya. Kemudian:

  • Di terminal, perintah ini bertanya terlebih dahulu. Tekan Enter untuk menginstal skill bagi asisten yang ditemukan, atau ketik pengenal asisten lain untuk menambahkannya, dipisahkan dengan spasi atau koma; aggrega skills list mencetak pengenal tersebut. Dengan curl … | sh, skrip membaca dirinya sendiri dari pipe, sehingga perintah ini bertanya melalui terminal Anda sebagai gantinya.
  • Jika tidak ada terminal untuk bertanya, seperti di dalam skrip, perintah ini menginstal untuk asisten yang ditemukannya.
  • Untuk memilih asisten sendiri, berikan asisten tersebut setelah opsi, dipisahkan dengan koma: --skills claude-code,cursor, atau --skills=claude-code,cursor, dan di PowerShell -Skills claude-code,cursor. Perintah ini lalu menginstal untuk asisten tersebut dan tidak mencari yang lain.

Perintah ini mencetak setiap folder skill yang ditulisnya, seperti ~/.claude/skills/aggrega untuk Claude Code, semuanya di bawah direktori home Anda. Menjalankan perintah lagi akan mengganti salinan yang ditulis oleh eksekusi sebelumnya; dengan cara inilah skill mengikuti binary ke versi yang lebih baru. aggrega skills menjelaskan perintah tersebut, folder yang dibaca setiap asisten, dan apa yang menemukan masing-masing asisten.

Ketika suatu langkah tidak dapat dilakukan

Ketika completion tidak dapat disiapkan — shell yang tidak disiapkannya, seperti dash, folder yang tidak dapat ditulisinya, atau kebijakan eksekusi PowerShell yang tidak menjalankan profil apa pun — atau skill tidak dapat diinstal — tidak ada asisten yang ditemukan dan tidak ada yang disebutkan, pengenal yang tidak dikenalnya, atau file di folder skill yang tidak ditulis oleh suatu instalasi — binary tetap terinstal dan dapat dijalankan. Perintah ini menyebutkan alasan langkah tersebut gagal, mencetak langkah selanjutnya, dan diakhiri dengan status yang menyebutkan langkah mana yang gagal. Status-statusnya adalah:

StatusArti
0aggrega terinstal, dan setiap langkah yang diminta oleh suatu opsi berhasil
1tidak ada yang diinstal, atau aggrega yang terinstal tidak dapat berjalan
2perintah diberi opsi yang tidak diterimanya, atau daftar yang tidak menyebutkan asisten apa pun; perintah tidak melakukan apa pun
3aggrega terinstal dan berjalan, tetapi penyiapan shell completion gagal
4aggrega terinstal dan berjalan, tetapi instalasi skill gagal
5aggrega terinstal dan berjalan, tetapi keduanya gagal

Skrip PowerShell tidak pernah menutup jendela tempat skrip itu berjalan, sehingga skrip meninggalkan status di $LASTEXITCODE, dan setiap status selain 0 berakhir dengan galat, yang dilaporkan powershell -Command dan pwsh -Command sebagai status keluar 1.

Menginstal dengan penginstal Windows

Setiap rilis menyertakan penginstal Windows, aggrega-<version>-windows-amd64-setup.exe, di halaman rilis di https://github.com/aggrega-ai/aggrega-cli/releases. Unduh dan jalankan. Penginstal ini menginstal aggrega.exe default hanya untuk Anda, tanpa hak administrator dan tanpa memintanya, melalui wizard singkat:

  • Halaman sambutan, lalu lisensi, Apache License 2.0 milik Aggrega: tidak ada yang diinstal sampai Anda menekan I Agree. Lalu komponen: Aggrega itu sendiri, selalu diinstal, dan Add to PATH, dalam keadaan terpilih.
  • Folder instalasi, %LOCALAPPDATA%\Programs\aggrega kecuali Anda memilih yang lain; ini adalah folder yang digunakan perintah instalasi.
  • Kemajuan, lalu halaman selesai yang menyebutkan folder dan menyatakan apakah instalasi ini menambahkannya ke PATH Anda, beserta langkah berikutnya: menginstal skill Aggrega dengan aggrega skills install --global, dan menghubungkan klien AI Anda seperti dijelaskan di Menghubungkan klien MCP.

Yang dilakukannya:

  • Dengan Add to PATH terpilih, penginstal menambahkan folder instalasi ke PATH pengguna Anda kecuali sudah ada di sana. Terminal yang dibuka setelah instalasi akan menemukan aggrega; terminal yang sudah terbuka tetap memakai PATH saat terminal itu dimulai. Jika pilihan itu dikosongkan, tidak ada yang ditambahkan ke PATH Anda, dan terminal menjalankan aggrega.exe melalui path lengkapnya; entri yang ditambahkan instalasi sebelumnya dibiarkan apa adanya.
  • Penginstal mencantumkan Aggrega di antara aplikasi terinstal Anda, dengan penerbit Cognitio s.r.l., sehingga dapat dicopot dari Settings → Apps seperti aplikasi lainnya. Pencopot instalasi meminta Anda mengonfirmasi, lalu menghapus file yang ditaruh penginstal di folder, entri PATH, dan entri di daftar itu, serta menghapus folder jika tidak ada lagi yang tersisa di dalamnya.
  • Jika dijalankan lagi, penginstal menginstal di atas yang sudah ada, dengan menawarkan folder tempat ia terakhir menginstal, sehingga penginstal rilis yang lebih baru memperbarui salinan yang Anda miliki, dengan tetap menyimpan satu entri di PATH Anda.
  • Di samping aggrega.exe, folder berisi uninstall.exe, LICENSE dengan teks lisensi, dan EnVar.dll, komponen yang digunakan penginstal dan pencopot instalasi untuk mengedit PATH Anda.

Ketika aggrega.exe sedang berjalan — dijalankan oleh editor atau klien AI — penginstal tidak dapat menggantinya, dan berhenti dengan pesan yang menyatakan hal itu; tutup program yang menjalankannya lalu jalankan penginstal lagi. Pencopot instalasi berhenti dengan cara yang sama, sebelum menghapus apa pun.

Untuk menginstal tanpa jendela, dari skrip atau alat yang menginstal perangkat lunak di banyak mesin, jalankan penginstal dengan /S, ditulis dengan huruf kapital; penginstal lalu menginstal tanpa jendela atau pertanyaan, ke folder yang digunakan instalasi sebelumnya atau, jika tidak ada, ke folder default, dengan Add to PATH, dan melaporkan kegagalan melalui kode keluarnya, yang bukan 0. Pencopot instalasi menerima sakelar yang sama:

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

Penginstal ditandatangani seperti executable, dengan penerbit Cognitio S.r.l. dan stempel waktu: pemeriksaan di Binary siap pakai untuk Windows berlaku untuknya seperti untuk aggrega.exe, begitu pula penjelasan di sana tentang prompt yang dapat ditampilkan Windows untuk file yang diunduh. SHA256SUMS mencantumkan digest-nya seperti setiap file lain dalam rilis.

Jika penginstal tidak sesuai, perintah instalasi di atas dan langkah manual menginstal aggrega.exe yang sama ke folder yang sama.

Menginstal dengan manajer paket

Setiap rilis juga memperbarui formula Homebrew dan manifes Scoop, sehingga manajer paket yang sudah Anda gunakan dapat menginstal Aggrega dan menjaganya tetap mutakhir. Masing-masing menginstal binary default yang sama dengan yang diinstal perintah instalasi, diperiksa terhadap digest SHA-256 yang diberikan SHA256SUMS rilis untuknya.

Di macOS dan Linux, brew install aggrega-ai/tap/aggrega menginstalnya dengan Homebrew. Homebrew menambahkan tap aggrega-ai/tap pada kali pertama dan menginstal binary untuk sistem dan prosesor Anda: macOS pada Apple silicon atau Intel, Linux pada x86 64-bit atau ARM 64-bit. Setelah rilis baru, brew upgrade memperbaruinya bersama setiap formula lain yang Anda instal.

Di Windows, dengan Scoop, tambahkan bucket Aggrega sekali dengan scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, lalu instal darinya dengan scoop install aggrega. Scoop menginstal binary Windows sebagai aggrega.exe dan membuatnya dapat dijangkau sebagai aggrega melalui folder shim yang disimpannya di PATH Anda. Setelah rilis baru, scoop update menyegarkan bucket dan scoop update aggrega memperbaruinya.

Homebrew dan Scoop masing-masing menginstal ke folder miliknya sendiri, bukan ke ~/.local/bin atau %LOCALAPPDATA%\Programs\aggrega, dan hanya memperbarui salinan yang diinstalnya. Gunakan satu cara instalasi pada satu mesin: salinan yang diinstal dengan perintah instalasi atau secara manual dan salinan lain yang diinstal dengan Homebrew atau Scoop adalah dua salinan, dan folder mana yang lebih dulu di PATH Anda menentukan mana yang dijalankan.

Menginstal dengan winget

Di Windows, winget install Cognitio.Aggrega menginstalnya dengan winget, Windows Package Manager. winget mengunduh penginstal Windows rilis dari halaman rilisnya, memeriksanya terhadap digest SHA-256 yang diberikan manifes paket, lalu menjalankannya tanpa pengawasan. Hasilnya sama dengan hasil penginstal itu sendiri: aggrega.exe di %LOCALAPPDATA%\Programs\aggrega, atau di folder yang digunakan instalasi sebelumnya, folder itu di PATH pengguna Anda, dan Aggrega di daftar aplikasi terinstal Anda, semuanya tanpa hak administrator. winget tidak mengubah PATH terminal tempat winget dijalankan, jadi buka terminal baru sebelum menjalankan aggrega version.

winget upgrade Cognitio.Aggrega menginstal rilis yang lebih baru di atasnya, dan winget uninstall Cognitio.Aggrega menjalankan pencopot instalasinya. winget, penginstal, dan perintah instalasi semuanya menginstal ke folder yang sama kecuali Anda memilih folder lain di penginstal, sehingga yang dijalankan terakhir yang menaruh aggrega.exe di sana.

Menginstal secara manual

Setiap rilis menyertakan binary siap pakai untuk Linux pada x86 64-bit dan ARM 64-bit, untuk Windows pada x86 64-bit, serta untuk macOS pada Apple silicon dan Intel, di halaman rilis di https://github.com/aggrega-ai/aggrega-cli/releases. Unduh executable untuk sistem operasi dan prosesor Anda — Memilih file di bawah menyebutkan masing-masing — dan periksa terhadap SHA256SUMS rilis, seperti dijelaskan di sana. Lalu tandai sebagai dapat dieksekusi dan pindahkan ke ~/.local/bin/aggrega. Di Linux, dari direktori tempat hasil unduhan berada, dengan <version> diganti versi yang Anda unduh, dan amd64 dengan arm64 pada ARM 64-bit:

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

Di Windows, lihat Binary siap pakai untuk Windows di bawah; di macOS, lihat Binary siap pakai untuk macOS.

Jika ~/.local/bin tidak ada di PATH Anda, tambahkan baris ini ke file yang dibaca shell Anda saat dimulai — ~/.zshrc untuk zsh, ~/.bashrc untuk bash (~/.bash_profile di macOS) — lalu buka terminal baru:

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

Dari kode sumber, dengan toolchain Go terinstal, build perintah aggrega dari pohon kode sumber dan letakkan binary yang dihasilkan di folder yang sama.

Konfirmasikan instalasi dengan aggrega version, seperti di akhir Menginstal binary.

Memilih file

Rilis menamai setiap executable aggrega-<version>-<system>-<processor>, dengan .exe di Windows:

SystemProsesorBerkas
Linuxx86 64-bit (uname -m mencetak x86_64)aggrega-<version>-linux-amd64
LinuxARM 64-bit (uname -m mencetak aarch64)aggrega-<version>-linux-arm64
Windowsx86 64-bitaggrega-<version>-windows-amd64.exe
macOSApple siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

File itulah yang diinstal perintah instalasi, dan yang diunduh secara manual. Dua variannya berada di sampingnya; perintah instalasi tidak menginstal keduanya, dan masing-masing diinstal secara manual dengan cara yang sama:

  • aggrega-debug-<version>-… adalah program yang sama dengan informasi debug-nya, yang dibaca debugger atau profiler. Program ini berjalan dan melaporkan versinya persis seperti file default, dan ukurannya lebih besar.
  • aggrega-light-<version>-… di-build tanpa plugin tersemat: program ini me-resolve setiap plugin melalui kaskade plugin, sebagaimana dikonfigurasi oleh workspace, alih-alih menemukan plugin inti di dalam dirinya sendiri.

Untuk Windows, rilis juga menyertakan aggrega-<version>-windows-amd64-setup.exe, yaitu penginstal Windows, yang menginstal file default untuk Anda.

Setiap rilis juga menyertakan SHA256SUMS, digest SHA-256 dari setiap file lain yang dilampirkannya, termasuk kedua skrip instalasi, dalam bentuk yang dibaca sha256sum. Perintah instalasi melakukan pemeriksaan ini sendiri. Untuk memeriksa unduhan secara manual di Linux, dengan SHA256SUMS di direktori yang sama:

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

File yang Anda unduh dilaporkan OK; laporan lain apa pun berarti file itu bukan file yang dipublikasikan rilis.

Binary siap pakai untuk Windows

Executable Windows adalah aggrega-<version>-windows-amd64.exe (varian debug dan light di sampingnya dalam rilis diinstal dengan cara yang sama). Ganti namanya menjadi aggrega.exe, pindahkan ke %LOCALAPPDATA%\Programs\aggrega, folder yang digunakan perintah instalasi, dan tambahkan folder itu ke PATH pengguna Anda: Windows menjalankan file berakhiran .exe tanpa perlu menandainya sebagai dapat dieksekusi, dan menemukannya sebagai perintah aggrega dengan nama tersebut. Dari PowerShell, misalnya, dengan <version> diganti versi yang Anda unduh:

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")

Terminal yang dibuka setelah itu menemukan aggrega; terminal yang sudah terbuka tetap memakai PATH saat ia dimulai.

Executable-nya ditandatangani. Masing-masing membawa tanda tangan Authenticode, tanda tangan kode yang diperiksa Windows, dan penerbit yang ditampilkan Windows untuknya adalah Cognitio S.r.l. Setiap tanda tangan juga membawa stempel waktu: sertifikat di balik tanda tangan hanya berlaku selama beberapa hari, dan stempel waktulah yang membuat tanda tangan tetap valid setelah sertifikat itu kedaluwarsa. Untuk memeriksa file yang diunduh sebelum menjalankannya:

  • Di File Explorer, buka Properties file tersebut dan tab Digital Signatures. Daftar tanda tangan menyebutkan Cognitio S.r.l.; pilih entri itu lalu Details, yang melaporkan This digital signature is OK.

  • Di PowerShell, dengan $dir seperti pada contoh di atas:

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

    Status melaporkan Valid, dan subjeknya diawali CN=Cognitio S.r.l.. NotSigned atau HashMismatch berarti file tersebut bukan yang dipublikasikan oleh rilis, atau telah diubah setelah ditandatangani.

Tanda tangan menyebutkan penerbit; tanda tangan tidak menghilangkan setiap peringatan. Peringatan mana yang Anda temui bergantung pada cara file tiba dan cara Anda menjalankannya:

  • Saat mengunduh, browser dapat memperingatkan bahwa file tersebut jarang diunduh dan menanyakan apakah file akan disimpan. Menyimpannya akan menyimpan file sebagaimana diunduh.
  • Saat Anda menjalankannya dari File Explorer atau dari browser, Windows dapat menampilkan Windows protected your PC. Prompt itu berasal dari Microsoft Defender SmartScreen, yang menimbang reputasi yang telah dibangun oleh sebuah file dan penerbitnya, sehingga versi yang baru dirilis masih dapat menemuinya, meskipun ditandatangani, sampai reputasinya sendiri terbangun. Untuk file yang ditandatangani, prompt menyebutkan penerbitnya: pilih More info, periksa bahwa prompt menyebutkan Cognitio S.r.l. dan nama file yang Anda unduh, lalu pilih Run anyway. Jika dijalankan dari PowerShell atau command prompt, file yang sama dapat berjalan tanpa prompt itu; hal ini bergantung pada versi Windows dan pengaturannya.
  • Unblock-File menjawab prompt itu lebih dahulu. File yang diunduh ditandai sebagai berasal dari internet, dan tanda itulah yang ditanggapi oleh pemeriksaan Windows protected your PC. Unblock-File di PowerShell, seperti pada contoh di atas, menghapus tanda tersebut; begitu pula kotak centang Unblock pada tab General di Properties file tersebut di File Explorer.
  • Jika Smart App Control diaktifkan (Windows 11), fitur ini memeriksa program saat Anda menjalankannya. Sebagaimana dijelaskan Microsoft, Smart App Control terlebih dahulu menanyakan kepada layanan keamanan cloud Microsoft apakah program tersebut aman; jika layanan itu tidak dapat membuat prediksi yang meyakinkan, fitur ini memeriksa tanda tangan, mengizinkan program dengan tanda tangan valid berjalan dan memblokir program yang tidak ditandatangani atau tanda tangannya tidak valid. Status aktifnya ditampilkan di bawah App & browser control di Windows Security.

Binary siap pakai untuk macOS

Executable macOS adalah aggrega-<version>-darwin-arm64, untuk Mac dengan Apple silicon, dan aggrega-<version>-darwin-amd64, untuk Mac dengan prosesor Intel; About This Mac di menu Apple menunjukkan mana yang Anda miliki. Varian debug dan light di sampingnya dalam rilis diinstal dengan cara yang sama. Mac dengan Apple silicon juga menjalankan file Intel, melalui Rosetta 2 jika terinstal, tetapi file Apple silicon adalah yang di-build untuknya.

Ganti nama file menjadi aggrega, tandai sebagai dapat dieksekusi, dan pindahkan ke ~/.local/bin, folder yang digunakan perintah instalasi. Dari Terminal, misalnya, di direktori tempat hasil unduhan berada, dengan <version> diganti versi yang Anda unduh, dan arm64 dengan amd64 pada Mac Intel:

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

mkdir membuat folder jika belum ada. ~/.local/bin tidak ada di PATH yang diberikan macOS kepada terminal baru, jadi tambahkan baris dari Menginstal secara manual ke ~/.zshrc, atau ke ~/.bash_profile untuk bash, kecuali sudah ada di sana.

Executable-nya ditandatangani dan dinotarisasi. Masing-masing membawa tanda tangan kode yang dibuat dengan Developer ID milik Cognitio s.r.l. — sertifikat yang diterbitkan Apple kepada developer untuk perangkat lunak yang didistribusikan di luar Mac App Store — dengan hardened runtime dan stempel waktu aman, dan layanan notarisasi Apple telah memeriksa serta menotarisasi masing-masing. Gatekeeper, pemeriksaan macOS terhadap perangkat lunak dari internet, menilai program yang membawa tanda karantina, tanda yang ditambahkan browser web ke file yang diunduhnya, dan menerima program yang telah dinotarisasi Apple, sehingga file yang diunduh dari halaman rilis dapat langsung berjalan. Tiket notarisasi tidak dapat dilampirkan ke satu file executable, sehingga Gatekeeper mencari tiket secara online saat file pertama kali dijalankan; pada Mac yang sedang offline saat itu, Gatekeeper dapat memblokir file sampai Mac dapat menjangkau Apple.

Untuk memeriksa file yang diunduh sebelum menjalankannya, dari Terminal, dengan nama file yang Anda unduh:

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

Perintah pertama melaporkan bahwa file valid on disk dan satisfies its Designated Requirement. Perintah kedua mencantumkan otoritas tanda tangan, yang pertama adalah Developer ID Application: COGNITIO SRL diikuti pengenal tim dalam tanda kurung, serta sebuah Timestamp. File yang gagal pada salah satunya bukan file yang dipublikasikan rilis, atau telah diubah setelah ditandatangani.

File yang diambil dengan curl tidak membawa tanda karantina, sehingga Gatekeeper sama sekali tidak menilainya: curl tidak menambahkan tanda yang ditambahkan browser. Itu juga sebabnya binary yang ditaruh perintah instalasi berjalan tanpa penilaian tersebut.