Installer Frost

Frost s'installe en une seule commande sous macOS, Linux et Windows. Chaque version embarque son propre environnement d'exécution : rien d'autre à installer avant.

#Systèmes pris en charge

Il n'existe pas de paquet pour l'ARM 32 bits, comme les anciens systèmes Raspberry Pi. Sous Windows, WSL installe le paquet Linux.

#L'installateur

Sous macOS ou Linux, lancez cette commande dans un terminal :

curl -fsSL https://getfro.st/install.sh | sh

Sous Windows, lancez celle-ci dans PowerShell :

irm https://getfro.st/install.ps1 | iex

L'installateur :

1. Télécharge la dernière version pour votre système.
2. Vérifie la signature de la version et la somme de contrôle du téléchargement, et s'arrête si l'une des deux ne correspond pas.
3. Installe Frost dans votre profil utilisateur et place un lanceur frost dans un dossier de votre PATH.

Sous macOS et Linux, il lui faut curl ou wget, ssh-keygen d'OpenSSH 8.1 ou plus récent, et sha256sum ou shasum pour les vérifications. Sous Windows, il lui faut Windows PowerShell 5.1, fourni avec Windows 10 et 11, ou PowerShell 7. Il vérifie la signature avec l'environnement d'exécution inclus dans la version, une fois que Windows a confirmé que l'OpenJS Foundation l'a signé.

Sous macOS et Linux, le lanceur va dans /usr/local/bin si vous pouvez y écrire, sinon dans ~/.local/bin. Si ce dossier n'est pas encore dans votre PATH, l'installateur affiche la ligne qui l'ajoute. Sous Windows, le lanceur va dans %LocalAppData%\frost\bin, et l'installateur ajoute ce dossier à votre PATH. Les terminaux déjà ouverts doivent être relancés pour trouver frost.

L'installateur curl fonctionne aussi dans Git Bash sous Windows. Il a alors besoin de cygpath, que fournit Git Bash, extrait les fichiers avec unzip ou PowerShell et place le lanceur dans ~/bin.

Une fois terminé, lancez frost init pour configurer votre première sauvegarde. Voir Configurer Frost.

#Options de l'installateur

Par exemple, sous macOS ou Linux :

curl -fsSL https://getfro.st/install.sh | FROST_INSTALL_DIR="$HOME/bin" sh

Sous Windows, définissez d'abord la variable, dans la même fenêtre PowerShell :

$env:FROST_VERSION = 'v0.1.0'; irm https://getfro.st/install.ps1 | iex

Changer le dossier du lanceur ne déplace pas Frost lui-même. Fichiers et dossiers indique où va chaque élément.

#Avec npm ou pnpm

Si vous avez déjà Node.js 22 ou plus récent, vous pouvez installer Frost avec npm :

npm install -g getfrost

Ou avec pnpm :

pnpm add -g getfrost

Le paquet s'appelle getfrost, et la commande qu'il fournit est frost. La première fois que vous lancez frost, il télécharge la version pour votre système, vérifie sa signature et sa somme de contrôle comme le fait l'installateur, et l'installe dans votre profil utilisateur. Puis il exécute votre commande. Ensuite, chaque commande frost passe directement au Frost installé, qui se tient à jour tout seul.

Avec pnpm, lancez d'abord pnpm setup si vous ne l'avez jamais fait, pour que les commandes globales de pnpm soient dans votre PATH.

#Installer à la main

1. Téléchargez l'archive pour votre système depuis la dernière version. Les noms ressemblent à frost_0.1.0_linux_amd64.tar.gz, avec .zip sous Windows.
2. Vérifiez le téléchargement avant d'en exécuter quoi que ce soit, comme expliqué plus bas dans « Vérifier un téléchargement ».
3. Extrayez-la dans un nouveau dossier vide.
4. Dans le dossier extrait, lancez l'installateur fourni en lui indiquant le dossier du lanceur.

Sous macOS ou Linux :

./runtime/bin/node install.mjs "$PWD" "$HOME/.local/bin"

Sous Windows, dans PowerShell :

.\runtime\bin\node.exe .\install.mjs "$PWD" "$env:LOCALAPPDATA\frost\bin"

Ajoutez ensuite le dossier du lanceur à votre PATH s'il n'y est pas déjà. Sous Windows, frost.cmd fonctionne dans l'Invite de commandes et PowerShell, et frost dans Git Bash.

Pour utiliser un paquet extrait sans l'installer, lancez directement son lanceur frost (frost.cmd sous Windows) et gardez tous ses fichiers ensemble.

#Vérifier un téléchargement

L'installateur s'en charge pour vous. Pour vérifier une archive vous-même, téléchargez-la avec checksums.txt et checksums.txt.sig de la même version, ainsi que release-signing.pub depuis le dépôt. Mettez le nom de l'archive dans archive, puis lancez :

(
  set -e
  archive='frost_X.Y.Z_linux_amd64.tar.gz'
  printf 'frost-release %s\n' "$(cat release-signing.pub)" > allowed_signers
  ssh-keygen -Y verify -f allowed_signers -I frost-release -n file -s checksums.txt.sig < checksums.txt
  selected_checksum=$(awk -v archive="$archive" '$2 == archive { line = $0; count++ } END { if (count != 1) exit 1; print line }' checksums.txt)
  printf '%s\n' "$selected_checksum" | shasum -a 256 -c -
)

Les commandes s'arrêtent si la signature est incorrecte ou si la liste signée ne contient pas exactement une entrée pour votre archive. La première vérification doit afficher Good "file" signature, et la seconde OK après le nom de votre archive. Si l'une des deux échoue, ne l'installez pas.