メインコンテンツまでスキップ

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)を選択します。

権限プリセットは 2 種類あります。システム設定を変更しない基本的なアプリケーション向けの basic と、VPN、docker、VM のインストールやデバイスへの直接アクセスを許可する development です。代わりに custom を選択し、個々の権限を細かく調整することもできます。 デフォルトでは ~/Downloads ディレクトリが Spaces にマウントされ、 development Space では開発コードの保存先として ~/Projects も追加されます。 また、development Space では GPG、SSH、Git の名前とメールアドレスを設定する .gitconfig、 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 でバグとして報告してください。

開発には、使いたい IDE を Space にインストールしてください。たとえば、 VS Code の Linux 向け手順に従って インストールできます。IDE を Space にインストールすると、端末、デバッガー、 コマンドの実行機能をそのディストリビューションにネイティブに統合できます。 開発に使う各 Space(例:Fedora と Ubuntu の両方)に IDE をインストールすることもできます。 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>

# ホームデータと権限設定を含めて 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、 公開鍵を ASCII armor 形式のファイルとしてエクスポートし、使用する 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