CLI

typress バイナリは HTTP サーバとして起動するほか、admin と plugin-process の 2 つのサブコマンドモードを持ちます。admin はオペレータ向けの障害復旧 / 管理用です。

typress admin

typress admin reset-password <email>     # パスワード再設定 (TTY から入力)
typress admin list-users                  # 全ユーザー列挙
typress admin make-admin <email>          # admin ロールに昇格
typress admin totp-disable <email>        # TOTP 解除 (デバイス紛失時)
typress admin self-update <manifest-url>  # 署名付き更新

typress プロセスが実行中でも、これらのコマンドは別プロセスとして DB を直接開きます。SQLite WAL モードのおかげで競合は起きません。

self-update

TYPRESS_UPDATE_KEYS に登録した公開鍵で署名された JSON マニフェストを取得し、SHA-256 を再計算して一致した場合のみバイナリを atomic にスワップします。前のバイナリは ${TYPRESS_DATA_DIR}/typress.previous に残るので、ロールバックは mv 1 回で済みます。手順の詳細はアップグレードへ。

typress admin self-update https://example.com/typress/manifest.json

ロールバック手順:

sudo systemctl stop typress
sudo mv $TYPRESS_DATA_DIR/typress.previous /opt/typress/typress
sudo systemctl start typress