Преминете към основното съдържание

Използване на Spaces

Създаване на Space​

Spaces е създаден така, че да се използва лесно. За да използвате Spaces, отворете терминал и въведете arch, fedora, ubuntu или kali.

Тези команди са псевдоними за:

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

При изпълнение на spaces enter, ако Space не е инсталиран, ще се отвори диалогов прозорец, в който да го настроите. За да отворите отново този диалогов прозорец и да създадете Space наново, въведете:

spaces create <space>

Изпълнението на spaces create след инсталирането ви позволява да създадете Space наново, като запазите данните в неговата домашна директория.

Spaces ще ви преведе през диалогов прозорец за разрешенията, а накрая ще трябва да изберете между версии на операционната система (за Ubuntu и Fedora) и персонализации (yay, Shelly за Arch).

Има два предварително зададени набора от разрешения: basic за обичайни приложения, които не променят системните настройки, и development, който ви позволява да инсталирате VPN-и, docker и виртуални машини, както и да получите директен достъп до устройства. Можете вместо това да изберете custom и да настроите всяко разрешение поотделно. По подразбиране директорията ви ~/Downloads е монтирана в Spaces, а в Spaces с набора development се добавя и ~/Projects, където да съхранявате кода си. Spaces с набора development също така препращат вашите GPG и SSH ключове, .gitconfig (с името и имейла ви за Git), .ssh/config за SSH хостовете ви, .bashrc и .zshrc за персонализациите на терминала ви. В режим custom можете да монтирате всяка достъпна директория от домашната си папка.

Останалите ви файлове, SSH ключовете и GPG ключовете остават поверителни, така че не могат да бъдат изнесени; освен това ключовете ви са защитени и от SELinux. По подразбиране Anatase настройва вашия SSH агент при влизане с ключовете id_rsa/id_ed25519. Ще трябва ръчно да добавите останалите си ключове към SSH агента, макар че се препоръчва да използвате само един ключ — този, който регистрирате и в услуги като Github.

Използване на Spaces​

Можете да отворите Space с командите ubuntu, fedora, arch и kali или с основната команда spaces enter <space>.

След като влезете в Space, можете да изпълнявате обичайните за съответната дистрибуция команди, да следвате дословно документацията ѝ и всичко да работи по същия начин като в тази дистрибуция. За всички отклонения съобщавайте като за грешки в системата за проследяване на проблеми на Anatase или в Discord.

За разработка инсталирайте избраната от вас IDE в даден Space. Например, можете да следвате инструкциите за Linux на VS Code, за да я инсталирате. Когато инсталирате IDE в Space, нейните терминали, инструментът за отстраняване на грешки и командите за стартиране се интегрират директно с тази дистрибуция. Можете да инсталирате IDE и във всеки от Spaces, които използвате за разработка (например и във Fedora, и в Ubuntu). Моля, не инсталирайте IDE версии от Flatpak.

Spaces автоматично експортира преките пътища на работния плот за всички приложения, които инсталирате, към основната ви работна среда. Можете също да изберете някое от тях като приложение по подразбиране.

Информация

Space се инсталира с минималния набор от пакети, необходим за работата на интеграцията с работния плот. Пакетите обаче не са съвършени и понякога им липсват зависимости. Например, в Ubuntu инсталирането на NordVPN изисква libgtk-3-0 и libgles2, които не са включени сред зависимостите му. Когато попаднете на липсваща зависимост, запишете я и създайте доклад за грешка, за да можем да започнем да ги събираме. Можете да изпълните командата на пакета в терминал и да установите липсващите пакети по съобщенията за грешки (например nordvpn-gui за NordVPN), след което да инсталирате липсващите зависимости, докато програмата заработи.

Промяна на разрешенията​

Ако искате да промените разрешенията на Space след създаването му, изпълнете:

spaces configure <space>

Диалоговият прозорец за разрешенията ще се отвори отново и ще можете да правите произволни промени. След като потвърдите избора си, Space ще се изключи. Когато го стартирате отново, промените ще влязат в сила.

Изтриване на Space​

Ако Space заема твърде много място, можете да изпълните:

spaces delete <space>

Стартиране и спиране на Spaces​

Spaces са реализирани като обикновени системни услуги на systemd със следния синтаксис: spaces@<space>. Spaces предоставя и вариант на услугата --user, който се активира по подразбиране за потребителя ви след създаването на Space. Така Space се стартира едва когато влезете в системата, за да се уверите, че файловете ви са монтирани, когато услугите ви се стартират. Вариантът за потребителя само стартира системната услуга. Освен това spaces enter <space> и неговите псевдоними автоматично стартират Space, ако още не е стартиран.

Ето някои команди, които можете да използвате със Spaces:

# Активирайте стартирането на Space при зареждане на системата
# Така Tailscale ще работи, преди да влезете.
sudo systemctl enable --now spaces@ubuntu
# Отменете предишното активиране
sudo systemctl disable --now spaces@ubuntu

# Активирайте стартирането на Space при влизане на потребителя (по подразбиране)
systemctl --user enable --now spaces@ubuntu
# Деактивирайте стартирането на Space при влизане на потребителя
systemctl --user disable --now spaces@ubuntu

# Спрете Space
sudo systemctl stop spaces@ubuntu
# Стартирайте Space ръчно
sudo systemctl start spaces@ubuntu
# Рестартирайте Space
sudo systemctl restart spaces@ubuntu

# Прегледайте журнала на systemd за Space
journalctl -u spaces@ubuntu

Изтриване на домашните файлове на Spaces​

Spaces използва отделна домашна директория за съхранение на системните настройки, специфични за вашите Spaces. Така настройките на приложенията се пазят отделно от данните на хост системата, което предотвратява конфликти, а вие можете да контролирате кои папки се предоставят на Space.

По подразбиране данните в домашната директория на Space се запазват при повторно създаване или изтриване на Spaces. Обикновено не би трябвало да се налага да изтривате данните от домашната директория на Space. Правете го само ако искате да изтриете и остарели настройки от домашната директория. За да изтриете данните от домашната директория на Space, добавете --purge към spaces create/delete.

# Създайте или създайте наново Space с празна домашна директория
spaces create --purge <space>

# Изтрийте Space заедно с данните от домашната му директория и настройките на разрешенията
spaces delete --purge <space>

Командите на Spaces никога не променят данните в домашната директория на хост системата.

Използване на GPG ключове в Spaces​

Използването на GPG ключове е малко неинтуитивно. Първо трябва да създадете GPG ключ в терминал на хост системата. След това можете да го експортирате така.

Първо трябва да изведете списък с GPG ключовете си и да намерите идентификаторите им. Нека използваме моя ключ като пример.

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

Това не е поверителна информация и, както можете да видите, повечето комити в Anatase са подписани с горния ключ.

След като разполагате с идентификатора на ключа си — в този случай 4DBB5595849C1C4EF1117688EF34000BBBE32D2A — експортирайте публичната му версия във файл във формат armor и я импортирайте в желания Space. Например във Fedora:

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

Сега можете да изпълните същата команда в Space, за да проверите дали препращането на GPG работи.

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

Можете да добавите следното в ~/.gitconfig в домашната директория на хост системата, за да принудите подписването на комитите си с GPG (~/.gitconfig се препраща):

[commit]
gpgsign = true