csansoon/hostel-install

Installer le CLI hostel et se connecter

Le binaire hostel est le même pour les personnes, les agents, le serveur et les machines de salle. Cette compétence l'installe sur l'ordinateur d'une personne et connecte cet ordinateur à un serveur. Pour une machine serveur, voir hostel-server-setup. Pour une machine de salle, voir hostel-rooms.

macOS et Linux

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh

Le script télécharge la dernière version de GitHub, vérifie le fichier par rapport à SHA256SUMS de la version et installe hostel dans ~/.local/bin.

Options (à mettre après sh -s --) :

Option	Effet
--dir DIR	Installer le binaire dans DIR (par défaut ~/.local/bin).
--version vX.Y.Z	Installer cette version (par défaut : la plus récente).
--server DIR	Installer également les binaires de salle dans DIR/helpers et les scripts de plateforme dans DIR/platforms. Uniquement pour une machine serveur.

Exemples :

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --dir /usr/local/bin
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --version v0.1.0

Si le script affiche note: ... is not on your PATH, ajoutez le répertoire au PATH dans le profil du shell, par exemple :

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

Supporté : macOS et Linux sur amd64 ou arm64. La variable d'environnement HOSTEL_INSTALL_URL remplace l'URL de téléchargement (un miroir).

Windows

Dans PowerShell (aucun droit d'administrateur nécessaire) :

irm https://raw.githubusercontent.com/csansoon/hostel/main/install.ps1 | iex

Le script installe hostel.exe dans %LOCALAPPDATA%\Programs\hostel, le vérifie par rapport à SHA256SUMS et ajoute ce répertoire au PATH utilisateur. Ouvrez un nouveau terminal après la première installation. $env:HOSTEL_VERSION (par exemple v0.1.0) sélectionne une version ; $env:HOSTEL_INSTALL_URL définit un miroir.

Remarque : install.ps1 est nouveau. S'il échoue, téléchargez hostel-windows-amd64.exe (ou -arm64.exe) depuis la version GitHub, renommez-le en hostel.exe et placez-le dans un répertoire du PATH.

Vérifier l'installation

hostel --version
hostel help

Connecter l'ordinateur à un serveur

Un administrateur du serveur vous donne un code d'invitation (hostel1-...). Il fonctionne une fois, pendant 24 heures. Voir hostel-users pour savoir comment un administrateur en crée un.

hostel connect hostel1-...
hostel connect hostel1-... --name "Alice Example"

• Le nom par défaut provient de git config user.name. Dans un terminal, connect le demande.
• La sortie affiche le serveur, la clé TLS épinglée (pour un serveur avec son propre certificat), votre rôle et le nom de l'ordinateur.
• La connexion est stockée dans ~/.config/hostel/config.toml (mode 0600). Sur Windows, elle se trouve au même endroit sous %USERPROFILE%.
• Un ordinateur a au plus une connexion. Si une connexion existe, connect demande avant de la remplacer. --yes la remplace sans poser de question.
• Les agents sur cet ordinateur utilisent la même connexion. Ils n'ont pas besoin de la leur.

Vérifiez-la :

hostel status

Déconnexion (le serveur supprime le jeton de cet ordinateur) :

hostel disconnect

Pour les tests et l'IC, les variables d'environnement HOSTEL_SERVER, HOSTEL_TOKEN et HOSTEL_SERVER_KEY remplacent le fichier.

L'application Hostel

Exécutez hostel sans argument dans un terminal. Cela ouvre une application plein écran :

• Non connecté : Check in (collez le code d'invitation, puis votre nom) ou Leave.
• Hall : les plateformes, leurs machines libres, la file d'attente et l'attente.
• Salles : les machines, leur état et qui les utilise.
• Réception : le serveur et vous ; Inviter un invité (administrateurs), Ajouter votre autre ordinateur (membres), Liste d'invités, Ajouter une salle (administrateurs), Check out (déconnexion).

Touches : 1 2 3 vont au Hall, aux Salles, à la Réception ; ? liste toutes les touches ; q quitte. NO_COLOR=1 désactive les couleurs. Sans terminal (un agent, un tube), hostel affiche l'aide à la place. Les agents utilisent hostel status (texte brut).

Mise à jour

Exécutez à nouveau la même commande d'installation. Elle remplace le binaire.

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
hostel --version

Sur Windows, exécutez à nouveau la ligne irm ... | iex. La connexion reste.

Pour la machine serveur, redémarrez également le service après la mise à jour (hostel-server-setup, section « Mise à jour »).

Suite

• Utiliser une salle : hostel-use.
• En cas d'échec : hostel-troubleshoot.