Aller au contenu principal

Utiliser Spaces

Créer un espace​

Spaces est conçu pour être simple à utiliser. Pour utiliser Spaces, ouvrez un terminal et saisissez arch, fedora, ubuntu ou kali.

Ces commandes sont des alias de :

spaces enter <space> # arch/fedora/ubuntu/kali

Lorsque vous exécutez spaces enter et que l’espace n’est pas installé, une boîte de dialogue s’ouvre pour vous permettre de le configurer. Pour rouvrir cette boîte de dialogue plus tard et recréer l’espace, saisissez :

spaces create <space>

Après l’installation, la commande spaces create vous permet de recréer l’espace tout en conservant les données de son répertoire personnel.

Spaces vous guidera dans une boîte de dialogue de gestion des permissions, puis vous fera choisir des versions du système d’exploitation (pour Ubuntu et Fedora) et des personnalisations (yay, Shelly pour Arch).

Il existe deux profils de permissions : basic, pour les applications courantes qui ne modifient pas les paramètres système, et development, qui vous permet d’installer des VPN, Docker et des machines virtuelles, ainsi que d’accéder directement aux périphériques. Vous pouvez aussi choisir custom et régler chaque permission individuellement. Par défaut, votre répertoire ~/Downloads est monté dans Spaces, et ~/Projects est ajouté dans les espaces de développement pour que vous puissiez y stocker votre code. Les espaces de développement transmettent également vos clés GPG et SSH, votre .gitconfig (pour votre nom et votre adresse e-mail Git), votre .ssh/config (pour vos hôtes SSH), ainsi que vos fichiers .bashrc et .zshrc pour personnaliser votre terminal. En mode custom, vous pouvez monter n’importe quel répertoire visible de votre répertoire personnel.

Le reste de vos fichiers, vos clés SSH et vos clés GPG restent privés et ne peuvent donc pas être exfiltrés. De plus, SELinux protège vos clés. Par défaut, Anatase configure votre agent SSH à votre connexion avec les clés id_rsa/id_ed25519. Vous devrez ajouter manuellement vos autres clés à votre agent SSH. Il est toutefois recommandé de n’utiliser qu’une seule clé, celle que vous enregistrez également auprès de services comme Github.

Utiliser Spaces​

Vous pouvez ouvrir un espace à l’aide des commandes ubuntu, fedora, arch et kali, ou de la commande sous-jacente spaces enter <space>.

Une fois dans un espace, vous pouvez exécuter les commandes habituelles de la distribution concernée, suivre à la lettre sa documentation et retrouver le même fonctionnement. Tout écart devrait être signalé comme un bogue dans le système de suivi des problèmes d’Anatase ou sur Discord.

Pour le développement, installez l’IDE de votre choix dans un espace. Par exemple, vous pouvez suivre les instructions Linux de VS Code pour l’installer. Installer votre IDE dans un espace lui permet d’intégrer nativement ses terminaux, son débogueur et l’exécution de commandes à cette distribution. Vous pouvez aussi installer des IDE dans plusieurs espaces utilisés pour le développement (par exemple, à la fois Fedora et Ubuntu). Veuillez ne pas installer les versions Flatpak des IDE.

Spaces exporte automatiquement les raccourcis du bureau des applications que vous installez vers votre environnement de bureau principal. Vous pouvez aussi choisir l’une d’elles comme application par défaut.

info

Un espace est installé avec le minimum de paquets requis pour assurer l’intégration au bureau. Cependant, les paquets ne sont pas parfaits et il leur manque parfois des dépendances. Par exemple, dans Ubuntu, l’installation de NordVPN nécessite libgtk-3-0 et libgles2, qui ne figurent pas parmi ses dépendances. Lorsque vous rencontrez une dépendance manquante, notez-la et créez un rapport de bogue afin que nous puissions commencer à les répertorier. Vous pouvez exécuter la commande du paquet dans un terminal pour déduire les paquets manquants à partir des erreurs (par exemple, nordvpn-gui pour NordVPN), puis installer les dépendances manquantes jusqu’à ce que le programme fonctionne.

Modifier les permissions​

Pour modifier les permissions d’un espace après sa création, vous pouvez exécuter :

spaces configure <space>

La boîte de dialogue des permissions s’ouvrira de nouveau et vous pourrez effectuer les modifications souhaitées. Lorsque vous validez la boîte de dialogue, votre espace s’arrête. Vos modifications seront appliquées lors de son prochain démarrage.

Supprimer un espace​

Si un espace occupe trop de place, vous pouvez exécuter :

spaces delete <space>

Démarrer et arrêter Spaces​

Spaces est implémenté sous la forme de services systemd système standard, selon la syntaxe suivante : spaces@<space>. Spaces propose aussi une variante de service --user, activée par défaut pour votre utilisateur dès que vous créez un espace. Ainsi, un espace ne démarre qu’à votre connexion, afin que vos fichiers soient montés lorsque vos services démarrent. La variante utilisateur se contente de démarrer le service système. De plus, spaces enter <space> et ses alias démarrent automatiquement l’espace s’il ne l’est pas déjà.

Voici quelques commandes que vous pouvez utiliser avec Spaces :

# Activer le démarrage de l’espace au démarrage du système
# Ainsi, Tailscale fonctionne avant votre connexion.
sudo systemctl enable --now spaces@ubuntu
# Annuler l’activation précédente
sudo systemctl disable --now spaces@ubuntu

# Démarrer un espace à la connexion de votre utilisateur (par défaut)
systemctl --user enable --now spaces@ubuntu
# Désactiver le démarrage de l’espace à la connexion de votre utilisateur
systemctl --user disable --now spaces@ubuntu

# Arrêter votre espace
sudo systemctl stop spaces@ubuntu
# Démarrer votre espace manuellement
sudo systemctl start spaces@ubuntu
# Redémarrer votre espace
sudo systemctl restart spaces@ubuntu

# Consulter le journal systemd de votre espace
journalctl -u spaces@ubuntu

Supprimer les fichiers du répertoire personnel de Spaces​

Spaces utilise un répertoire personnel distinct pour stocker la configuration système propre à vos espaces. Ainsi, la configuration des applications reste séparée des données de votre hôte, ce qui évite les conflits, et vous gardez le contrôle des dossiers exposés dans l’espace.

Par défaut, lorsque vous recréez ou supprimez un espace, les données de son répertoire personnel sont conservées. En général, vous ne devriez jamais avoir besoin d’effacer les données du répertoire personnel de votre espace. Faites-le uniquement si vous souhaitez également supprimer les anciennes configurations qui s’y trouvent. Pour supprimer les données du répertoire personnel de l’espace, vous pouvez ajouter --purge à spaces create/delete.

# Créer ou recréer un espace avec un répertoire personnel vierge
spaces create --purge <space>

# Supprimer un espace ainsi que ses données personnelles et sa configuration de permissions
spaces delete --purge <space>

Les données du répertoire personnel de votre hôte ne sont jamais modifiées lorsque vous exécutez des commandes Spaces.

Utiliser des clés GPG dans Spaces​

L’utilisation des clés GPG n’est pas très intuitive. Vous devez d’abord créer une clé GPG depuis un terminal de l’hôte. Vous pouvez ensuite l’exporter comme suit.

Commencez par lister vos clés GPG et récupérer leurs identifiants. Prenons les miennes en exemple.

$ gpg --list-secret-keys
sec ed25519 2024-07-31 [SC]
4DBB5595849C1C4EF1117688EF34000BBBE32D2A
uid [ultimate] Antheas Kapenekakis <[email protected]>
uid [ultimate] Antheas Kapenekakis <[email protected]>
ssb cv25519 2024-07-31 [E]

Il ne s’agit pas d’informations privées et, comme vous pouvez le constater, la plupart des commits dans Anatase sont signés par la clé ci-dessus.

Une fois que vous avez l’identifiant de votre clé, ici 4DBB5595849C1C4EF1117688EF34000BBBE32D2A, exportez la clé publique dans un fichier ASCII protégé, puis réimportez-la dans l’espace de votre choix. Par exemple, dans Fedora :

gpg --armor --export 4DBB5595849C1C4EF1117688EF34000BBBE32D2A > ~/Projects/public.asc
fedora
gpg --import ~/Projects/public.asc

Vous pouvez maintenant exécuter la même commande dans l’espace pour vérifier que la transmission GPG fonctionne.

$ gpg --list-secret-keys
[keyboxd]
---------
sec ed25519 2024-07-31 [SC]
4DBB5595849C1C4EF1117688EF34000BBBE32D2A
uid [ unknown] Antheas Kapenekakis <[email protected]>
uid [ unknown] Antheas Kapenekakis <[email protected]>
ssb cv25519 2024-07-31 [E]

Vous pouvez ajouter ce qui suit à ~/.gitconfig dans le répertoire personnel de votre hôte pour forcer la signature GPG de vos commits (~/.gitconfig est transmis) :

[commit]
gpgsign = true