Перейти к основному содержимому

Использование Spaces

Создание пространства​

Spaces проста в использовании. Чтобы воспользоваться Spaces, откройте терминал и введите arch, fedora, ubuntu или kali.

Эти команды являются псевдонимами для:

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

Если при выполнении spaces enter пространство не установлено, откроется диалог настройки. Чтобы позже снова открыть этот диалог и пересоздать пространство, введите:

spaces create <space>

Команда spaces create после установки позволяет пересоздать пространство, сохранив домашние данные пространства.

Spaces проведёт вас через диалог настройки разрешений, а затем предложит выбрать версии ОС (для Ubuntu и Fedora) и дополнительные компоненты (yay, Shelly для Arch).

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

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

Использование Spaces​

Открыть пространство можно командами ubuntu, fedora, arch и kali или базовой командой spaces enter <space>.

В пространстве можно выполнять привычные команды соответствующего дистрибутива, дословно следовать его документации — всё будет работать так же, как в этом дистрибутиве. О любых отличиях сообщайте как об ошибках в трекере проблем Anatase или в Discord.

Для разработки установите в пространстве предпочитаемую IDE. Например, можно воспользоваться инструкциями VS Code для Linux, чтобы установить её. Установка IDE в пространстве позволяет ей напрямую интегрировать свои терминалы, отладчик и команды запуска в этот дистрибутив. Можно установить IDE и в любые пространства, которые вы используете для разработки (например, и в Fedora, и в Ubuntu). Пожалуйста, не устанавливайте версии IDE в формате flatpak.

Spaces автоматически экспортирует ярлыки приложений, установленных вами, в основную среду рабочего стола. Также можно выбрать любое из этих приложений в качестве приложения по умолчанию.

к сведению

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

Изменение разрешений​

Чтобы изменить разрешения пространства после его создания, выполните:

spaces configure <space>

Снова откроется диалог разрешений, где можно внести любые изменения. После отправки настроек пространство завершит работу; изменения вступят в силу при следующем запуске.

Удаление пространства​

Если пространство занимает слишком много места, выполните:

spaces delete <space>

Запуск и остановка Spaces​

Spaces реализованы как обычные системные службы systemd со следующим синтаксисом: spaces@<space>. В Spaces также есть вариант службы --user, включённый по умолчанию для пользователя после создания пространства. Благодаря этому пространство запускается только при входе в систему, чтобы к моменту запуска служб ваши файлы уже были подключены. Вариант для пользователя лишь запускает системную службу. Кроме того, команда spaces enter <space> и её псевдонимы автоматически запускают пространство, если оно ещё не запущено.

Вот несколько команд для работы с Spaces:

# Включить запуск пространства при загрузке системы
# Так Tailscale будет работать ещё до входа в систему.
sudo systemctl enable --now spaces@ubuntu
# Отменить предыдущее включение
sudo systemctl disable --now spaces@ubuntu

# Включить запуск пространства при входе пользователя (по умолчанию)
systemctl --user enable --now spaces@ubuntu
# Отключить запуск пространства при входе пользователя
systemctl --user disable --now spaces@ubuntu

# Остановить пространство
sudo systemctl stop spaces@ubuntu
# Запустить пространство вручную
sudo systemctl start spaces@ubuntu
# Перезапустить пространство
sudo systemctl restart spaces@ubuntu

# Просмотреть журнал systemd для пространства
journalctl -u spaces@ubuntu

Удаление домашних файлов Spaces​

Spaces использует отдельный домашний каталог для хранения системных настроек, относящихся к вашим пространствам. Благодаря этому настройки приложений хранятся отдельно от данных хост-системы, что позволяет избежать конфликтов. Вы также можете контролировать, какие каталоги доступны в пространстве.

По умолчанию при пересоздании или удалении Spaces домашние данные пространства сохраняются. Как правило, очищать домашние данные пространства не требуется. Делайте это, только если в домашнем каталоге есть устаревшие настройки, которые вы хотите удалить. Чтобы удалить домашние данные пространства, добавьте --purge к команде spaces create/delete.

# Создать или пересоздать пространство с чистым домашним каталогом
spaces create --purge <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, — экспортируйте открытую часть в файл в формате ASCII Armor и импортируйте её в нужное пространство. Например, в Fedora:

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

Теперь можно выполнить ту же команду внутри пространства, чтобы проверить, что передача 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]

Чтобы принудительно подписывать коммиты с помощью GPG, добавьте следующий фрагмент в ~/.gitconfig в домашнем каталоге хост-системы (~/.gitconfig передаётся в пространство):

[commit]
gpgsign = true