Использование 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
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
ssb cv25519 2024-07-31 [E]
Чтобы принудительно подписывать коммиты с помощью GPG, добавьте следующий
фрагмент в ~/.gitconfig в домашнем каталоге хост-системы
(~/.gitconfig передаётся в пространство):
[commit]
gpgsign = true