Rediacc CLIリファレンス
概要
**Rediacc CLI**（`rdc`）は、Rediaccプラットフォームのすべての側面を管理するためのコマンドラインインターフェースです — 認証、インフラストラクチャ、リポジトリ、キュー、ストレージなど。
インストール
[Rediaccリリースページ](https://www.rediacc.com)からプラットフォーム用の最新バイナリをダウンロードするか、パッケージマネージャーでインストールしてください：
# macOS / Linux
curl -fsSL https://www.rediacc.com | sh
# Or use the packaged binary directly
./rdc --helpグローバルオプション
すべてのコマンドはこれらのグローバルフラグをサポートしています：
| フラグ | 説明 |
|---|---|
--output | 出力形式 (table|json|yaml|csv)。REDIACC_DEFAULT_OUTPUT でデフォルトを上書きします。 |
--config | このコマンドに特定の設定を使用する |
--lang | 言語オーバーライド ({{languages}}) |
--force | 確認プロンプトをスキップする |
1. エージェントユーティリティ
AIコーディングアシスタント向けのエージェントユーティリティ
1.1 capabilities
利用可能なすべてのコマンドと引数・オプションをリスト表示する
rdc agent capabilities1.2 schema
特定のコマンドの詳細なスキーマを表示する
rdc agent schema [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--command <path> | インタラクティブシェルの代わりにコマンドを実行する | はい | - |
1.3 exec
stdin からの JSON 入力でコマンドを実行する
rdc agent exec [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--command <path> | インタラクティブシェルの代わりにコマンドを実行する | はい | - |
1.4 generate-reference
Claude スキル用のコマンドリファレンス Markdown を生成
rdc agent generate-reference2. 設定管理
設定ファイル、マシン、SSH 接続を管理する
設定ファイルには接続の詳細（API URL、認証情報、デフォルトのチーム/リージョン/ブリッジ）が保存されており、環境間を素早く切り替えることができます。
2.1 prune
~/.config/rediacc/<config>.json にあるローカル設定ファイルから不要な要素を削除します。3つのバケットがクリーンアップされ、すべて純粋にローカルです（SSH/renet 呼び出しなし）：(1) アンカー GUID/repo/machine がアクティブな設定にない ACME 証明書キャッシュエントリ；(2) 猶予期間が経過したアーカイブ済みリポジトリ（デフォルト 7 日、defaults.pruneGraceDays 参照）；(3) ぶら下がりクロスリファレンス（machine→strategy、strategy→repo）。使用中のリソース、認証情報、ストレージトークン、known-hosts は触れません。デフォルトでは変更が適用されます；--dry-run でプレビューのみ。
rdc config prune [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--dry-run | 設定ファイルを変更せずに削除される内容をプレビューします。他の prune コマンドのデフォルトオフセマンティクスを反映します。 | いいえ | - |
--certs-only | ACME 証明書キャッシュバケットに制限します。アーカイブのパージとクロスリファレンスのクリーンアップをスキップします。--archives-only および --refs-only と相互排他的。 | いいえ | - |
--archives-only | 期限切れアーカイブのパージに制限します。証明書キャッシュとクロスリファレンスのクリーンアップをスキップします。--certs-only および --refs-only と排他的。 | いいえ | - |
--refs-only | ぶら下がりクロスリファレンス（machine→strategy、strategy→repo excludes/includes）に制限します。証明書キャッシュとアーカイブをスキップします。--certs-only および --archives-only と排他的。 | いいえ | - |
--purge-archived | 年齢に関係なく、猶予期間を過ぎたもののみではなくすべてのアーカイブ済みリポジトリを破棄します。'rdc config repository purge-archived' を実行することと同等です。復元のために保存された認証情報のいずれも不要であることが確実な場合のみ使用してください。 | いいえ | - |
--grace-days <days> | この呼び出しのアーカイブ猶予期間（日数）を上書きします。設定の defaults.pruneGraceDays にフォールバックし、どちらも設定されていない場合は 7 にフォールバックします。 | いいえ | - |
2.2 init
新しい名前付き設定ファイルを作成する
ローカルモードでは、マシンを直接追加できます:
rdc config init [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
--ssh-key <path> | SSH 秘密鍵へのパス (例: ~/.ssh/id_rsa) | いいえ | - |
--renet-path <path> | renet バイナリへのパス (デフォルト: PATH の renet) | いいえ | - |
--master-password <password> | マスターパスワードでリソースを暗号化する | いいえ | - |
-u, --api-url <url> | API の URL | いいえ | - |
--server <url> | アカウントサーバーURL | いいえ | - |
2.3 list
すべての設定ファイルをリスト表示する
rdc config list2.4 show
現在の設定の詳細を表示する
rdc config show [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--reveal | 機密値を平文で表示（対話モードのみ） | いいえ | - |
2.5 delete
設定ファイルを削除する
rdc config delete [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
2.6 set
デフォルト値を設定する (team、region、bridge)
rdc config set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--key <key> | 設定キー | はい | - |
--value <value> | 設定値 | はい | - |
ヒント: デフォルトを設定しておくと、コマンドごとに `--team`、`--region`、`--bridge` を指定する必要がなくなります。
2.7 clear
デフォルト値をクリアする（すべてまたは特定のキー）
rdc config clear [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--key <key> | 設定キー | いいえ | - |
2.8 recover
バックアップファイル (.bak) から設定を復元する
rdc config recover [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-y, --yes | 確認プロンプトをスキップする | いいえ | - |
2.9 ssh
SSH キーの設定を管理する
set
現在の設定に SSH キーを設定する
rdc config ssh set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--key <path> | SSH 秘密キーファイルのパス | はい | - |
--embed | パスを保存する代わりにキーの内容を設定に埋め込む | いいえ | - |
show
現在の SSH キー設定を表示する
rdc config ssh showremove
現在の設定から SSH キーを削除する
rdc config ssh remove2.10 remote
リモート設定ストレージ接続を管理
enable
この設定をリモート暗号化ストレージにリンク
rdc config remote enable [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--headless | デバイスコードフローを使用（ヘッドレスサーバー用） | いいえ | - |
--api-url <url> | アカウントサーバーURL | いいえ | - |
disable
リモートストレージから切断し、設定をローカルに保存
rdc config remote disablestatus
リモート接続状態を表示
rdc config remote statusrefresh
リモートストレージから設定を強制再取得
rdc config remote refresh2.11 machine
現在の設定のマシンを管理する
add
現在の設定にマシンを追加
rdc config machine add [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--ip <address> | マシン IP アドレスまたはホスト名 | はい | - |
--user <username> | SSH ユーザー名 | はい | - |
--port <port> | SSH ポート | いいえ | 22 |
--datastore <path> | マシン上のデータストアパス | いいえ | /mnt/rediacc |
remove
現在の設定からマシンを削除する
rdc config machine remove [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
list
現在の設定のマシンをリスト表示する
rdc config machine listscan-keys
現在の設定のマシンの SSH ホストキーをスキャンする
rdc config machine scan-keys [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | いいえ | - |
setup
リモートマシンをリポジトリ用にプロビジョニング（renetインストール、Docker設定、BTRFSデータストア）。冪等。config machine addの後、repo createの前に必要
rdc config machine setup [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--datastore <path> | リモートマシン上のデータストアパス | いいえ | /mnt/rediacc |
--datastore-size <size> | データストアサイズ（例: 95%、100G） | いいえ | 95% |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
set-ceph
マシンの Ceph RBD 設定を行う
rdc config machine set-ceph [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--pool <name> | Ceph プール名（例: rbd） | はい | - |
--image <name> | RBD イメージ名（例: datastore-prod1） | はい | - |
--cluster <name> | Ceph クラスター名 | いいえ | ceph |
2.12 repository
現在の設定のリポジトリマッピングを管理する
add
現在の設定にリポジトリ GUID マッピングを追加する
rdc config repository add [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--guid <guid> | リポジトリ GUID（ストレージバックアップファイル名の UUID） | はい | - |
--tag <tag> | リポジトリタグ | いいえ | latest |
--credential <credential> | リポジトリ資格情報（暗号化パスフレーズ） | いいえ | - |
--network-id <id> | Docker 分離用のネットワーク ID（2816, 2880, ...）。省略時は自動割り当て | いいえ | - |
remove
現在の設定からリポジトリマッピングを削除する
rdc config repository remove [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
list
現在の設定のリポジトリ GUID マッピングをリスト表示する
rdc config repository listlist-archived
アーカイブ済みリポジトリ資格情報をリスト表示する
rdc config repository list-archivedrestore-archived
アーカイブ済みリポジトリ資格情報を復元する
rdc config repository restore-archived [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--new-name <name> | 新しいリソース名 | いいえ | - |
purge-archived
アーカイブ済み資格情報をすべて完全に削除する
rdc config repository purge-archived2.13 provider
自動マシンプロビジョニング用クラウドプロバイダーを管理する
add
クラウドプロバイダーを追加する
rdc config provider add [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--provider <source> | 既知のプロバイダーソース（例: linode/linode, hetznercloud/hcloud） | いいえ | - |
--source <source> | カスタム OpenTofu プロバイダーソース（例: vultr/vultr） | いいえ | - |
--token <token> | クラウドプロバイダーの API トークン | はい | - |
--region <region> | 新規マシンのデフォルトリージョン | いいえ | - |
--type <type> | デフォルトのインスタンスタイプ/サイズ | いいえ | - |
--image <image> | デフォルトの OS イメージ | いいえ | - |
--ssh-user <user> | 新規 VM 用の SSH ユーザー名（デフォルト: root） | いいえ | - |
--resource <type> | カスタム: VM 用の OpenTofu リソースタイプ | いいえ | - |
--label-attr <attr> | カスタム: VM ラベルの属性名 | いいえ | - |
--region-attr <attr> | カスタム: リージョンの属性名 | いいえ | - |
--size-attr <attr> | カスタム: インスタンスタイプの属性名 | いいえ | - |
--image-attr <attr> | カスタム: OS イメージの属性名 | いいえ | - |
--ipv4-output <attr> | カスタム: IPv4 アドレスの出力属性 | いいえ | - |
--ipv6-output <attr> | カスタム: IPv6 アドレスの出力属性 | いいえ | - |
--ssh-key-attr <attr> | カスタム: SSH キーの属性名 | いいえ | - |
--ssh-key-format <format> | カスタム: SSH キーの形式（inline_list または resource_id） | いいえ | - |
--ssh-key-resource <type> | カスタム: SSH キー用の OpenTofu リソースタイプ | いいえ | - |
remove
クラウドプロバイダー設定を削除する
rdc config provider remove [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
list
設定済みクラウドプロバイダーをリスト表示する
rdc config provider list2.14 storage
現在の設定のストレージバックエンドを管理する
import
rclone 設定ファイルからストレージをインポートする
rdc config storage import [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--file <path> | ファイルパス | はい | - |
--name <name> | 指定したセクションのみインポートする | いいえ | - |
remove
現在の設定からストレージを削除する
rdc config storage remove [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
list
現在の設定のストレージをリスト表示する
rdc config storage list2.15 infra
インフラ設定を管理する（プロキシ、DNS、証明書）
set
マシンのインフラ設定を行います（マシン固有: IP、ドメイン、ポート；共有: 証明書メール、CF DNS トークン）
rdc config infra set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--public-ipv4 <ip> | パブリック IPv4 アドレス（マシンごと） | いいえ | - |
--public-ipv6 <ip> | パブリック IPv6 アドレス（マシンごと） | いいえ | - |
--base-domain <domain> | アプリケーション用ベースドメイン（マシンごと） | いいえ | - |
--cert-email <email> | TLS 証明書通知用メールアドレス（マシン間で共有） | いいえ | - |
--cf-dns-token <token> | ACME DNS-01 チャレンジ用 Cloudflare DNS API トークン（マシン間で共有） | いいえ | - |
--tcp-ports <ports> | 転送する TCP ポート（カンマ区切り、例: 25,143,465） | いいえ | - |
--udp-ports <ports> | 転送する UDP ポート（カンマ区切り、例: 53） | いいえ | - |
show
マシンのインフラ設定を表示する
rdc config infra show [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
push
インフラ設定をマシンにプッシュします（Traefik プロキシ、ルーター、Cloudflare DNS）。先に 'config infra set <machine>' を実行してください
rdc config infra push [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
2.16 cert-cache
キャッシュされたTLS証明書を管理
pull
マシンからTLS証明書をダウンロードしてキャッシュ
rdc config cert-cache pull [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--no-prune | 古いネットワークID証明書の整理をスキップ | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
push
キャッシュされたTLS証明書をマシンにアップロード
rdc config cert-cache push [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
status
キャッシュされた証明書のインベントリを表示
rdc config cert-cache statusclear
証明書キャッシュを削除
rdc config cert-cache clear2.17 field
ポインタ指定による設定フィールド操作(get/set/unset/rotate/list)。/credentials/cfDnsApiToken のような JSON Pointer(RFC 6901)を使用します。
get
JSON ポインタで単一の設定値を読み取ります。機密フィールドは --reveal を指定しない限り秘匿されます(人間のみ)。
rdc config field get [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--pointer <pointer> | フィールドへのJSONポインタ（例: /credentials/cfDnsApiToken） | はい | - |
--reveal | 機密値を平文で表示する(対話型 TTY のみ、監査ログに記録) | いいえ | - |
--digest | 値の代わりに SHA-256 ダイジェストを出力(エージェントに共有しても安全) | いいえ | - |
set
JSON ポインタ位置に設定値を書き込みます。機密パスには --current(知識ゲート)が必要です。
rdc config field set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--pointer <pointer> | フィールドへのJSONポインタ（例: /credentials/cfDnsApiToken） | はい | - |
--new <value> | 新しい値({, [, ", true/false/null, 数値で始まる場合は JSON として解釈) | はい | - |
--current <value> | 現在の平文値 — 機密パスの変更に必須(知識ゲート証明) | いいえ | - |
unset
JSON ポインタ位置の設定値を削除。機密パスには --current が必要です。
rdc config field unset [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--pointer <pointer> | フィールドへのJSONポインタ（例: /credentials/cfDnsApiToken） | はい | - |
--current <value> | 現在の平文値 — 機密パスの削除に必須 | いいえ | - |
rotate
--current なしで機密値をローテーションします。対話型 TTY のみ、詳細に監査されます。
rdc config field rotate [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--pointer <pointer> | 機密フィールドへのJSONポインタ（例: /credentials/cfDnsApiToken） | はい | - |
--new <value> | 新しい値 | はい | - |
list
登録済みのすべてのセンシティビティ・ポインタ・テンプレートと種類、commit/encrypt ポリシーを一覧表示。
rdc config field list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--sensitive | 機密(非パブリック)テンプレートのみ表示 | いいえ | - |
2.18 edit
アクティブな設定を秘匿された JSONC プロジェクションとして $EDITOR で開きます。人間のみ、エージェントは拒否されます。
rdc config edit [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--reveal | 機密値を平文で表示する(対話型 TTY のみ、監査ログに記録) | いいえ | - |
--dump | エディタを開かず、現在の設定を JSONC として stdout に出力(読み取り専用。秘匿時はエージェントでも安全) | いいえ | - |
--apply <file> | 編集済み JSONC ファイルを適用($EDITOR 起動をスキップ) | いいえ | - |
--current-secrets <file> | ポインタ → 旧平文 のマップ JSON ファイル。--apply 時の知識ゲート用 | いいえ | - |
--editor <cmd> | エディタ コマンドの上書き(git と同じ優先順位: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR) | いいえ | - |
2.19 audit
設定監査ログを確認(~/.config/rediacc/audit.log.jsonl のハッシュチェーン JSONL)
log
最近の監査エントリを JSON として出力
rdc config audit log [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--since <spec> | 指定より新しいエントリのみ表示(例: '24h', '7d', ISO タイムスタンプ) | いいえ | - |
--path <glob> | JSON Pointer グロブでフィルタ(例: /credentials/*) | いいえ | - |
--actor <kind> | アクターの種類でフィルタ(human|agent) | いいえ | - |
tail
新しいエントリを書き込まれた順にストリーム(Ctrl+C で停止)
rdc config audit tailverify
すべての監査エントリにおける SHA-256 ハッシュチェーンの整合性を検証
rdc config audit verify2.20 backup-strategy
名前付きバックアップ戦略を管理（ホット/コールドモード、宛先、スケジュール）
set
バックアップ戦略を作成または更新
rdc config backup-strategy set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | 戦略名（必須） | はい | - |
--destination <name> | 戦略内の宛先名 | いいえ | - |
--storage <name> | ストレージ設定名（rclone資格情報） | いいえ | - |
--cron <expression> | cronスケジュール（例: "0 * * * *" で毎時実行） | いいえ | - |
--mode <mode> | バックアップモード: "hot"（ダウンタイムなし）または "cold"（停止、スナップショット、再起動） | いいえ | - |
--bwlimit <limit> | rclone帯域幅制限（例: "6M"、"10M:off"、"08:00,3M;22:00,10M"） | いいえ | - |
--include <repos> | これらのリポジトリのみバックアップ（カンマ区切りの名前） | いいえ | - |
--exclude <repos> | これらのリポジトリをバックアップから除外（カンマ区切りの名前） | いいえ | - |
--folder <path> | この宛先のストレージバケット内のサブフォルダー（例: hot, cold） | いいえ | - |
--enable | 戦略または宛先を有効にする | いいえ | - |
--disable | 戦略または宛先を無効にする | いいえ | - |
remove
バックアップ戦略または宛先を削除
rdc config backup-strategy remove [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | 戦略名（必須） | はい | - |
--destination <name> | この宛先のみ削除（他の宛先は保持） | いいえ | - |
list
すべてのバックアップ戦略を一覧表示
rdc config backup-strategy listshow
バックアップ戦略の詳細を表示
rdc config backup-strategy show [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | 戦略名（省略時はすべて表示） | いいえ | - |
3. データストア管理
Ceph RBDデータストアのライフサイクルを管理（init、fork、unfork、status）
3.1 resize
マシンのデータストアプールをオフラインでリサイズします（拡張または縮小）。先にすべてのリポジトリをアンマウントしてください。
rdc datastore resize [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名（Cephデータストアがホストされている場所） | はい | - |
--size <size> | 新しいデータストアサイズ（例: 100G, 95%） | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
3.2 init
マシン上でデータストアを初期化（ローカルまたはCeph RBD）
rdc datastore init [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名（Cephデータストアがホストされている場所） | はい | - |
--size <size> | データストアサイズ（例: 5G, 50G, 100G） | はい | - |
--backend <type> | バックエンドタイプ: local（デフォルト）またはceph | いいえ | local |
--pool <name> | Cephプール名（デフォルト: マシン設定から、またはrbd） | いいえ | rbd |
--image <name> | Ceph RBDイメージ名（デフォルト: set-cephによるマシン設定から） | いいえ | - |
--cluster <name> | Cephクラスター名（デフォルト: ceph） | いいえ | ceph |
--force | データストアが既に存在していても強制的に初期化する（警告: ストレージを再フォーマットします） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
3.3 fork
RBDスナップショット+クローンを使用してCephデータストアのローカルCOWコピーを作成（2秒未満）。unforkのために出力からスナップショット/クローン名を保存してください。ターゲット名ごとに1つのforkのみ。再forkする前にunforkしてください
rdc datastore fork [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名（Cephデータストアがホストされている場所） | はい | - |
--to <name> | クローンサフィックス（<image>-fork-<name>という名前のクローンを作成）。forkはソースマシンに残ります | はい | - |
--cow-size <size> | COWバッキングファイルサイズ（デフォルト: auto、必要に応じて拡張） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
3.4 unfork
forkのクリーンアップ: COWのアンマウント、クローンの削除、スナップショットの削除
rdc datastore unfork [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名（Cephデータストアがホストされている場所） | はい | - |
--source <image> | フォークされた元のRBDイメージ（config set-ceph --imageから、例: ds-prod） | はい | - |
--snapshot <name> | 削除するスナップショット（fork出力の"Snapshot:"値、例: fork-<timestamp>） | はい | - |
--dest <image> | 削除するクローンイメージ（fork出力の"Clone:"値、例: ds-prod-fork-<machine>） | はい | - |
--pool <name> | Cephプール名（デフォルト: マシン設定から） | いいえ | - |
--mount-point <path> | アンマウントするforkマウントポイント（デフォルト: /mnt/rediacc） | いいえ | - |
--force | 個々のステップが失敗しても（例：アンマウント、スナップショット削除）クリーンアップを続行する | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
3.5 status
データストアのバックエンド、サイズ、使用量、マウント状態、cow_mode（フォーク時）を表示
rdc datastore status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名（Cephデータストアがホストされている場所） | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
4. マシン管理
リモートマシンの管理 (ステータス、コンテナ、サービス、ヘルス)
4.1 list
マシンをリスト表示する
rdc machine list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
--search <text> | {{field}}で検索 | いいえ | - |
--sort <field> | フィールドで並び替え | いいえ | - |
--desc | 降順で並び替え | いいえ | - |
4.2 create
新しいマシンを作成する
rdc machine create [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
-b, --bridge <name> | ブリッジ名 | いいえ | - |
--vault <json> | JSON 文字列としてのマシンボルトデータ | いいえ | - |
4.3 rename
マシンの名前を変更
rdc machine rename [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--current-name <name> | 現在のリソース名 | はい | - |
--new-name <name> | 新しいリソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
4.4 delete
マシンを削除する
rdc machine delete [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
-f, --force | 確認プロンプトをスキップする | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
4.5 vault
マシン Vault 管理 (クラウドアダプターのみ)
rdc machine vault4.6 vault-status
{{t:cli.commands.machine.vault-status.description}}
rdc machine vault-status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
4.7 health
CI/CDパイプライン用のマシン健全性を確認する
healthコマンドはシステムメトリクス、コンテナステータス、サービス安定性、ストレージ情報を出力します — CI/CDパイプラインチェックに便利です。
rdc machine health [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
4.8 containers
マシン上の実行中コンテナを一覧表示する
rdc machine containers [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
--health-check | 健全性チェックモード - 不健全なものがある場合はコード2で終了します | いいえ | - |
4.9 services
マシン上のsystemdサービスをリスト表示する
rdc machine services [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
--stability-check | 安定性チェックモード - 失敗/再起動中のものがある場合はコード2で終了します | いいえ | - |
4.10 query
マシンの完全なステータスを表示（システム、リポジトリ、コンテナ、サービス）
rdc machine query [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--system | システム情報のみを含める | いいえ | - |
--repositories | リポジトリのみを含める | いいえ | - |
--containers | コンテナのみを含める | いいえ | - |
--services | サービスのみを含める | いいえ | - |
--network | ネットワークインターフェースのみを含める | いいえ | - |
--block-devices | ブロックデバイスのみを含める | いいえ | - |
--licenses | リポジトリのライセンス状態を含める | いいえ | - |
--storage-health | リポジトリごとのBTRFSフラグメンテーションとreflink節約量を表示 | いいえ | - |
--sync-certs | クエリ後にマシンから ACME 証明書キャッシュも取得します | いいえ | - |
--strict | いずれかのコンテナがヘルスドリフトしきい値を超えた場合、ゼロ以外（コード 2）で終了します | いいえ | - |
4.11 vault-status
マシンの解析されたボルトステータスを表示する
rdc machine vault-status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
4.12 repos
マシンにデプロイされたリポジトリをリスト表示する
rdc machine repos [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
--search <text> | リポジトリ名でフィルター | いいえ | - |
4.13 test-connection
マシンへの SSH 接続をテストしてホストキーをキャプチャする
rdc machine test-connection [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--ip <address> | マシン IP アドレスまたはホスト名 | はい | - |
--user <name> | SSH ユーザー名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
-b, --bridge <name> | ブリッジ名 | いいえ | - |
--port <number> | SSH ポート | いいえ | 22 |
--password <pwd> | 初期認証用の SSH パスワード | いいえ | - |
--datastore <path> | マシン上のデータストアパス | いいえ | /mnt/rediacc |
-m, --machine <name> | マシン名 (テスト後にボルトを更新) | いいえ | - |
--save | テスト成功後にマシンボルトに known_hosts を保存する | いいえ | - |
ヒント: テスト成功後にホストキーをマシンvaultに自動的に永続化するには、`--save`を使用してください。
4.14 provision
OpenTofuを使用してクラウドプロバイダーに新しいマシンをプロビジョニングする
rdc machine provision [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--provider <name> | クラウドプロバイダー名（config provider addから） | はい | - |
--region <region> | デフォルトリージョンを上書き | いいえ | - |
--type <type> | デフォルトインスタンスタイプを上書き | いいえ | - |
--image <image> | デフォルトOSイメージを上書き | いいえ | - |
--ssh-user <user> | 新しいVMのSSHユーザー名（デフォルト: root） | いいえ | - |
--base-domain <domain> | インフラストラクチャのベースドメイン（例: example.com）。--infra を含む | いいえ | - |
--no-infra | インフラ設定をスキップ（プロキシ + DNS） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
4.15 deprovision
クラウドでプロビジョニングされたマシンを破棄し、設定から削除する
rdc machine deprovision [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--force | 確認プロンプトをスキップする | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
4.16 backup
マシンバックアップ管理
list
すべてのマシンに紐づくバックアップ戦略を一覧表示
rdc machine backup listschedule
リモートマシンにバックアップスケジュールをデプロイ（systemd タイマー）
rdc machine backup schedule [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--dry-run | デプロイせずに生成されるユニットをプレビュー | いいえ | - |
--force | 現在バックアップが実行中でも続行する（新しいユニットは次のタイマーティックで適用され、実行中の呼び出しは古いユニットを保持） | いいえ | - |
--reset-failed | デプロイ成功後、変更したサービスの失敗状態をクリアする（既定は無効、失敗シグナルを保持） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
now
リモートマシンで今すぐバックアップを実行
rdc machine backup now [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--strategy <name> | 戦略名（省略時はすべて実行） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
status
リモートマシンのバックアップ状態とタイマー状態を表示
rdc machine backup status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--strategy <name> | 特定の戦略の詳細を表示 | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
cancel
リモートマシン上の実行中バックアップをキャンセル
rdc machine backup cancel [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
--strategy <name> | 戦略名（省略時はすべてキャンセル） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
4.17 prune
孤立したデータストアリソースと古いスナップショットをマシンから削除する
rdc machine prune [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--dry-run | 変更を加えずに削除される内容を表示する | いいえ | - |
--orphaned-repos | どの設定にも存在しないリポジトリイメージも削除する | いいえ | - |
--prune-unknown | renet .interim/state ミラーが分類できないリポジトリのみを削除します（ローカル設定になく、かつフォークマークされたミラーがない）。--orphaned-repos より厳密に狭い：ミラーがそれらを識別する場合、設定なしのフォークは保持されます。プレミラーレガシー孤児と設定エントリが削除された古い grands は両方ともこのバケットに入ります。 | いいえ | - |
--force-delete-mounted | マウント安全プリフライトを上書きし、現在マウントされているか実行中の Docker コンテナがあってもリポジトリを削除します。--force（アーカイブ猶予期間のみを上書き）とは異なります。--orphaned-repos と --prune-unknown の両方に適用されます。 | いいえ | - |
--force | 確認プロンプトをスキップする | いいえ | - |
--grace-days <days> | 最近アーカイブされたリポジトリの猶予期間（日数、デフォルト: 7） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
5. MCPサーバー
AIエージェント向けの Model Context Protocol サーバー
5.1 serve
MCP サーバーを起動する (stdio トランスポート)
rdc mcp serve [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--config <name> | すべてのコマンドに使用する設定名 | いいえ | - |
--timeout <ms> | デフォルトのコマンドタイムアウト (ミリ秒単位) | いいえ | 120000 |
6. リポジトリライフサイクル
マシン上の暗号化リポジトリをデプロイ・管理する
6.1 mount
リポジトリをマウントする (LUKS コンテナを開く)
rdc repo mount [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--checkpoint | マウント後にチェックポイントから復元する | いいえ | - |
--no-docker | マウント後に Docker デーモンの起動をスキップする | いいえ | - |
--parallel | リポジトリを並行して開始する | いいえ | - |
--concurrency <n> | 最大同時リポジトリ数 (デフォルト: 3) | いいえ | 3 |
-y, --yes | バッチ操作の確認をスキップ | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.2 unmount
リポジトリをアンマウントする
rdc repo unmount [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--checkpoint | アンマウント前にチェックポイントを作成する | いいえ | - |
--parallel | リポジトリを並行して開始する | いいえ | - |
--concurrency <n> | 最大同時リポジトリ数 (デフォルト: 3) | いいえ | 3 |
-y, --yes | バッチ操作の確認をスキップ | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.3 up
リポジトリをデプロイまたは更新する (マウント、サービス起動)
rdc repo up [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--skip-checkpoint | checkpoint データが存在しても CRIU checkpoint の復元をスキップする（強制的に新規起動） | いいえ | - |
--tls | このリポジトリ用の専用 TLS 証明書をリクエスト (フォークはデフォルトで共有マシン証明書を使用) | いいえ | - |
--detach | コンテナ起動後すぐに戻ります。ヘルスチェックはバックグラウンドで継続します | いいえ | - |
--include-forks | フォークされたリポジトリもマウント/開始する | いいえ | - |
--mount-only | マウントのみ、サービスは開始しない | いいえ | - |
--parallel | リポジトリを並行して開始する | いいえ | - |
--concurrency <n> | 最大同時リポジトリ数 (デフォルト: 3) | いいえ | 3 |
-y, --yes | バッチ操作の確認をスキップ | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
6.4 down
リポジトリサービスを停止する
rdc repo down [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--unmount | 停止後にリポジトリをアンマウントする | いいえ | - |
--checkpoint | 停止前に CRIU checkpoint を作成する（プロセスメモリ状態を保存し、後で 'repo up' で復元） | いいえ | - |
-y, --yes | バッチ操作の確認をスキップ | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
6.5 status
リポジトリのステータスを取得する
rdc repo status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.6 cat
リポジトリ内のファイルを範囲指定で読み取り、stdout に書き出します（サーバー側で範囲制限あり。診断情報は stderr に出力）
rdc repo cat [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--remote-file <path> | リポジトリマウントルートからの相対パスで読み取るファイルパス | はい | - |
--max-bytes <n> | 読み取って出力する最大バイト数（デフォルト 1 MiB、上限 50 MiB） | いいえ | - |
--offset <n> | 読み取りを開始するバイトオフセット | いいえ | - |
--head <lines> | 最初の N 行のみを出力する（バイト範囲との併用不可） | いいえ | - |
--tail <lines> | 最後の N 行のみを出力する（バイト範囲との併用不可） | いいえ | - |
--stat | サイズ、種類、更新日時のみを出力する（コンテンツは読み取らない） | いいえ | - |
--force-binary | バイナリ（NUL を含む）コンテンツの読み取りを許可する | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.7 diff
コピーオンライトでフォークされた2つのリポジトリ間の、git風ファイル単位の差分。追加・変更・削除・リネームされたファイルを報告します。--name で与えられたリポジトリ（対象／新側）を、ローカル設定から解決した親、あるいは明示的な --base リポジトリ（基底／旧側）と比較します。メタデータのみでサイズに依存しません: 暗号化された LUKS イメージを復号せずブロックレベルで差分を取るため、1 GB のリポジトリと 100 GB のリポジトリが同じミリ秒で差分されます。
rdc repo diff [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | 調査対象のリポジトリ（対象／新側） | はい | - |
--base <name> | 差分対象のリポジトリ（基底／旧側）。既定では --name の親 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--name-only | 変更されたファイルパスのみを1行ずつ出力（状態文字なし） | いいえ | - |
--stat | ファイルごとの変更量（バイトおよびブロックのデルタ）と合計を表示 | いいえ | - |
--content [path] | 単一ファイルの統一テキスト差分を表示（ファイルパスが必要） | いいえ | - |
--json | 構造化された差分結果を JSON エンベロープで出力 | いいえ | - |
--fast | ブロックフィルタを信頼し、コンテンツハッシュ確認を省略する（変更を過大報告する可能性あり） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.8 list
マシン上のリポジトリをリスト表示する
rdc repo list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.9 create
新しい暗号化リポジトリを作成する
rdc repo create [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--size <size> | リポジトリサイズ（例: 10G、100G、1T） | はい | - |
--no-docker | 作成後に Docker デーモンの起動をスキップする | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.10 delete
リポジトリを削除する（コンテナ、ボリューム、暗号化イメージを破棄）。設定エントリは保持されます。--archive-config を使用して資格情報を deletedRepositories に移動し、'config restore-archived' で復元できます
rdc repo delete [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--archive-config | 設定エントリを deletedRepositories に移動して後から復元可能にする | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
6.11 commit
マウント中の作業 fork の現在の状態を凍結し、新しいイミュータブルな commit を作成します（git ライク）。commit はメッセージ・作成者・タイムスタンプ・親をボリューム内に記録するため、push 時にも一緒に転送されます。また読み取り専用としてマークされ、マウントを拒否します。作業 fork は git が作業ツリーをそのまま残すのと同様に、変更されずに維持されます。書き込み可能なコピーを得るには 'rdc repo checkout' で commit をチェックアウトしてください。
rdc repo commit [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | commit する作業 fork（マウントされている必要があります） | はい | - |
--message <msg> | commit メッセージ | はい | - |
--author <author> | commit の作成者 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.12 branch
作業 fork の現在の commit（その先端）を指す名前付き branch 参照を作成します。branch 参照は CLI の設定内に保存されます（マシン = オブジェクトストア、設定 = 参照ストア）。
rdc repo branch [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--branch <branch> | 新しいブランチの名前 | はい | - |
--name <name> | branch が指す現在の commit を持つ作業 fork | はい | - |
6.13 checkout
イミュータブルな commit（または branch の先端）を新しい書き込み可能な作業 fork に reflink クローンし、HEAD をそこに向けます。ほぼ瞬時かつ定数時間で完了します（BTRFS reflink）。
rdc repo checkout [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
| `—ref <commit | branch>` | チェックアウトする commit の GUID（または --from でブランチ名） | はい |
--tag <name> | 新しい書き込み可能な作業 fork の名前 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--from <workingFork> | --ref をこの作業フォーク上のブランチ名として解決します | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.14 log
作業 fork の現在の commit（または commit 参照）から到達可能な commit 履歴を、'rdc repo commit' が記録した親チェーンをたどって表示します。ボリューム外のミラーを読み取るため、commit がアンロックされることはありません。
rdc repo log [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | 履歴のたどり始めとなる作業 fork または commit | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--json | commit 履歴を JSON として出力します | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.15 merge
ソースの commit または fork を対象の作業用 fork に merge します。稼働中の対象がその場で変更されることはありません。結果は reflink クローン上に構築され、アトミックに入れ替えられます。マウント中または実行中の対象は、--force を指定しない限り拒否されます。--force を指定した場合は、まず対象を安全に停止してから merge します。--resolve を指定しない場合は、イメージ全体の take-theirs となり (対象がソースに置き換わります)、--resolve ours|theirs を指定した場合は、共通の祖先に対するファイル単位の three-way merge となり、各サイド固有の変更を取り込み、両サイドで衝突する箇所はフラグに従って解決します。
rdc repo merge [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | merge 先となる対象の作業用 fork | はい | - |
--from <source> | merge 元となるソースの commit または fork | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--force | マウント中/実行中の対象をまず停止してから merge します (稼働中のマウントを直接変更することはありません) | いいえ | - |
| `—resolve <ours | theirs>` | 3-way マージのファイル単位の競合解決: 'ours' はターゲット側のバージョンを保持し、'theirs' はソース側を採用します。省略するとイメージ全体の fast-forward（take-theirs）になります。 | いいえ |
--base <guid> | 3-way マージの共通祖先コミットの GUID（--resolve と併用）。既定ではソースコミットの親、またはターゲットの現在のコミット。 | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.16 gc
どのブランチや HEAD からも到達できない不変コミットオブジェクトをマシン上から削除します（到達可能性 GC）。マシンがオブジェクトストア、CLI 設定が ref ストアです。既定はドライランで、削除するには --apply を指定します。マウント中のオブジェクトや作業中の fork には一切手を加えません。
rdc repo gc [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
--apply | 到達不能なコミットを実際に削除する（既定はドライランのプレビュー） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.17 fsck
CLI 設定の ref（ブランチ、HEAD）を、マシン上に実際に存在するオブジェクトと照合して検証します。ダングリング ref（存在しないオブジェクトを指す ref）と孤立コミット（どの ref からも到達できない不変コミット）を報告します。読み取り専用です。
rdc repo fsck [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
6.18 fork
リポジトリのCoW（コピーオンライト）フォークを作成する
rdc repo fork [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--parent <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--tag <name> | フォークのタグ（名前:タグを作成） | はい | - |
--checkpoint | fork 前にソースで CRIU checkpoint を作成する（fork 先での復元用にプロセスメモリ状態を取得） | いいえ | - |
--immutable | フォークを読み取り専用にします。マウントを拒否し、イメージをバイト単位で永続的に安定させます（マシン間デルタプッシュのための凍結されたコミット/ベース） | いいえ | - |
--up | fork後にマウントしてサービスを開始（fork + mount + upを1コマンドで） | いいえ | - |
--detach | --up と併用: コンテナ起動後すぐに戻ります。ヘルスチェックはバックグラウンドで継続します（使い捨てフォークに最適） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.19 takeover
グランドリポジトリのデータをフォークのデータで置き換えます。グランドはその ID（GUID、networkId、ドメイン、自動起動、バックアップチェーン）を保持しつつ、フォークの更新されたデータを取得します。古い本番データはバックアップフォークとして保存されます。使用方法: フォークでアップグレードをテスト → 確認 → 本番への引き継ぎ。
rdc repo takeover [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--force | 変更の警告をスキップする | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.20 resize
リポジトリをオフラインでリサイズ（拡張と縮小をサポート）
rdc repo resize [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--size <size> | 新しいリポジトリサイズ（例: 10G、100G、1T） | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.21 expand
マウント済みリポジトリをオンラインで拡張（ゼロダウンタイム）
rdc repo expand [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--size <size> | 新しいリポジトリサイズ（例: 10G、100G、1T） | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.22 trim
マウント済みリポジトリからデータストアプールの空き領域を回収します（オンライン、停止なし）。リポジトリ内で削除されたブロックは fstrim でプールに返されます。--name を省略すると、マウント済みのすべてのリポジトリとデータストア自体をトリムします。バックアップ実行中のリポジトリでは fstrim はスキップされますが、--docker の回収は引き続き実行されます
rdc repo trim [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
--name <name> | トリムするリポジトリ（デフォルト: マウント済みのすべて） | いいえ | - |
--docker | Docker の領域を回収（停止中コンテナ、宙吊りイメージ、ビルドキャッシュ）。バックアップのスナップショットが有効な間も実行されます | いいえ | - |
--docker-volumes | 未使用の Docker ボリュームも削除する | いいえ | - |
--report-only | トリムせずに discard 状態と回収可能量の見積もりを表示する | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.23 policy
マシンのストレージメンテナが適用する自動サイズポリシーを管理します。リポジトリが満杯に近づくとクォータをオンラインで拡大し（max-quota を超えず、プール残量が少ないときは拡大しません）、スケジュールされたトリムを実行します。自動縮小はありません。縮小には 'repo resize' を使ってください。--name を省略するとマシン全体のデフォルトポリシーを対象にします
set
サイズポリシーのフィールドを設定します。渡したフラグだけが変更され、他の保存済みフィールドは値を保持します。自動拡大の有効化には --max-quota が必要です。上限はプールのオーバープロビジョニングへの明示的な同意です
rdc repo policy set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
--name <name> | リポジトリ（デフォルト: マシン全体のポリシー） | いいえ | - |
--auto-grow <bool> | クォータのオンライン自動拡大を有効化（true/false） | いいえ | - |
--max-quota <size> | 自動拡大の上限（例: 200G）。自動拡大には必須 | いいえ | - |
--grow-threshold <percent> | 拡大を引き起こすファイルシステム使用率 %（デフォルト 85） | いいえ | - |
--grow-step <step> | 1 ステップの拡大量: 絶対値（10G）またはクォータの割合（20%） | いいえ | - |
--auto-trim <bool> | スケジュールトリムを有効化（true/false） | いいえ | - |
--trim-interval <hours> | 自動トリムの最小間隔（時間、デフォルト 24） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
get
保存されたマシンデフォルト、リポジトリの上書き（--name 指定時）、メンテナが実際に適用するマージ済みの有効ポリシーを表示します
rdc repo policy get [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
--name <name> | リポジトリ（デフォルト: マシン全体のポリシー） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.24 validate
リポジトリの整合性を検証する
rdc repo validate [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.25 autostart
起動時の自動リポジトリ開始を管理する
enable
リポジトリの自動開始を有効にする
rdc repo autostart enable [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
disable
リポジトリの自動開始を無効にする
rdc repo autostart disable [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
list
自動開始が有効なリポジトリを一覧表示する
rdc repo autostart list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | 対象マシン名 | はい | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.26 ownership
リポジトリディレクトリの所有権を変更する
rdc repo ownership [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
--uid <uid> | 所有者UID（デフォルト: 7111） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.27 template
リポジトリにテンプレートを適用する
list
CLIに組み込まれたすべてのデプロイテンプレートを一覧表示
rdc repo template listapply
Apply a template to a repository. Use a built-in template name (e.g. app-postgres) or --file for a custom JSON template. The template writes Rediaccfile, docker-compose.yml, and any additional files to the repository mount
rdc repo template apply [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 対象マシン名 | はい | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | はい | - |
--file <path> | テンプレートJSONファイルのパス | いいえ | - |
--grand <name> | グランドリポジトリ名 (自動的に GUID に解決) | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.28 push
リポジトリをリモート（マシンまたはストレージ）にプッシュ。名前を省略するとすべてのリポジトリをプッシュ。ターゲットタイプは設定から自動検出。マシン間転送では、暗号化されたリポジトリイメージが同じGUIDでコピーされます — これはバックアップ/移行であり、forkではありません。独立したforkを作成するには、まず'repo fork'を使用してからpush。push後にデプロイするには--upを使用
rdc repo push [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
--to <remote> | 宛先マシンまたはストレージ名（設定から自動検出） | いいえ | - |
--to-machine <machine> | — | いいえ | - |
--provision <provider> | ターゲットマシンが存在しない場合、クラウドプロバイダー経由で自動プロビジョニング | いいえ | - |
--checkpoint | バックアップ前にCRIUチェックポイントを作成（ライブマイグレーション用にプロセスメモリ状態をキャプチャ） | いいえ | - |
--force | 既存のバックアップを強制的に上書きする | いいえ | - |
--up | プッシュ後、ターゲットマシンにリポジトリをマウントしてデプロイする | いいえ | - |
--tag <tag> | バージョニング用デプロイタグ | いいえ | - |
-m, --machine <name> | マシン名 | はい | - |
-w, --watch | 変更を監視する | いいえ | - |
--parallel | リポジトリを並行して開始する | いいえ | - |
--concurrency <n> | 最大同時リポジトリ数 (デフォルト: 3) | いいえ | 3 |
-y, --yes | バッチ操作の確認をスキップ | いいえ | - |
--bwlimit <limit> | rsync転送の帯域幅制限（例: "6M", "10M"） | いいえ | - |
--delta-base <guid> | 両マシンにバイト単位で同一に存在するイミュータブルなベースGUID。変更されたブロックのみを転送（マシンターゲット）。省略すると自動ベースで手間なく処理 | いいえ | - |
--strategy <strategy> | 差分ベース使用時のブロック差分戦略: auto、physical、または shared | いいえ | - |
--json | 転送統計を JSON で出力 | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.29 pull
リモート（マシンまたはストレージ）からリポジトリをプル。名前を省略するとすべてのリポジトリをプル。ソースタイプは設定から自動検出。pull後にデプロイするには--upを使用
rdc repo pull [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | いいえ | - |
--from <remote> | ソースマシンまたはストレージ名（設定から自動検出） | いいえ | - |
--from-machine <machine> | — | いいえ | - |
--force | 既存のリポジトリを強制的に上書きする | いいえ | - |
--up | pull後、このマシンでリポジトリをマウントしてデプロイ | いいえ | - |
-m, --machine <name> | マシン名 | はい | - |
-w, --watch | 変更を監視する | いいえ | - |
--parallel | リポジトリを並行して開始する | いいえ | - |
--concurrency <n> | 最大同時リポジトリ数 (デフォルト: 3) | いいえ | 3 |
-y, --yes | バッチ操作の確認をスキップ | いいえ | - |
--bwlimit <limit> | rsync転送の帯域幅制限（例: "6M", "10M"） | いいえ | - |
--delta-base <guid> | 両マシンにバイト単位で同一に存在するイミュータブルなベースGUID。変更されたブロックのみを受信（マシンソース） | いいえ | - |
--strategy <strategy> | 差分ベース使用時のブロック差分戦略: auto、physical、または shared | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.30 migrate
最小限のダウンタイムでリポジトリを別のマシンにライブマイグレーション。2フェーズrsync: 実行中にバルク転送、その後短時間停止して差分同期。CRIUチェックポイントによるプロセスメモリ移行とターゲットマシンの自動プロビジョニングに対応
rdc repo migrate [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--from <machine> | 移行元マシン名 | はい | - |
--to <machine> | 対象マシン名 | はい | - |
--provision <provider> | クラウドプロバイダー経由でターゲットを自動プロビジョニング（例: hetzner, linode） | いいえ | - |
--bwlimit <limit> | rsync転送の帯域幅制限（例: 10M） | いいえ | - |
--checkpoint | CRIUライブマイグレーション: プロセスメモリ状態のキャプチャと復元 | いいえ | - |
--delta-base <guid> | 切り替え差分用のイミュータブルなベースGUID（上級者向け。既定はフェーズ1のベース） | いいえ | - |
--strategy <strategy> | 切り替え時のブロック差分戦略: auto、physical、または shared | いいえ | - |
--skip-dns | 移行後のDNSレコード切り替えをスキップ | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
6.31 backup
リポジトリバックアップを管理する
list
リモート（マシンまたはストレージ）の利用可能なバックアップを一覧表示
rdc repo backup list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--from <remote> | ソースマシンまたはストレージ名（設定から自動検出） | いいえ | - |
--from-machine <machine> | — | いいえ | - |
-m, --machine <name> | マシン名 | はい | - |
--path <subdir> | ストレージルート内のサブディレクトリ。省略すると、hot/ と cold/ の両方がリストされ、マージされます。 | いいえ | - |
-w, --watch | 変更を監視する | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
6.32 sync
リポジトリとファイルの同期（一括プッシュ/プル、ファイル転送）
upload
リポジトリにファイルをアップロード
rdc repo sync upload [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | はい | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
--local <paths...> | 1 つ以上のローカルファイルまたはディレクトリのパス（既定: カレントディレクトリ） | いいえ | - |
--remote <path> | リポジトリ内のリモートサブディレクトリパス | いいえ | - |
--remote-file <path> | アップロード先となる単一のリモートファイルパス（リポジトリのルート相対）。--remote とは併用できません。 | いいえ | - |
--mirror | ミラーモード - ローカルに存在しないリモートファイルを削除 | いいえ | - |
--verify | 同期後にチェックサムを使用してファイルを検証する | いいえ | - |
--confirm | 同期前に変更をプレビューして確認を要求する | いいえ | - |
--exclude <patterns...> | 同期から除外するパターン | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
download
リポジトリからファイルをダウンロード
rdc repo sync download [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | はい | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
--local <path> | ローカルディレクトリパス (デフォルト: 現在のディレクトリ) | いいえ | - |
--remote <path> | リポジトリ内のリモートサブディレクトリパス | いいえ | - |
--remote-file <path> | リポジトリ内のリモートファイルパス（単一ファイル転送時の --remote の代替） | いいえ | - |
--mirror | ミラーモード - リモートに存在しないローカルファイルを削除 | いいえ | - |
--verify | 同期後にチェックサムを使用してファイルを検証する | いいえ | - |
--confirm | 同期前に変更をプレビューして確認を要求する | いいえ | - |
--exclude <patterns...> | 同期から除外するパターン | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
status
同期ステータスを確認しローカル/リモートファイルを比較
rdc repo sync status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | はい | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
--local <path> | ローカルディレクトリパス (デフォルト: 現在のディレクトリ) | いいえ | - |
--remote <path> | リポジトリ内のリモートサブディレクトリパス | いいえ | - |
--remote-file <path> | リポジトリ内のリモートファイルパス（単一ファイル転送時の --remote の代替） | いいえ | - |
6.33 tunnel
リモートマシン上のコンテナポートへのSSHポートフォワードトンネルを作成。コンテナとポートが一意の場合は自動検出。Ctrl+Cを押すまでトンネルは開いたままになります
rdc repo tunnel [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | いいえ | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
-c, --container <name> | コンテナ名（実行中のコンテナが1つの場合は自動検出） | いいえ | - |
--port <port> | 転送するリモートコンテナポート | いいえ | - |
--local <port> | ローカルポート（デフォルトはリモートポートと同じ） | いいえ | - |
--url-only | トンネルが準備できたらローカル URL のみを表示する（スクリプト向け） | いいえ | - |
6.34 secret
Manage per-repo secrets injected at deploy time. Two modes: env (REDIACC_SECRET_<KEY> via compose ${VAR} interpolation) and file (host tmpfs at /var/run/rediacc/secrets/<networkId>/<KEY>, mounted via Docker compose `secrets:` block). Secrets never enter the encrypted LUKS image, so forks inherit none — externals see the fork as a different principal.
get
Read a single secret. Returns a redacted stub (`<redacted:secret>:<digest8>`) under agent context regardless of policy.
rdc repo secret get [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <repository> | リポジトリ名（例: mail、mail:staging）。タグなしの場合、デフォルトは :latest。 | はい | - |
--key <KEY> | UPPER_SNAKE_CASE 形式のシークレットキー（最大 64 文字）。env モードでは REDIACC_SECRET_<KEY> として、file モードではコンテナ内の /run/secrets/<key> として公開されます。 | はい | - |
list
シークレットのキーとモードを一覧表示（値もダイジェストも決して返しません）。
rdc repo secret list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <repository> | リポジトリ名（例: mail、mail:staging）。タグなしの場合、デフォルトは :latest。 | はい | - |
set
シークレットを設定または上書き。フォークは継承しません。フォーク上に明示的に設定してください。エージェントコンテキストでは --current ダイジェスト一致が必要です（passwd スタイル）。
rdc repo secret set [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <repository> | リポジトリ名（例: mail、mail:staging）。タグなしの場合、デフォルトは :latest。 | はい | - |
--key <KEY> | UPPER_SNAKE_CASE 形式のシークレットキー（最大 64 文字）。env モードでは REDIACC_SECRET_<KEY> として、file モードではコンテナ内の /run/secrets/<key> として公開されます。 | はい | - |
--value <value> | シークレット値。`-` を渡して stdin から読み取ります（シェル履歴への露出を回避）。 | はい | - |
--mode <mode> | 配信モード: 'env'（コンテナ環境、docker inspect で表示）または 'file'（tmpfs ファイル、env には決して入らない）。デフォルト: file。 | いいえ | file |
--current <value> | SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write. | いいえ | - |
--rotate-secret | ローテーションを承認；--current 前提条件をスキップ（ローテーションとして監査）。前の値を確認せずに意図的にローテーションする場合に使用。 | いいえ | - |
unset
シークレットを削除します。エージェントコンテキストでは --current ダイジェスト一致が必要です。
rdc repo secret unset [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <repository> | リポジトリ名（例: mail、mail:staging）。タグなしの場合、デフォルトは :latest。 | はい | - |
--key <KEY> | UPPER_SNAKE_CASE 形式のシークレットキー（最大 64 文字）。env モードでは REDIACC_SECRET_<KEY> として、file モードではコンテナ内の /run/secrets/<key> として公開されます。 | はい | - |
--current <value> | SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write. | いいえ | - |
--rotate-secret | ローテーションを承認；--current 前提条件をスキップ（ローテーションとして監査）。前の値を確認せずに意図的にローテーションする場合に使用。 | いいえ | - |
7. ストレージ管理
ストレージプロバイダーの管理とリモートファイルの参照
7.1 list
ストレージプロバイダーをリスト表示する
rdc storage list [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
--search <text> | {{field}}で検索 | いいえ | - |
--sort <field> | フィールドで並び替え | いいえ | - |
--desc | 降順で並び替え | いいえ | - |
7.2 create
新しいストレージプロバイダーを作成
rdc storage create [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
7.3 rename
ストレージプロバイダーの名前を変更
rdc storage rename [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--current-name <name> | 現在のリソース名 | はい | - |
--new-name <name> | 新しいリソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
7.4 delete
ストレージプロバイダーを削除
rdc storage delete [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-t, --team <name> | チーム名 | いいえ | - |
-f, --force | 確認プロンプトをスキップする | いいえ | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
7.5 vault
ストレージ Vault 管理 (クラウドアダプターのみ)
rdc storage vault7.6 browse
ストレージシステム内のファイルを参照する
rdc storage browse [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
--path <subpath> | リスト表示するサブディレクトリのパス | いいえ | “ |
7.7 prune
どの設定にも存在しなくなった孤立したバックアップをストレージから削除します。マルチ設定対応で猶予期間による保護付き。
rdc storage prune [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | 実行マシン、rclone のリスト/削除呼び出しをストレージに対して実行します。クライアントはローカルに rclone がインストールされていることが期待されないため必須です；ストレージの認証情報は引き続きローカル設定から取得されます。 | はい | - |
--dry-run | 変更を加えずに実行内容を表示する | いいえ | - |
--force | 確認プロンプトをスキップする | いいえ | - |
--force-delete-mounted | マウント安全チェックを上書きし、ソース GUID が現在実行マシンにマウントされているか実行中のコンテナを持っていてもクラウドバックアップを削除します。--force（アーカイブ済みリポジトリの猶予期間のみを上書き）とは異なります。 | いいえ | - |
--grace-days <days> | 最近アーカイブされたリポジトリの猶予期間（日数、デフォルト: 7） | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
--skip-router-restart | バイナリ更新後のルートサーバーの再起動をスキップする | いいえ | - |
8. VS Code統合
マシンまたはリポジトリへの VS Code Remote SSH を開く
8.1 connect
VS Code でマシンまたはリポジトリに接続する
rdc vscode connect [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | いいえ | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
-f, --folder <path> | リモートフォルダーパス | いいえ | - |
--url-only | VS Code URI を印刷して起動しない | いいえ | - |
-n, --new-window | 新しい VS Code ウィンドウで開く | いいえ | - |
--skip-env-setup | リモート環境セットアップをスキップする | いいえ | - |
--insiders | VS Code Insiders 設定を使用する | いいえ | - |
--browser | リポジトリサンドボックスからブラウザ VS Code を提供する（ローカルの VS Code 不要） | いいえ | - |
--no-open | ローカルブラウザを起動せずに URL のみを表示する | いいえ | - |
--local <port> | ローカルポート（デフォルトはリモートポートと同じ） | いいえ | - |
--server-provider <id> | ブラウザ VS Code サーバー実装 (openvscode, code-server) | いいえ | - |
--server-archive <file> | マシン上に事前配置されたサーバー tarball のパス（エアギャップインストール用） | いいえ | - |
8.2 list
設定済みの VS Code SSH 接続をリスト表示する
rdc vscode list8.3 cleanup
VS Code SSH 設定を削除する
rdc vscode cleanup [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--all | すべての rediacc SSH 設定を削除する | いいえ | - |
-c, --connection <name> | 特定の接続を削除する | いいえ | - |
8.4 check
VS Code のインストールと設定を確認する
rdc vscode check [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--insiders | VS Code Insiders 設定を使用する | いいえ | - |
8.5 serve
サンドボックス内のブラウザ VS Code サーバーを管理する
status
ブラウザ VS Code サーバーが起動しているか確認する
rdc vscode serve status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | いいえ | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
--server-provider <id> | ブラウザ VS Code サーバー実装 (openvscode, code-server) | いいえ | - |
stop
ブラウザ VS Code サーバーを停止する
rdc vscode serve stop [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | いいえ | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
--server-provider <id> | ブラウザ VS Code サーバー実装 (openvscode, code-server) | いいえ | - |
9. SSHターミナルアクセス
マシンとリポジトリへの SSH ターミナルアクセス
9.1 connect
マシンまたはリポジトリに SSH 経由で接続する
rdc term connect [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --team <name> | チーム名 | いいえ | - |
-m, --machine <name> | マシン名 | いいえ | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
-c, --command <cmd> | インタラクティブシェルの代わりにコマンドを実行する | いいえ | - |
--container <id> | 特定の Docker コンテナに接続する | いいえ | - |
--container-action <action> | コンテナアクション: terminal, logs, stats, exec | いいえ | - |
--log-lines <lines> | 表示するログ行数 (デフォルト: 50) | いいえ | - |
--follow | ログ出力をフォローする | いいえ | - |
--external | 外部ターミナルウィンドウで起動を強制する | いいえ | - |
--reset-home | リポジトリごとのホームオーバーレイをリセットして初期状態にする | いいえ | - |
10. プロトコルハンドラー
{{scheme}}:// プロトコル URL の登録と処理
10.1 register
システムにプロトコルハンドラーを登録する
rdc protocol register [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--system | システム全体に登録する (管理者権限が必要) | いいえ | - |
--force | 既に登録されている場合でも再登録を強制する | いいえ | - |
10.2 unregister
システムからプロトコルハンドラーの登録を解除する
rdc protocol unregister [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--system | システム全体の登録を解除する (管理者権限が必要) | いいえ | - |
10.3 status
プロトコルハンドラーの登録ステータスを表示する
rdc protocol status10.4 open
{{scheme}}:// URL を開いてアクションを実行する
rdc protocol open <url>10.5 build
コンポーネントから {{scheme}}:// URL をビルドする
rdc protocol build [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--token <token> | 認証トークン | はい | - |
-t, --team <name> | チーム名 | はい | - |
-m, --machine <name> | マシン名 | はい | - |
-r, --repository <name> | リポジトリ名 (リポジトリ環境に接続) | いいえ | - |
-a, --action <action> | アクション ({{actions}}) | いいえ | desktop |
-p, --params <key=value...> | 追加パラメータ | いいえ | - |
10.6 parse
{{scheme}}:// URL を解析してコンポーネントを表示する
rdc protocol parse <url>11. クイックコマンド（ショートカット）
11.1 run
関数を実行する (短縮形: queue create)
rdc run11.2 trace
タスクをトレースする (queue trace のショートカット)
rdc trace11.3 cancel
タスクをキャンセルする (queue cancel のショートカット)
rdc cancel11.4 retry
失敗したタスクをリトライする (queue retry のショートカット)
rdc retry12. サブスクリプション管理
マシンライセンスとサブスクリプションの管理
12.1 login
WebポータルのAPIトークンで認証
rdc subscription login [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-t, --token <token> | APIトークン (rdt_...) | いいえ | - |
--server <url> | アカウントサーバーURL | いいえ | - |
12.2 logout
保存されたサブスクリプショントークンを削除する
rdc subscription logout12.3 status
サブスクリプションとライセンスの状態を表示
rdc subscription status12.4 activation
マシンアクティベーション管理
status
1台のマシンのアクティベーション状態を表示する
rdc subscription activation status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
12.5 repo
リポジトリライセンス管理
status
マシンにインストール済みのリポジトリライセンスを表示する
rdc subscription repo status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
12.6 refresh
マシンライセンスを更新
activation
リモートマシンのアクティベーションを更新する
rdc subscription refresh activation [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
repos
リモートマシン上のリポジトリライセンスを一括更新する
rdc subscription refresh repos [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
-m, --machine <name> | マシン名 | はい | - |
repo
特定のリポジトリのライセンスを更新する
rdc subscription refresh repo [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--name <name> | リソース名 | はい | - |
-m, --machine <name> | マシン名 | はい | - |
13. CLIアップデート
CLIのアップデートを確認して適用
rdc update [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--force | 最新でも強制的にアップデート | いいえ | - |
--check-only | ダウンロードせずにアップデートの確認のみ | いいえ | - |
--rollback | 以前のバージョンにロールバック | いいえ | - |
--status | 自動更新のステータスと診断情報を表示 | いいえ | - |
--channel <channel> | リリースチャンネルを設定 (stable または edge) | いいえ | - |
14. システム診断
CLI環境とrenet統合を診断
rdc doctor15. 実験的 VM 操作
実験的な VM 操作（プロビジョニング、管理、破棄）
15.1 up
VM クラスターをローカルにプロビジョニング
rdc ops up [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--force | すべての VM を強制再起動 | いいえ | - |
--parallel | VM を並列で作成 | いいえ | - |
--basic | 最小構成クラスター (ブリッジ + ワーカー1台) | いいえ | - |
--lite | VM プロビジョニングをスキップ (ステータスのみ) | いいえ | - |
--skip-orchestration | クラスターオーケストレーションをスキップ | いいえ | - |
--backend <backend> | 仮想化バックエンド (kvm|qemu、自動検出) | いいえ | - |
--os <name> | VM オペレーティングシステム (例: ubuntu-24.04, debian-12) | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
15.2 down
VM クラスターを破棄
rdc ops down [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--backend <backend> | 仮想化バックエンド (kvm|qemu、自動検出) | いいえ | - |
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
15.3 status
VM クラスターの状態を表示
rdc ops status [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--backend <backend> | 仮想化バックエンド (kvm|qemu、自動検出) | いいえ | - |
15.4 ssh
VM に SSH 接続
rdc ops ssh [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--vm-id <id> | 仮想マシン ID | はい | - |
-c, --command <cmd> | インタラクティブシェルの代わりにコマンドを実行する | いいえ | - |
--backend <backend> | 仮想化バックエンド (kvm|qemu、自動検出) | いいえ | - |
--user <user> | VM 接続用の SSH ユーザー名 | いいえ | - |
15.5 setup
仮想化の前提条件をインストール
rdc ops setup [options]| フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|
--debug | デバッグ出力を有効化 (ローカルモード) | いいえ | - |
15.6 check
仮想化の前提条件を確認
rdc ops check一般的なエラーメッセージ
問題が発生した場合、CLIは明確なエラーメッセージを提供します：
| エラー | 意味 |
|---|---|
| 認証が必要です。実行してください: rdc auth login | 最初にログインする必要があります |
| アクティブな設定がありません。`rdc config init --name <name>` で作成してください。 | アクティブな設定がありません — `rdc config init` で作成してください |
| 権限がありません | アカウントに必要な権限がありません |
| マシン名が必要です。--machine <name> を使用してください | `--machine`でマシンを指定するか、コンテキストのデフォルトを設定してください |
| チーム名が必要です。--team を使用するか、コンテキストを設定してください。 | `--team`でチームを指定するか、コンテキストのデフォルトを設定してください |
| リージョン名が必要です。--region を使用するか、コンテキストを設定してください。 | `--region`でリージョンを指定するか、コンテキストのデフォルトを設定してください |
出力形式
すべてのlist/getコマンドは`--output`を通じて複数の出力形式をサポートしています：
rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table # defaultこれにより、Rediacc CLIをスクリプト、CI/CDパイプライン、自動化ワークフローに簡単に統合できます。