Sentry CLI

Sentry CLI è l'utilità a riga di comando di Sentry per integrare i flussi di sviluppo e rilascio con Sentry. Questo pacchetto installa l'eseguibile sentry-cli da getsentry/sentry-cli. È adatto a sviluppatori e responsabili CI/CD che necessitano del caricamento di artefatti, della gestione delle release e dell'accesso automatizzato ai dati Sentry supportati.

Attività di sviluppo e rilascio

Lo strumento può caricare file di informazioni di debug e source map JavaScript, creare e gestire release, associare commit e informazioni di distribuzione e lavorare con i dati supportati relativi a problemi e log. I comandi per build e snapshot servono i flussi Sentry supportati, anziché fungere da generico strumento locale per creare applicazioni o acquisire schermate.

Il caricamento di simboli di debug e source map aiuta Sentry a risolvere gli stack trace e associare gli eventi al codice sorgente. La CLI non sostituisce un SDK Sentry nell'applicazione monitorata, non crea un server di monitoraggio e non strumenta automaticamente ogni programma del computer. Il contenuto degli artefatti, gli identificatori di debug e i nomi delle release devono corrispondere alla build e alla configurazione SDK dell'applicazione.

Installazione e primo utilizzo

Installare questo pacchetto con brew install --cask sentry-cli. Il Cask colloca il binario della piattaforma nel percorso degli eseguibili di Homebrew come sentry-cli; non installa un'app desktop con un ambiente grafico. Usare sentry-cli --version e sentry-cli --help per esaminare la versione installata e i comandi disponibili prima di configurare un flusso di lavoro.

Scegliere l'architettura Mac appropriata: il download registrato è Darwin arm64 per Apple Silicon, con un binario Darwin x86_64 separato per Intel. Le release ufficiali contengono anche build Linux e Windows e il Cask ha registrato varianti Linux. Un binario nativo non richiede npm o Node.js solo perché esiste anche un metodo di installazione npm. La compilazione dal sorgente ha requisiti separati per Rust/Cargo e gli strumenti di build nativi.

Il binario ufficiale Darwin arm64 3.8.0 è di 13,637,040 byte secondo HTTP HEAD. È la dimensione di trasferimento del binario, esclusi artefatti caricati, risultati delle build locali e cache. Il Cask registrato non dichiara dipendenze aggiuntive, Cask in conflitto o una versione minima numerica di macOS. Verificare la release pertinente e la compatibilità dell'host anziché dedurre un minimo universale dall'elenco delle piattaforme del pacchetto.

Autenticazione e configurazione

Le operazioni Sentry richiedono generalmente un'organizzazione/progetto Sentry autorizzati e credenziali appropriate al comando. Configurare gli slug di organizzazione e progetto tramite le opzioni documentate o SENTRY_ORG e SENTRY_PROJECT, e usare SENTRY_AUTH_TOKEN per l'autenticazione supportata tramite token. SENTRY_URL può selezionare un endpoint self-hosted supportato anziché il servizio ospitato.

La configurazione può provenire da opzioni della riga di comando, variabili d'ambiente, file .env e file .sentryclirc. Lo strumento cerca la configurazione risalendo dalla directory di lavoro e legge anche i valori predefiniti dal file .sentryclirc nella home dell'utente. Assicurarsi che token ed endpoint appartengano al servizio e al progetto previsti, soprattutto in un repository con configurazione ereditata. Usare un archivio di segreti in CI e proteggere ogni file di configurazione contenente credenziali; evitare di inserire un token reale in esempi versionati o log.

Un DSN identifica una destinazione di acquisizione degli eventi per i comandi supportati e non sostituisce un token API con autorizzazioni per release o artefatti. Usare i privilegi minimi necessari per l'operazione selezionata e controllare i requisiti di autenticazione del comando. Installare il binario non crea un account, non concede l'appartenenza a un'organizzazione e non aggira le autorizzazioni del servizio.

Modifiche remote e gestione dei dati

I comandi di caricamento e rilascio possono inviare source map, simboli di debug, file di build, snapshot o metadati associati al servizio Sentry selezionato. Questi artefatti possono contenere percorsi sorgente o altre informazioni sensibili; controllare ciò che il flusso invia e l'account di destinazione prima del caricamento. I comandi locali vengono eseguiti con le autorizzazioni dell'utente che li invoca, mentre le operazioni sul server usano le credenziali Sentry fornite.

Alcuni comandi creano, aggiornano o rimuovono informazioni sulle release lato server. Esaminare opzioni e destinazioni prima di inserirli nell'automazione. È uno strumento per sviluppatori, non una garanzia che ogni comando sia di sola lettura o che file locali e metadati di progetto restino privati per impostazione predefinita.

Compatibilità del server e stato del progetto

Il README con tag supporta Sentry SaaS e Sentry self-hosted 24.11.1 o successivo. Per le versioni self-hosted precedenti rimanda alla CLI 2.58.6, precisando che ricevono assistenza solo le versioni del server ufficialmente supportate. Le funzioni CLI più recenti possono richiedere capacità lato server e, secondo la guida alla compatibilità, i comandi di build sono riservati a Sentry SaaS.

Il repository upstream attuale annuncia che questa CLI non è più in sviluppo attivo e sarà sostituita dalla CLI più recente in getsentry/toolkit. Le richieste di funzionalità e la maggior parte delle nuove segnalazioni sono indirizzate al nuovo progetto, mentre le correzioni del vecchio progetto si concentrano su ostacoli concreti alla migrazione. Questo pacchetto sentry-cli installato è lo strumento esistente; una CLI distinta e più recente non viene installata automaticamente e non è garantita come sostituto comando per comando.

Costi e licenza

La CLI si può scaricare senza acquistare un abbonamento separato a uno strumento desktop. Gli account ospitati Sentry hanno propri piani, limiti di utilizzo e prezzi; il self-hosting richiede infrastruttura e gestione. Un'installazione CLI non include un abbonamento al servizio ospitato né capacità illimitata per eventi, artefatti o build.

Il sorgente 3.8.0 è distribuito sotto Functional Source License 1.1 con futura licenza MIT (FSL-1.1-MIT). Consente gli scopi definiti dalla licenza e limita gli usi concorrenti; la concessione MIT diventa effettiva per una versione al secondo anniversario della sua disponibilità. Non considerare una build appena pubblicata come già MIT senza restrizioni e non presumere che tutti i prodotti server Sentry condividano la licenza di questa CLI. Le condizioni relative a dipendenze e marchi restano separate.

L'icona è il marchio ufficiale dell'organizzazione Sentry. Non c'è una schermata GUI autonoma: questo pacchetto si usa in un terminale e dalla documentazione CLI esaminata non è stata individuata un'illustrazione ufficiale del terminale adatta.

Fonti: Progetto con tag e compatibilità, Documentazione CLI, Autenticazione e configurazione, Registro ufficiale delle modifiche, Licenza FSL con tag, Stato attuale del progetto, Piani Sentry.