Ga naar hoofdinhoud

Spaces gebruiken

Een Space maken​

Spaces is ontworpen voor eenvoudig gebruik. Om Spaces te gebruiken, open je een terminal en typ je arch, fedora, ubuntu of kali.

Deze opdrachten zijn aliassen voor:

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

Als je spaces enter uitvoert terwijl de Space niet is geïnstalleerd, wordt er een dialoogvenster geopend waarin je de Space kunt instellen. Om dit dialoogvenster later opnieuw te openen en de Space opnieuw te maken, typ je:

spaces create <space>

Met spaces create kun je na de installatie de Space opnieuw maken met behoud van de homegegevens van je Space.

Spaces begeleidt je door een machtigingendialoogvenster en laat je vervolgens kiezen uit OS-versies (voor Ubuntu en Fedora) en aanpassingen (yay, Shelly voor Arch).

Er zijn twee presets voor machtigingen: basic voor basisapplicaties die geen systeeminstellingen wijzigen, en development, waarmee je VPN's, docker en VM's kunt installeren en rechtstreekse toegang tot apparaten krijgt. Je kunt ook custom kiezen en elke afzonderlijke machtiging nauwkeurig instellen. Standaard wordt je map ~/Downloads gekoppeld in Spaces, en in development Spaces wordt ~/Projects toegevoegd om je ontwikkelcode op te slaan. Development Spaces geven ook je GPG, SSH, .gitconfig (voor je Git-naam en e-mailadres), .ssh/config voor je SSH-hosts, .bashrc en .zshrc door voor je terminalaanpassingen. In de modus custom kun je elke zichtbare map in je home koppelen.

De rest van je bestanden, je SSH-sleutels en je GPG-sleutels blijven privé, zodat ze niet kunnen worden buitgemaakt. Je sleutels worden bovendien beschermd door SELinux. Standaard stelt Anatase je SSH-agent in wanneer je inlogt, met de sleutels id_rsa/id_ed25519. Je moet de rest van je sleutels handmatig aan je SSH-agent toevoegen. Het wordt echter aanbevolen om slechts één sleutel te gebruiken: de sleutel die je ook registreert bij diensten zoals Github.

Spaces gebruiken​

Je kunt een Space openen met de opdrachten ubuntu, fedora, arch en kali of met de onderliggende opdracht spaces enter <space>.

Eenmaal in een Space kun je elke opdracht uitvoeren die je gewend bent van de betreffende distributie, de documentatie voor die distributie letterlijk volgen en verwachten dat alles op dezelfde manier werkt als in die distributie. Afwijkingen kun je melden als bugs in de Anatase-issuetracker of op Discord.

Installeer voor ontwikkeling de IDE van je keuze in een Space. Je kunt bijvoorbeeld de Linux-instructies van VS Code volgen om die te installeren. Als je je IDE in een Space installeert, kan die de terminals, debugger en opdrachten ervan native integreren in die distributie. Je kunt ook IDE's installeren in alle Spaces die je voor ontwikkeling gebruikt (bijvoorbeeld zowel Fedora als Ubuntu). Installeer geen flatpak- versies van IDE's.

Spaces exporteert automatisch de snelkoppelingen op het bureaublad van alle applicaties die je installeert naar je belangrijkste desktopomgeving. Je kunt ook een van die applicaties als standaardapp instellen.

info

Een Space wordt geïnstalleerd met de minimale pakketten die nodig zijn om de desktopintegratie te laten werken. Pakketten zijn echter niet perfect en missen soms afhankelijkheden. Zo vereist het installeren van NordVPN in Ubuntu libgtk-3-0 en libgles2, die niet in de afhankelijkheden zijn opgenomen. Noteer ontbrekende afhankelijkheden wanneer je die tegenkomt en maak een bugmelding, zodat we ze kunnen verzamelen. Je kunt de pakketopdracht in een terminal uitvoeren om aan de hand van de foutmeldingen ontbrekende pakketten af te leiden (bijvoorbeeld nordvpn-gui voor NordVPN) en ontbrekende afhankelijkheden installeren totdat het programma werkt.

Machtigingen wijzigen​

Als je de machtigingen van een Space na het maken wilt wijzigen, kun je het volgende uitvoeren:

spaces configure <space>

Het machtigingendialoogvenster wordt opnieuw geopend, waarna je willekeurige wijzigingen kunt aanbrengen. Na het bevestigen van het dialoogvenster wordt je Space afgesloten. Wanneer je deze weer start, worden je wijzigingen toegepast.

Een Space verwijderen​

Als een Space te veel ruimte inneemt, kun je het volgende uitvoeren:

spaces delete <space>

Spaces starten en stoppen​

Spaces zijn geïmplementeerd als normale systemd-systeemservices met de volgende syntaxis: spaces@<space>. Spaces biedt ook een --user-servicevariant die standaard voor je gebruiker is ingeschakeld zodra je een Space maakt. Zo start een Space pas wanneer je inlogt, zodat je bestanden zijn gekoppeld wanneer je services starten. De gebruikersvariant start alleen de systeemservice. Daarnaast starten spaces enter <space> en de aliassen de Space automatisch als die nog niet is gestart.

Hier zijn enkele opdrachten die je met Spaces kunt gebruiken:

# Schakel in dat de Space bij het opstarten wordt gestart
# Zo werkt Tailscale voordat je inlogt.
sudo systemctl enable --now spaces@ubuntu
# Maak de vorige inschakeling ongedaan
sudo systemctl disable --now spaces@ubuntu

# Schakel in dat een Space wordt gestart wanneer je gebruiker inlogt (standaard)
systemctl --user enable --now spaces@ubuntu
# Schakel uit dat je Space wordt gestart wanneer je gebruiker inlogt
systemctl --user disable --now spaces@ubuntu

# Stop je Space
sudo systemctl stop spaces@ubuntu
# Start je Space handmatig
sudo systemctl start spaces@ubuntu
# Herstart je Space
sudo systemctl restart spaces@ubuntu

# Bekijk het systemd-logboek van je Space
journalctl -u spaces@ubuntu

De homebestanden van Spaces verwijderen​

Spaces gebruikt een aparte homedirectory om systeemconfiguratie op te slaan die specifiek is voor je Spaces. Zo blijft de configuratie van applicaties gescheiden van je hostgegevens, waardoor conflicten worden voorkomen. Je bepaalt zelf welke mappen zichtbaar zijn in de Space.

Standaard blijven de homegegevens van je Space behouden wanneer je Spaces opnieuw maakt of verwijdert. Normaal gesproken hoef je de homegegevens van je Space nooit te wissen. Doe dit alleen als er verouderde configuratie in de home staat die je ook wilt verwijderen. Je kunt de optie --purge toevoegen aan spaces create/delete om de homegegevens van de Space te verwijderen.

# Maak een Space met een lege homedirectory of maak deze opnieuw
spaces create --purge <space>

# Verwijder een Space met de bijbehorende homegegevens en machtigingsconfiguratie
spaces delete --purge <space>

Je homegegevens op de host worden nooit gewijzigd wanneer je Spaces-opdrachten uitvoert.

GPG-sleutels gebruiken in Spaces​

GPG-sleutels gebruiken is niet erg intuïtief. Je moet eerst een GPG-sleutel maken in een terminal op de host. Vervolgens kun je die als volgt exporteren.

Eerst moet je je GPG-sleutels weergeven en hun ID's achterhalen. Laten we die van mij als voorbeeld nemen.

$ 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]

Dit is geen privé-informatie en, zoals je kunt zien, zijn de meeste commits in Anatase ondertekend met de bovenstaande sleutel.

Zodra je de sleutel-ID hebt, in dit geval 4DBB5595849C1C4EF1117688EF34000BBBE32D2A, exporteer je de openbare versie als een armor-bestand en importeer je die opnieuw in de Space die je wilt gebruiken. Bijvoorbeeld Fedora:

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

Nu kun je in de Space dezelfde opdracht uitvoeren om te controleren of het doorgeven van GPG werkt.

$ 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]

Je kunt het volgende toevoegen aan ~/.gitconfig in de homemap van je host om GPG-ondertekening voor je commits af te dwingen (~/.gitconfig wordt doorgegeven):

[commit]
gpgsign = true