Usando Spaces
Criando um Space
Spaces foi desenvolvido para ser fácil de usar. Para usar o Spaces,
abra um terminal e digite arch, fedora, ubuntu ou kali.
Esses comandos são aliases para:
spaces enter <space> # arch/fedora/ubuntu/kali
Ao executar spaces enter, se o Space não estiver instalado,
uma caixa de diálogo será aberta para você configurá-lo. Para abrir
essa caixa de diálogo novamente e recriar o Space, digite:
spaces create <space>
Digitar spaces create depois da instalação permite recriar o Space
mantendo os dados da pasta pessoal do Space.
O Spaces vai orientar você por uma caixa de diálogo de permissões e, por fim, permitir que selecione versões do sistema operacional (para Ubuntu e Fedora) e personalizações (yay e Shelly para Arch).
Há duas predefinições de permissões: basic, para aplicativos básicos
que não modificam as configurações do sistema, e development, que permite
instalar VPNs, Docker e máquinas virtuais, além de obter acesso direto a dispositivos.
Você também pode escolher custom e ajustar cada permissão individualmente.
Por padrão, o diretório ~/Downloads é montado no Spaces; nos Spaces de
desenvolvimento, ~/Projects também é adicionado para armazenar seu código.
Os Spaces de desenvolvimento também encaminham seu GPG, SSH, .gitconfig
(para seu nome e e-mail do Git), .ssh/config para seus hosts SSH, .bashrc
e .zshrc para as personalizações do terminal. No modo custom, você pode
montar qualquer diretório visível da pasta pessoal que quiser.
Seus outros arquivos, suas chaves SSH e suas chaves GPG permanecem privados, para que não possam ser exfiltrados; além disso, suas chaves são protegidas pelo SELinux. Por padrão, o Anatase configura seu agente SSH ao fazer login com as chaves id_rsa/id_ed25519. Você precisará adicionar manualmente as demais chaves ao agente SSH, embora seja recomendável usar apenas uma chave, que é a mesma que você também cadastra em serviços como Github.
Usando Spaces
Você pode abrir um Space com os comandos ubuntu, fedora, arch e kali
ou com o comando subjacente spaces enter <space>.
Dentro de um Space, você pode executar qualquer comando que esteja acostumado a usar na distribuição correspondente, seguir literalmente a documentação dessa distribuição e esperar que tudo funcione da mesma forma. Qualquer diferença deve ser relatada como bug no rastreador de problemas do Anatase ou no Discord.
Para desenvolvimento, instale o IDE de sua preferência em um Space. Por exemplo, você pode seguir as instruções para Linux do VS Code para instalá-lo. Instalar seu IDE em um Space permite que ele integre nativamente os terminais, o depurador e a execução de comandos à distribuição. Você também pode instalar IDEs em qualquer Space que use para desenvolvimento (por exemplo, tanto no Fedora quanto no Ubuntu). Não instale versões Flatpak de IDEs.
O Spaces exporta automaticamente os atalhos da área de trabalho de qualquer aplicativo que você instalar para o ambiente de trabalho principal, e você também pode escolher qualquer um deles como aplicativo padrão.
Um Space é instalado com o conjunto mínimo de pacotes necessário para que a
integração com a área de trabalho funcione. No entanto, os pacotes nem sempre
são perfeitos e, às vezes, deixam dependências de fora. Por exemplo, no Ubuntu,
a instalação do NordVPN requer libgtk-3-0 e libgles2, que não estão incluídos
nas dependências do pacote. Quando encontrar uma dependência ausente, anote-a
e crie um relatório de bug para começarmos a registrá-las. Você pode executar
o comando do pacote em um terminal para deduzir quais pacotes estão faltando
a partir dos erros (por exemplo, nordvpn-gui para o NordVPN) e instalar as
dependências ausentes até que ele funcione.
Modificando permissões
Para alterar as permissões do Space depois de criá-lo, execute:
spaces configure <space>
A caixa de diálogo de permissões será aberta novamente, e você poderá fazer quaisquer alterações. Ao confirmar a caixa de diálogo, o Space será desligado. Quando você o iniciar novamente, as alterações serão aplicadas.
Excluindo um Space
Se um Space estiver ocupando espaço demais, você pode executar:
spaces delete <space>
Iniciando e parando Spaces
Spaces são implementados como serviços systemd normais do sistema, com a seguinte
sintaxe: spaces@<space>. O Spaces também oferece uma variante de serviço --user,
ativada por padrão para seu usuário assim que você cria um Space. Dessa forma,
um Space só é iniciado quando você faz login, garantindo que seus arquivos estejam
montados quando seus serviços forem iniciados. A única função da variante de usuário
é iniciar o serviço do sistema. Além disso, spaces enter <space> e seus aliases
iniciam automaticamente o Space se ele ainda não estiver em execução.
Estes são alguns comandos que você pode usar com o Spaces:
# Ativa o Space para iniciar na inicialização do sistema
# Assim, o Tailscale funciona antes de você fazer login.
sudo systemctl enable --now spaces@ubuntu
# Desfaz a ativação anterior
sudo systemctl disable --now spaces@ubuntu
# Ativa a inicialização de um Space quando seu usuário faz login (padrão)
systemctl --user enable --now spaces@ubuntu
# Desativa a inicialização do Space quando seu usuário faz login
systemctl --user disable --now spaces@ubuntu
# Para seu Space
sudo systemctl stop spaces@ubuntu
# Inicia seu Space manualmente
sudo systemctl start spaces@ubuntu
# Reinicia seu Space
sudo systemctl restart spaces@ubuntu
# Exibe o journal do systemd do seu Space
journalctl -u spaces@ubuntu
Excluindo os arquivos da pasta pessoal do Spaces
O Spaces usa um diretório separado da pasta pessoal para armazenar configurações do sistema específicas dos seus Spaces. Assim, as configurações dos aplicativos ficam separadas dos dados do sistema anfitrião, evitando conflitos, e você pode controlar quais pastas são expostas no Space.
Por padrão, ao recriar ou excluir um Space, os dados da pasta pessoal do Space
são mantidos. Normalmente, você nunca deve precisar apagar os dados da pasta
pessoal do Space. Faça isso apenas se também quiser apagar configurações antigas
dessa pasta. Para excluir os dados da pasta pessoal do Space, você pode adicionar
--purge a spaces create/delete.
# Cria ou recria um Space com uma pasta pessoal nova
spaces create --purge <space>
# Exclui um Space, seus dados da pasta pessoal e a configuração de permissões
spaces delete --purge <space>
Os dados da pasta pessoal do sistema anfitrião nunca são modificados ao executar comandos do Spaces.
Usando chaves GPG no Spaces
Usar chaves GPG é um pouco confuso. Primeiro, você precisa criar uma chave GPG usando um terminal do sistema anfitrião. Depois, pode exportá-la da seguinte forma.
Primeiro, liste suas chaves GPG e obtenha os IDs. Vamos usar as minhas como exemplo.
$ gpg --list-secret-keys
sec ed25519 2024-07-31 [SC]
4DBB5595849C1C4EF1117688EF34000BBBE32D2A
ssb cv25519 2024-07-31 [E]
Essas informações não são privadas e, como você pode notar, a maioria dos commits no Anatase é assinada com a chave acima.
Depois de obter o ID da chave, neste caso 4DBB5595849C1C4EF1117688EF34000BBBE32D2A,
exporte a versão pública como um arquivo ASCII protegido e importe-a novamente
no Space que você quiser. Por exemplo, no Fedora:
gpg --armor --export 4DBB5595849C1C4EF1117688EF34000BBBE32D2A > ~/Projects/public.asc
fedora
gpg --import ~/Projects/public.asc
Agora, você pode executar o mesmo comando dentro do Space para verificar se o encaminhamento de GPG funciona.
$ gpg --list-secret-keys
[keyboxd]
---------
sec ed25519 2024-07-31 [SC]
4DBB5595849C1C4EF1117688EF34000BBBE32D2A
ssb cv25519 2024-07-31 [E]
Você pode adicionar o trecho a seguir a ~/.gitconfig na pasta pessoal do
sistema anfitrião para forçar a assinatura GPG dos seus commits (~/.gitconfig
é encaminhado):
[commit]
gpgsign = true