본문으로 건너뛰기

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의 홈 데이터를 유지하면서 Space를 재생성할 수 있습니다.

Spaces에서 권한 설정 대화상자를 안내하고, 마지막으로 OS 버전 (Ubuntu, Fedora의 경우)과 사용자 지정 항목(Arch의 경우 yay, Shelly)을 선택하게 됩니다.

권한 프리셋은 두 가지입니다. 시스템 설정을 변경하지 않는 기본 애플리케이션용 basic과 VPN, docker, VM을 설치하고 장치에 직접 접근할 수 있는 development입니다. 또는 custom을 선택해 각 권한을 세밀하게 조정할 수 있습니다. 기본적으로 ~/Downloads 디렉터리가 Spaces에 마운트되며, 개발용 Spaces에는 개발 코드를 저장할 수 있도록 ~/Projects도 추가됩니다. 개발용 Spaces는 GPG, SSH, .gitconfig (Git 이름과 이메일 설정용), SSH 호스트 설정 파일인 .ssh/config, 터미널 사용자 지정 설정인 .bashrc와 .zshrc도 전달합니다. custom 모드에서는 표시되는 홈 디렉터리를 원하는 대로 마운트할 수 있습니다.

나머지 파일과 SSH 키, GPG 키는 비공개로 유지되므로 외부로 유출될 수 없으며, 키는 SELinux로 추가 보호됩니다. 기본적으로 Anatase는 로그인할 때 id_rsa/id_ed25519 키를 사용해 SSH 에이전트를 설정합니다. 나머지 키는 SSH 에이전트에 직접 추가해야 합니다. 다만 Github 같은 서비스에 등록하는 키 하나만 사용하는 것을 권장합니다.

Spaces 사용하기​

ubuntu, fedora, arch, kali 명령이나 기본 명령인 spaces enter <space>를 사용해 Space를 열 수 있습니다.

Space에 들어가면 해당 배포판에서 익숙한 명령을 실행하고, 해당 배포판의 문서를 그대로 따라도 같은 방식으로 작동합니다. 차이가 있다면 Anatase 이슈 트래커나 Discord에 버그로 보고해 주세요.

개발하려면 Space에 원하는 IDE를 설치하세요. 예를 들어 VS Code의 Linux 설치 안내를 따라 설치할 수 있습니다. IDE를 Space에 설치하면 해당 배포판의 터미널, 디버거, 명령 실행 기능과 기본적으로 통합됩니다. 개발에 사용하는 여러 Spaces에 IDE를 설치할 수도 있습니다(예: Fedora와 Ubuntu 모두). IDE의 flatpak 버전은 설치하지 마세요.

Spaces는 설치한 애플리케이션의 데스크톱 바로 가기를 기본 데스크톱 환경으로 자동 내보내며, 이 가운데 원하는 앱을 기본 앱으로 선택할 수도 있습니다.

정보

Space에는 데스크톱 통합이 작동하는 데 필요한 최소 패키지가 설치됩니다. 하지만 패키지가 완벽하지 않아 종속 항목이 누락되는 경우가 있습니다. 예를 들어 Ubuntu에서 NordVPN을 설치하려면 libgtk-3-0과 libgles2가 필요하지만, 이 항목들은 종속성에 포함되어 있지 않습니다. 누락된 종속 항목을 발견하면 기록해 버그 보고서를 작성해 주세요. 그래야 누락된 항목을 모을 수 있습니다. 터미널에서 패키지 명령을 실행하고 오류를 살펴보면 누락된 패키지를 추정할 수 있습니다(예: NordVPN의 경우 nordvpn-gui). 프로그램이 실행될 때까지 누락된 종속 항목을 설치하면 됩니다.

권한 변경하기​

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

# Space의 systemd 저널 보기
journalctl -u spaces@ubuntu

Spaces 홈 파일 삭제하기​

Spaces는 Spaces에만 해당하는 시스템 설정을 저장하기 위해 별도의 홈 디렉터리를 사용합니다. 따라서 애플리케이션 설정이 호스트 데이터와 분리되어 충돌을 방지하고, Space에 노출되는 폴더를 직접 관리할 수 있습니다.

기본적으로 Spaces를 재생성하거나 삭제해도 Space의 홈 데이터는 유지됩니다. 일반적으로 Space의 홈 데이터를 삭제할 필요는 없습니다. 홈 디렉터리에 오래된 설정이 있어 함께 지우려는 경우에만 삭제하세요. Space의 홈 데이터를 삭제하려면 spaces create/delete 명령에 --purge를 추가하면 됩니다.

# 새 홈 디렉터리로 Space를 만들거나 재생성
spaces create --purge <space>

# 홈 데이터와 권한 설정을 함께 삭제
spaces delete --purge <space>

Spaces 명령을 실행해도 호스트의 홈 데이터는 수정되지 않습니다.

Spaces에서 GPG 키 사용하기​

GPG 키를 사용하는 방법은 조금 직관적이지 않습니다. 먼저 호스트 터미널에서 GPG 키를 만들어야 합니다. 그런 다음 다음과 같이 내보낼 수 있습니다.

먼저 GPG 키를 나열해 ID를 확인해야 합니다. 제 키를 예로 들어보겠습니다.

$ 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의 커밋 대부분은 위 키로 서명되어 있습니다.

이 경우처럼 키 ID가 4DBB5595849C1C4EF1117688EF34000BBBE32D2A라면, 공개 키를 아머 파일로 내보낸 뒤 사용하려는 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]

커밋에 GPG 서명을 강제하려면 호스트의 홈 폴더에 있는 ~/.gitconfig에 다음 내용을 추가할 수 있습니다(~/.gitconfig는 전달됩니다).

[commit]
gpgsign = true