メインコンテンツにスキップ ナビゲーションにスキップ フッターにスキップ
期間限定:デザインパートナープログラム — BUSINESSプランを永久利用

CLIアプリケーション

プラットフォーム管理のためのRediaccコマンドラインインターフェースの完全ガイド

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 capabilities

1.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-reference

2. 設定管理

設定ファイル、マシン、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-onlyACME 証明書キャッシュバケットに制限します。アーカイブのパージとクロスリファレンスのクリーンアップをスキップします。--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 list

2.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 set-ssh

現在の設定の SSH 設定を更新する

rdc config set-ssh

2.10 set-renet

ローカルモード用の renet バイナリのパスを設定する

rdc config set-renet

2.11 ssh

SSH キーの設定を管理する

set

現在の設定に SSH キーを設定する

rdc config ssh set [options]
フラグ説明必須デフォルト
--key <path>SSH 秘密キーファイルのパスはい-
--embedパスを保存する代わりにキーの内容を設定に埋め込むいいえ-

show

現在の SSH キー設定を表示する

rdc config ssh show

remove

現在の設定から SSH キーを削除する

rdc config ssh remove

2.12 remote

リモート設定ストレージ接続を管理

enable

この設定をリモート暗号化ストレージにリンク

rdc config remote enable [options]
フラグ説明必須デフォルト
--headlessデバイスコードフローを使用(ヘッドレスサーバー用)いいえ-
--api-url <url>アカウントサーバーURLいいえ-

disable

リモートストレージから切断し、設定をローカルに保存

rdc config remote disable

status

リモート接続状態を表示

rdc config remote status

refresh

リモートストレージから設定を強制再取得

rdc config remote refresh

2.13 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 list

scan-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.14 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 list

list-archived

アーカイブ済みリポジトリ資格情報をリスト表示する

rdc config repository list-archived

restore-archived

アーカイブ済みリポジトリ資格情報を復元する

rdc config repository restore-archived [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
--new-name <name>新しいリソース名いいえ-

purge-archived

アーカイブ済み資格情報をすべて完全に削除する

rdc config repository purge-archived

2.15 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 list

2.16 storage

現在の設定のストレージバックエンドを管理する

import

rclone 設定ファイルからストレージをインポートする

rdc config storage import [options]
フラグ説明必須デフォルト
--file <path>ファイルパスはい-
--name <name>指定したセクションのみインポートするいいえ-

remove

現在の設定からストレージを削除する

rdc config storage remove [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-

list

現在の設定のストレージをリスト表示する

rdc config storage list

2.17 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.18 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 status

clear

証明書キャッシュを削除

rdc config cert-cache clear

2.19 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.20 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.21 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 tail

verify

すべての監査エントリにおける SHA-256 ハッシュチェーンの整合性を検証

rdc config audit verify

2.22 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 list

show

バックアップ戦略の詳細を表示

rdc config backup-strategy show [options]
フラグ説明必須デフォルト
--name <name>戦略名(省略時はすべて表示)いいえ-

3. データストア管理

Ceph RBDデータストアのライフサイクルを管理(init、fork、unfork、status)

3.1 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.2 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.3 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.4 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 vault

4.6 vault-status

{{t:cli.commands.machine.vault-status.description}}

rdc machine vault-status [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-t, --team <name>チーム名いいえ-

4.7 update

マシン設定を更新する

rdc machine update

4.8 health

CI/CDパイプライン用のマシン健全性を確認する

healthコマンドはシステムメトリクス、コンテナステータス、サービス安定性、ストレージ情報を出力します — CI/CDパイプラインチェックに便利です。

rdc machine health [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-t, --team <name>チーム名いいえ-

4.9 containers

マシン上の実行中コンテナを一覧表示する

rdc machine containers [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-t, --team <name>チーム名いいえ-
--health-check健全性チェックモード - 不健全なものがある場合はコード2で終了しますいいえ-

4.10 services

マシン上のsystemdサービスをリスト表示する

rdc machine services [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-t, --team <name>チーム名いいえ-
--stability-check安定性チェックモード - 失敗/再起動中のものがある場合はコード2で終了しますいいえ-

4.11 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.12 vault-status

マシンの解析されたボルトステータスを表示する

rdc machine vault-status [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-t, --team <name>チーム名いいえ-

4.13 repos

マシンにデプロイされたリポジトリをリスト表示する

rdc machine repos [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-t, --team <name>チーム名いいえ-
--search <text>リポジトリ名でフィルターいいえ-

4.14 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-known-hosts`を使用してください。

4.15 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.16 deprovision

クラウドでプロビジョニングされたマシンを破棄し、設定から削除する

rdc machine deprovision [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
--force確認プロンプトをスキップするいいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-

4.17 backup

マシンバックアップ管理

list

すべてのマシンに紐づくバックアップ戦略を一覧表示

rdc machine backup list

schedule

リモートマシンにバックアップスケジュールをデプロイ(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.18 prune

孤立したデータストアリソースと古いスナップショットをマシンから削除する

rdc machine prune [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
--dry-run変更を加えずに削除される内容を表示するいいえ-
--orphaned-reposどの設定にも存在しないリポジトリイメージも削除するいいえ-
--prune-unknownrenet .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
--allow-grandgrand(非 fork)リポジトリに対する破壊的操作を許可する。デフォルト: fork 専用モードいいえ-

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-checkpointcheckpoint データが存在しても CRIU checkpoint の復元をスキップする(強制的に新規起動)いいえ-
--tlsこのリポジトリ用の専用 TLS 証明書をリクエスト (フォークはデフォルトで共有マシン証明書を使用)いいえ-
--include-forksフォークされたリポジトリもマウント/開始するいいえ-
--mount-onlyマウントのみ、サービスは開始しないいいえ-
--parallelリポジトリを並行して開始するいいえ-
--concurrency <n>最大同時リポジトリ数 (デフォルト: 3)いいえ3
-y, --yesバッチ操作の確認をスキップいいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-
--dry-run変更を加えずに実行内容を表示するいいえ-

6.4 up-all

マシン上のすべてのリポジトリをデプロイする

rdc repo up-all

6.5 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.6 status

リポジトリのステータスを取得する

rdc repo status [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.7 list

マシン上のリポジトリをリスト表示する

rdc repo list [options]
フラグ説明必須デフォルト
-m, --machine <name>対象マシン名はい-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.8 create

新しい暗号化リポジトリを作成する

rdc repo create [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--size <size>リポジトリサイズ(例: 10G、100G、1T)はい-
--no-docker作成後に Docker デーモンの起動をスキップするいいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.9 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.10 fork

リポジトリのCoW(コピーオンライト)フォークを作成する

rdc repo fork [options]
フラグ説明必須デフォルト
--parent <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--tag <name>フォークのタグ(名前:タグを作成)はい-
--checkpointfork 前にソースで CRIU checkpoint を作成する(fork 先での復元用にプロセスメモリ状態を取得)いいえ-
--upfork後にマウントしてサービスを開始(fork + mount + upを1コマンドで)いいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.11 takeover

グランドリポジトリのデータをフォークのデータで置き換えます。グランドはその ID(GUID、networkId、ドメイン、自動起動、バックアップチェーン)を保持しつつ、フォークの更新されたデータを取得します。古い本番データはバックアップフォークとして保存されます。使用方法: フォークでアップグレードをテスト → 確認 → 本番への引き継ぎ。

rdc repo takeover [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--force変更の警告をスキップするいいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.12 resize

リポジトリをオフラインでリサイズ(拡張と縮小をサポート)

rdc repo resize [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--size <size>新しいリポジトリサイズ(例: 10G、100G、1T)はい-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.13 expand

マウント済みリポジトリをオンラインで拡張(ゼロダウンタイム)

rdc repo expand [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--size <size>新しいリポジトリサイズ(例: 10G、100G、1T)はい-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.14 validate

リポジトリの整合性を検証する

rdc repo validate [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.15 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.16 ownership

リポジトリディレクトリの所有権を変更する

rdc repo ownership [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
-m, --machine <name>対象マシン名はい-
--uid <uid>所有者UID(デフォルト: 7111)いいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.17 template

リポジトリにテンプレートを適用する

list

CLIに組み込まれたすべてのデプロイテンプレートを一覧表示

rdc repo template list

apply

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.18 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")いいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.19 pull

リモート(マシンまたはストレージ)からリポジトリをプル。名前を省略するとすべてのリポジトリをプル。ソースタイプは設定から自動検出。pull後にデプロイするには--upを使用

rdc repo pull [options]
フラグ説明必須デフォルト
--name <name>リソース名いいえ-
--from <remote>ソースマシンまたはストレージ名(設定から自動検出)いいえ-
--from-machine <machine>いいえ-
--force既存のリポジトリを強制的に上書きするいいえ-
--uppull後、このマシンでリポジトリをマウントしてデプロイいいえ-
-m, --machine <name>マシン名はい-
-w, --watch変更を監視するいいえ-
--parallelリポジトリを並行して開始するいいえ-
--concurrency <n>最大同時リポジトリ数 (デフォルト: 3)いいえ3
-y, --yesバッチ操作の確認をスキップいいえ-
--bwlimit <limit>rsync転送の帯域幅制限(例: "6M", "10M")いいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-
--skip-router-restartバイナリ更新後のルートサーバーの再起動をスキップするいいえ-

6.20 migrate

最小限のダウンタイムでリポジトリを別のマシンにライブマイグレーション。2フェーズrsync: 実行中にバルク転送、その後短時間停止して差分同期。CRIUチェックポイントによるプロセスメモリ移行とターゲットマシンの自動プロビジョニングに対応

rdc repo migrate [options]
フラグ説明必須デフォルト
--name <name>リソース名はい-
--from <machine>移行元マシン名はい-
--to <machine>対象マシン名はい-
--provision <provider>クラウドプロバイダー経由でターゲットを自動プロビジョニング(例: hetzner, linode)いいえ-
--bwlimit <limit>rsync転送の帯域幅制限(例: 10M)いいえ-
--checkpointCRIUライブマイグレーション: プロセスメモリ状態のキャプチャと復元いいえ-
--skip-dns移行後のDNSレコード切り替えをスキップいいえ-
--debugデバッグ出力を有効化 (ローカルモード)いいえ-

6.21 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.22 sync

リポジトリとファイルの同期(一括プッシュ/プル、ファイル転送)

push

クラウドストレージにリポジトリをプッシュする(名前を省略するとすべてプッシュ)

rdc repo sync push

pull

クラウドストレージからリポジトリをプルする(名前を省略するとすべてプル)

rdc repo sync pull

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.23 snapshot

リモートマシン上のBTRFSスナップショットを管理する

create

リポジトリのBTRFSスナップショットを作成する

rdc repo snapshot create

list

リモートマシン上のスナップショットを一覧表示する

rdc repo snapshot list

delete

リモートマシンからスナップショットを削除する

rdc repo snapshot delete

6.24 tunnel

リモートマシン上のコンテナポートへのSSHポートフォワードトンネルを作成。コンテナとポートが一意の場合は自動検出。Ctrl+Cを押すまでトンネルは開いたままになります

rdc repo tunnel [options]
フラグ説明必須デフォルト
-m, --machine <name>マシン名いいえ-
-r, --repository <name>リポジトリ名 (リポジトリ環境に接続)いいえ-
-c, --container <name>コンテナ名(実行中のコンテナが1つの場合は自動検出)いいえ-
--port <port>転送するリモートコンテナポートいいえ-
--local <port>ローカルポート(デフォルトはリモートポートと同じ)いいえ-

6.25 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 vault

7.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バイナリ更新後のルートサーバーの再起動をスキップするいいえ-

7.8 pull

クラウドストレージからマシンにバックアップをプルする

rdc storage pull

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-onlyVS Code URI を印刷して起動しないいいえ-
-n, --new-window新しい VS Code ウィンドウで開くいいえ-
--skip-env-setupリモート環境セットアップをスキップするいいえ-
--insidersVS Code Insiders 設定を使用するいいえ-

8.2 list

設定済みの VS Code SSH 接続をリスト表示する

rdc vscode list

8.3 cleanup

VS Code SSH 設定を削除する

rdc vscode cleanup [options]
フラグ説明必須デフォルト
--allすべての rediacc SSH 設定を削除するいいえ-
-c, --connection <name>特定の接続を削除するいいえ-

8.4 check

VS Code のインストールと設定を確認する

rdc vscode check [options]
フラグ説明必須デフォルト
--insidersVS Code Insiders 設定を使用するいいえ-

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 status

10.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 run

11.2 trace

タスクをトレースする (queue trace のショートカット)

rdc trace

11.3 cancel

タスクをキャンセルする (queue cancel のショートカット)

rdc cancel

11.4 retry

失敗したタスクをリトライする (queue retry のショートカット)

rdc retry

12. サブスクリプション管理

マシンライセンスとサブスクリプションの管理

12.1 login

WebポータルのAPIトークンで認証

rdc subscription login [options]
フラグ説明必須デフォルト
-t, --token <token>APIトークン (rdt_...)いいえ-
--server <url>アカウントサーバーURLいいえ-

12.2 logout

保存されたサブスクリプショントークンを削除する

rdc subscription logout

12.3 status

サブスクリプションとライセンスの状態を表示

rdc subscription status

12.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 doctor

15. 実験的 VM 操作

実験的な VM 操作(プロビジョニング、管理、破棄)

15.1 up

VM クラスターをローカルにプロビジョニング

rdc ops up [options]
フラグ説明必須デフォルト
--forceすべての VM を強制再起動いいえ-
--parallelVM を並列で作成いいえ-
--basic最小構成クラスター (ブリッジ + ワーカー1台)いいえ-
--liteVM プロビジョニングをスキップ (ステータスのみ)いいえ-
--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パイプライン、自動化ワークフローに簡単に統合できます。