Usando Spaces
Criar um Espaço
Spaces foi desenvolvido para ser simples 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 Espaço 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 Espaço, digite:
spaces create <space>
Executar spaces create após a instalação permite recriar o Espaço
mantendo os dados da pasta pessoal do seu Espaço.
Spaces guiará você por uma caixa de diálogo de permissões e, por fim, permitirá selecionar 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 aos dispositivos.
Você também pode escolher custom e ajustar cada permissão individualmente.
Por padrão, o diretório ~/Downloads é montado no Spaces,
e nos Spaces de desenvolvimento, ~/Projects é adicionado para armazenar seu
código de desenvolvimento. Os Spaces de desenvolvimento também encaminham suas chaves GPG e 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 sua pasta pessoal.
O restante dos seus arquivos, suas chaves SSH e suas chaves GPG permanecem privados, para que não possam ser exfiltrados, e suas chaves também são protegidas pelo SELinux. Por padrão, Anatase configura seu agente SSH ao fazer login, usando 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 também é a que você registra em serviços como Github.
Usar Spaces
Você pode abrir um Espaço usando os comandos ubuntu, fedora, arch e kali
ou o comando subjacente spaces enter <space>.
Dentro de um Espaço, você pode executar qualquer comando que já conhece na distribuição correspondente, seguir literalmente a documentação dessa distribuição e ter o mesmo funcionamento que nela. Qualquer divergência 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 Espaço. Por exemplo, você pode seguir as instruções para Linux do VS Code para instalá-lo. Instalar seu IDE em um Espaço permite integrar nativamente os terminais, o depurador e a execução de comandos àquela distribuição. Você também pode instalar IDEs em todos os Spaces que usa para desenvolvimento (por exemplo, tanto no Fedora quanto no Ubuntu). Não instale versões Flatpak de IDEs.
Spaces exporta automaticamente os atalhos de área de trabalho de quaisquer aplicativos que você instalar para seu ambiente de área de trabalho principal, e você também pode escolher qualquer um deles como aplicativo padrão.
Um Espaço é instalado com os pacotes mínimos necessários para que a integração com a área de trabalho
funcione. No entanto, os pacotes não são perfeitos e, às vezes,
faltam dependências. 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.
Quando encontrar uma dependência ausente, anote-a e crie um relatório de bug
para que possamos começar a catalogá-las. Você pode executar o comando do pacote
em um terminal para inferir quais pacotes estão faltando com base nos erros (por exemplo,
nordvpn-gui para o NordVPN) e instalar as dependências ausentes até que ele funcione.
Modificar permissões
Se quiser alterar as permissões do Espaço depois de criá-lo, você pode executar:
spaces configure <space>
A caixa de diálogo de permissões será aberta novamente e você poderá fazer as alterações que quiser. Ao confirmar a caixa de diálogo, o Espaço será encerrado e, quando você o iniciar novamente, as alterações serão aplicadas.
Excluir um Espaço
Se um Espaço estiver ocupando muito espaço, você pode executar:
spaces delete <space>
Iniciar e parar Spaces
Spaces são implementados como serviços systemd normais do sistema, com a seguinte
sintaxe: spaces@<space>. Spaces também oferece uma variante de serviço --user,
ativada por padrão para seu usuário quando você cria um Espaço. Assim,
um Espaço 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 Espaço se ele ainda não estiver em execução.
Veja alguns comandos que você pode usar com Spaces:
# Ativa o início do Espaço durante a 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 o início de um Espaço quando seu usuário fizer login (padrão)
systemctl --user enable --now spaces@ubuntu
# Desativa o início do Espaço quando seu usuário fizer login
systemctl --user disable --now spaces@ubuntu
# Para seu Espaço
sudo systemctl stop spaces@ubuntu
# Inicia seu Espaço manualmente
sudo systemctl start spaces@ubuntu
# Reinicia seu Espaço
sudo systemctl restart spaces@ubuntu
# Exibe o journal do systemd do seu Espaço
journalctl -u spaces@ubuntu
Excluir os arquivos da pasta pessoal de Spaces
Spaces usa um diretório pessoal separado 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 Espaço.
Por padrão, ao recriar ou excluir Spaces, os dados da pasta pessoal do Espaço
são mantidos. Em geral, você nunca precisará apagar os dados da pasta pessoal do seu Espaço.
Faça isso somente se também quiser apagar configurações obsoletas dessa pasta.
Para excluir os dados da pasta pessoal do Espaço, você pode acrescentar --purge a
spaces create/delete.
# Cria ou recria um Espaço com uma pasta pessoal vazia
spaces create --purge <space>
# Exclui um Espaço, 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.
Usar chaves GPG no Spaces
Usar chaves GPG é um pouco pouco intuitivo. Primeiro, você precisa criar uma chave GPG usando um terminal do sistema anfitrião. Depois, você pode exportá-la da seguinte forma.
Primeiro, você precisa listar suas chaves GPG e obter 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 observar, a maioria dos commits no Anatase é assinada pela chave acima.
Depois de obter o ID da chave, neste caso 4DBB5595849C1C4EF1117688EF34000BBBE32D2A,
exporte a versão pública como um arquivo ASCII com armadura e importe-a novamente no
Espaço desejado. 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 Espaço para verificar se o encaminhamento GPG funciona.
$ gpg --list-secret-keys
[keyboxd]
---------
sec ed25519 2024-07-31 [SC]
4DBB5595849C1C4EF1117688EF34000BBBE32D2A
ssb cv25519 2024-07-31 [E]
Você pode adicionar o seguinte a ~/.gitconfig na pasta pessoal do sistema anfitrião para
forçar a assinatura GPG dos seus commits (~/.gitconfig é encaminhado):
[commit]
gpgsign = true