Przejdź do głównej zawartości

Korzystanie ze Spaces

Tworzenie Space​

Spaces zaprojektowano z myślą o prostocie obsługi. Aby użyć Spaces, otwórz terminal i wpisz arch, fedora, ubuntu lub kali.

Te polecenia są aliasami dla:

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

Jeśli podczas uruchamiania spaces enter Space nie jest zainstalowany, otworzy się okno dialogowe konfiguracji. Aby ponownie otworzyć to okno i odtworzyć Space, wpisz:

spaces create <space>

Wpisanie spaces create po instalacji pozwala odtworzyć Space z zachowaniem jego danych katalogu domowego.

Spaces przeprowadzi Cię przez okno dialogowe uprawnień, a następnie pozwoli wybrać wersję systemu operacyjnego (Ubuntu, Fedora) i dostosowania (yay, Shelly dla Arch).

Dostępne są dwa zestawy uprawnień: basic dla podstawowych aplikacji, które nie zmieniają ustawień systemowych, oraz development, który pozwala instalować VPN-y, Dockera i maszyny wirtualne, a także uzyskać bezpośredni dostęp do urządzeń. Możesz też wybrać custom i precyzyjnie dostosować każde uprawnienie. Domyślnie katalog ~/Downloads jest montowany w Spaces, a w Spaces w trybie development dodawany jest katalog ~/Projects, w którym możesz przechowywać kod. Spaces w trybie development udostępnia też Twoje klucze GPG i SSH, plik .gitconfig (z nazwą i adresem e-mail używanymi w Git), plik .ssh/config z konfiguracją hostów SSH, a także pliki .bashrc i .zshrc z ustawieniami terminala. W trybie custom możesz zamontować dowolny widoczny katalog domowy.

Pozostałe pliki, klucze SSH i klucze GPG pozostają prywatne, więc nie można ich wyprowadzić ze Space; dodatkowo klucze są chronione przez SELinux. Domyślnie Anatase konfiguruje agenta SSH przy logowaniu, korzystając z kluczy id_rsa/id_ed25519. Pozostałe klucze musisz ręcznie dodać do agenta SSH, choć zalecamy używanie tylko jednego klucza — tego, którego używasz także w usługach takich jak Github.

Korzystanie ze Spaces​

Możesz otworzyć Space poleceniami ubuntu, fedora, arch i kali lub podstawowym poleceniem spaces enter <space>.

W Space możesz uruchamiać dowolne polecenia znane z danej dystrybucji, postępować dokładnie według jej dokumentacji i oczekiwać, że wszystko będzie działać tak samo jak w tej dystrybucji. Wszelkie odstępstwa zgłaszaj jako błędy w systemie zgłoszeń Anatase lub na Discordzie.

Do programowania zainstaluj w Space wybrane środowisko IDE. Możesz na przykład skorzystać z instrukcji instalacji VS Code dla systemu Linux. Zainstalowanie IDE w Space pozwala mu natywnie integrować terminale, debugger i uruchamianie poleceń z daną dystrybucją. Możesz też zainstalować IDE w dowolnych Spaces używanych do programowania (np. zarówno w Fedorze, jak i Ubuntu). Nie instaluj wersji IDE z Flatpak.

Spaces automatycznie eksportuje skróty do aplikacji zainstalowanych w Spaces do głównego środowiska graficznego. Możesz też ustawić dowolną z tych aplikacji jako domyślną.

informacja

Space jest instalowany z minimalnym zestawem pakietów wymaganych do działania integracji ze środowiskiem graficznym. Pakiety nie są jednak doskonałe i czasem brakuje w nich zależności. Na przykład instalacja NordVPN w Ubuntu wymaga pakietów libgtk-3-0 i libgles2, których nie ma na liście jego zależności. Jeśli napotkasz brakującą zależność, zanotuj ją i utwórz zgłoszenie błędu, abyśmy mogli zacząć je zbierać. Możesz uruchomić polecenie instalacji pakietu w terminalu, aby na podstawie komunikatów o błędach ustalić brakujące pakiety (np. nordvpn-gui dla NordVPN), a następnie instalować brakujące zależności, aż program zacznie działać.

Zmiana uprawnień​

Aby zmienić uprawnienia Space po jego utworzeniu, uruchom:

spaces configure <space>

Ponownie otworzy się okno dialogowe uprawnień, w którym możesz wprowadzić dowolne zmiany. Po zatwierdzeniu zmian Space zostanie wyłączony. Zmiany zostaną zastosowane przy następnym uruchomieniu.

Usuwanie Space​

Jeśli Space zajmuje zbyt dużo miejsca, możesz uruchomić:

spaces delete <space>

Uruchamianie i zatrzymywanie Spaces​

Spaces są zaimplementowane jako zwykłe usługi systemd systemu o składni spaces@<space>. Spaces udostępnia też wariant usługi --user, domyślnie włączany dla użytkownika po utworzeniu Space. Dzięki temu Space uruchamia się dopiero po zalogowaniu, aby pliki były zamontowane przed uruchomieniem usług. Wariant użytkownika jedynie uruchamia usługę systemową. Ponadto spaces enter <space> i jego aliasy automatycznie uruchamiają Space, jeśli nie jest jeszcze uruchomiony.

Oto kilka poleceń, których możesz używać w Spaces:

# Włącz uruchamianie Space przy starcie systemu
# Dzięki temu Tailscale działa, zanim się zalogujesz.
sudo systemctl enable --now spaces@ubuntu
# Cofnij poprzednie włączenie
sudo systemctl disable --now spaces@ubuntu

# Włącz uruchamianie Space po zalogowaniu użytkownika (domyślnie)
systemctl --user enable --now spaces@ubuntu
# Wyłącz uruchamianie Space po zalogowaniu użytkownika
systemctl --user disable --now spaces@ubuntu

# Zatrzymaj Space
sudo systemctl stop spaces@ubuntu
# Uruchom Space ręcznie
sudo systemctl start spaces@ubuntu
# Uruchom ponownie Space
sudo systemctl restart spaces@ubuntu

# Wyświetl dziennik systemd dla Space
journalctl -u spaces@ubuntu

Usuwanie plików katalogu domowego Spaces​

Spaces używa osobnego katalogu domowego do przechowywania konfiguracji systemowej właściwej dla Spaces. Dzięki temu konfiguracja aplikacji jest oddzielona od danych hosta, co zapobiega konfliktom, a Ty możesz kontrolować, które foldery są udostępniane w Space.

Domyślnie podczas odtwarzania lub usuwania Spaces dane katalogu domowego Space są zachowywane. Zazwyczaj nie powinno być potrzeby usuwania danych katalogu domowego Space. Zrób to tylko wtedy, gdy chcesz również usunąć nieaktualną konfigurację z katalogu domowego. Aby usunąć dane katalogu domowego Space, dodaj --purge do polecenia spaces create/delete.

# Utwórz lub odtwórz Space z nowym katalogiem domowym
spaces create --purge <space>

# Usuń Space wraz z jego danymi katalogu domowego i konfiguracją uprawnień
spaces delete --purge <space>

Polecenia Spaces nigdy nie modyfikują danych katalogu domowego hosta.

Używanie kluczy GPG w Spaces​

Używanie kluczy GPG może być nieco nieintuicyjne. Najpierw utwórz klucz GPG w terminalu hosta. Następnie wyeksportuj go w następujący sposób.

Najpierw wyświetl klucze GPG i znajdź ich identyfikatory. Jako przykład posłuży mój klucz.

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

Nie są to informacje prywatne. Jak widać, większość commitów w Anatase jest podpisana powyższym kluczem.

Gdy znasz już identyfikator klucza, w tym przypadku 4DBB5595849C1C4EF1117688EF34000BBBE32D2A, wyeksportuj jego wersję publiczną do pliku armor, a następnie zaimportuj ją w wybranym Space. Na przykład w Fedorze:

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

Teraz możesz uruchomić to samo polecenie w Space, aby sprawdzić, czy przekazywanie kluczy GPG działa.

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

Możesz dodać poniższy wpis do pliku ~/.gitconfig w katalogu domowym hosta, aby wymusić podpisywanie commitów kluczem GPG (~/.gitconfig jest przekazywany do Space):

[commit]
gpgsign = true