Aggiornare la CLI dosya

dosya upgrade è destinato a un binario compilato installato, non a una copia del codice sorgente. Le piattaforme supportate sono Linux x64, macOS arm64 e x64 e Windows x64.

Prima di iniziare

• Esegui dosya --version e annota il percorso del binario corrente prima di cambiarlo.
• Usa l’origine API ufficiale attendibile. Per usare un host personalizzato per le versioni serve abilitare esplicitamente l’opzione per host personalizzati; l’host dovrebbe essere approvato dalla tua organizzazione.
• La richiesta del manifest della versione scade dopo 30 secondi; il download del binario ha un limite di 300 secondi.

Procedura

1. Esegui dosya --version e individua l’eseguibile attivo con gli strumenti di ricerca del percorso del sistema operativo. Fermati se il processo usa una copia di sviluppo del codice.
2. Esegui dosya upgrade durante una finestra di manutenzione interattiva. Usa --force solo per reinstallare la stessa versione o tornare intenzionalmente a una versione precedente approvata.
3. Lascia che il programma di aggiornamento scelga il file per la piattaforma. Rifiuta un’architettura non supportata invece di usare un binario dal nome simile.
4. Verifica che lo SHA-256 del file scaricato corrisponda a quello nel manifest della versione. Se il checksum non corrisponde, rifiuta il file scaricato e lascia invariato il binario installato.
5. Consenti al programma di preparare un file temporaneo eseguibile con modalità 0755 e di sostituire la destinazione rinominando il file temporaneo o copiandolo se la rinomina non riesce.
6. Esegui di nuovo dosya --version da una nuova shell, poi verifica whoami --json in sola lettura prima di riattivare i processi pianificati.

Risultato previsto

Il binario compilato supportato viene sostituito solo dopo la verifica del manifest e dello SHA-256. Una nuova esecuzione mostra la versione approvata e può autenticarsi per un controllo in sola lettura.

Risoluzione dei problemi

L’aggiornamento indica che l’ambiente di esecuzione non è supportato. Installa un binario compilato pubblicato per un sistema operativo e un’architettura supportati.

Il checksum è diverso. Riprova dall’origine attendibile; non aggirare mai la verifica.

Viene ancora eseguita la vecchia versione. Controlla l’ordine di ricerca dei comandi e i processi di lunga durata. Sostituire il file non cambia un processo già in esecuzione.

Guide correlate

• Installare la CLI
• Trasferire file con la CLI