リポジトリ
リポジトリとは、リモートサーバー上のLUKS暗号化ディスクイメージです。マウントすると以下が提供されます。
- アプリケーションデータ用の隔離されたファイルシステム
- 専用のDockerデーモン(ホストのDockerとは別個)
- /26サブネット内の各サービスに対するユニークなループバックIP
リポジトリの作成
rdc repo create my-app -m server-1 --size 10G
| オプション | 必須 | 説明 |
|---|---|---|
-m, --machine <name> | はい | リポジトリを作成するターゲットマシン |
--size <size> | はい | 暗号化ディスクイメージのサイズ(例: 5G, 10G, 50G) |
--skip-router-restart | いいえ | 操作後にルートサーバーの再起動をスキップする |
出力には自動生成された3つの値が表示されます。
- リポジトリGUID — サーバー上の暗号化ディスクイメージを識別するUUID。
- クレデンシャル — LUKSボリュームの暗号化と復号に使用するランダムなパスフレーズ。
- ネットワークID — このリポジトリのサービスに対するIPサブネットを決定する整数(2816から始まり64ずつ増加)。
クレデンシャルは安全な場所に保管してください。 これはリポジトリの暗号化キーです。紛失した場合、データは復元できません。クレデンシャルはローカルの
config.jsonに保存されますが、サーバーには保存されません。
マウントとアンマウント
マウントはリポジトリのファイルシステムを復号してアクセス可能にします。アンマウントは暗号化ボリュームを閉じます。
rdc repo up my-app # 復号してマウント
rdc repo down my-app --unmount # アンマウントして再暗号化
| オプション | 説明 |
|---|---|
--checkpoint | マウント/アンマウント前にCRIUチェックポイントを作成する(rediacc.checkpoint=true ラベルを持つコンテナ用) |
--skip-router-restart | 操作後にルートサーバーの再起動をスキップする |
ステータスの確認
rdc repo status my-app
リポジトリ一覧
rdc repo list -m server-1
Typeカラムとステートミラー
出力テーブルには3つの値を持つ Type カラムが含まれます。
grand: ローカルCLI設定に親なしで登録されたトップレベルリポジトリ。基本ケース。fork: 別リポジトリのコピーオンライトフォーク。ローカル設定のgrandGuidまたはマシン上のrenet.interim/stateミラーのいずれかで識別されます。どちらのソースも信頼できますが、ミラーが生成されれば両者は一致するはずです。unknown: どちらのシグナルでもリポジトリを分類できない状態。多くの場合、ミラーコードがリリースされる前に作成され、その後一度もマウントされていないレガシーフォーク、またはローカル設定エントリが誤って削除されたままのgrandです。CLIは推測を拒否します。オペレーターはミラーのバックフィルを実行するか、本当に孤立している場合はディレクトリを削除してください。
.interim/state/<guid>/.rediacc.json ミラーは、LUKS暗号化ボリューム外部に書き込まれる小さなサイドカーファイルです。これにより、バックアップツールや repo list は各イメージをアンロックせずにフォークの系統を読み取ることができます。このファイルはインボリュームの .rediacc.json(is_fork, grand_guid, name など)と同じ構造を持ち、Repository.SaveState のたびに更新されます。つまり、マウントのたびとステート変更のたびに更新されます。これはスケジュールされたバックアップにおけるフォーク検出の信頼できるソースです。ミラーが is_fork: true を示すアンマウントされたフォークは、cold および hot アップロードから正しくスキップされます。
不明なエントリの定期的なクリーンアップについては、rdc machine prune --prune-unknown を参照してください。
サイズ変更
リポジトリを正確なサイズに設定するか、指定した量だけ拡張します。
rdc repo resize my-app --size 20G # 正確なサイズに設定
rdc repo expand my-app --size 5G # 現在のサイズに5G追加
サイズ変更の前にリポジトリをアンマウントする必要があります。
repo expandはオンラインで動作します。サイズ変更はリポジトリの最大サイズを変更します。最大サイズを変えずに解放済みブロックをプールに返すには、代わりにrepo trimを使用してください。
領域の回収 (trim)
リポジトリ内のファイルを削除するとそのリポジトリの空き容量が増えますが、repo trim はその解放されたブロックを共有データストアプールに返却します。ゼロダウンタイムでオンライン実行できます。
rdc repo trim -m server-1 # Trim every mounted repository plus the datastore
rdc repo trim my-app # Trim one repository
rdc repo trim -m server-1 --report-only # Show reclaimable space without trimming
rdc repo trim -m server-1 --docker # Also clear stopped containers, dangling images, and build cache first
仕組み: リポジトリイメージはスパースファイルであり、暗号化ボリュームはディスカードを透過的に通過させます。trim はリポジトリ内部のファイルシステムに未使用ブロックをすべて解放するよう指示し、これにより裏付けイメージにホールが穿たれてプール使用量が即座に削減されます。
注意事項:
- アクティブなバックアップ中のリポジトリはファイルシステムのトリムがスキップされて報告されます。バックアップスナップショットがまだそのブロックを参照しているため、ホールを穿っても空きプール容量は増えないためです。
--dockerの回収はこの制限を受けず、引き続き実行されます(後述)。 - trim を連続して2回実行すると、2回目は0バイトと報告されます。ファイルシステムはすでにトリム済みのブロックグループを記憶しており、これは想定された動作であり失敗ではありません。
--dockerはタグ付きイメージを削除せず、ダングリングイメージ、停止済みコンテナ、ビルドキャッシュのみを対象とします。未使用ボリュームも削除するには--docker-volumesを追加してください(データが削除されます。CLIのみ)。ファイルシステムのトリムとは異なり、--dockerの回収はバックアップ実行中でも動作するため、バックアップ終了を待たずに詰まったビルドキャッシュをクリアできます。
自動サイズポリシー
手動でサイズ変更する代わりに、マシンがリポジトリのサイズを管理できます。ポリシーはオンラインでの自動拡張(リポジトリが満杯になると最大サイズが増加)とスケジュールされたトリムを有効にします。マシンは rediacc-storage-maintain systemd タイマーを通じて数分ごとにポリシーを適用します。
# Machine-wide default: trim every repository daily
rdc repo policy set -m server-1 --auto-trim true
# Per-repository: grow my-app automatically, up to a hard ceiling
rdc repo policy set my-app --auto-grow true --max-quota 50G
# Inspect the stored and effective policy
rdc repo policy get my-app
ポリシーフィールド:
| フィールド | 意味 | デフォルト |
|---|---|---|
--auto-grow | ファイルシステムがしきい値を超えたときにリポジトリをオンラインで拡張する | オフ |
--max-quota | 自動拡張のハード上限。必須: 設定することはプールをオーバープロビジョニングする明示的な同意を意味する | なし |
--grow-threshold | 拡張をトリガーするファイルシステム使用率 % | 85 |
--grow-step | 1回の拡張で追加する容量: 絶対値(10G)または現在サイズのパーセント(20%) | 20% |
--auto-trim | スケジュールされたトリムを実行する | オフ |
--trim-interval | 自動トリム間の最小時間(時間) | 24 |
ガードレール: プールの空き容量が予約容量(10 GB またはプールの5%のいずれか大きい方)を下回る場合、自動拡張は拒否されます。同じリポジトリの拡張間は少なくとも30分待機し、--max-quota を超えることはありません。自動縮小はありません。リポジトリの最大サイズの削減は手動かつオフラインの repo resize のままです。
リポジトリごとの設定はマシン全体のデフォルトを上書きします。policy set の繰り返し呼び出しでは、渡したフラグのみが変更されます。
リソース制限
デフォルトでは、リポジトリにはメモリ、CPU、I/O の制限がありません。そのため負荷の高いリポジトリ 1 つが、ホストや同じホスト上の他のすべてのリポジトリからメモリを奪うことがあります。制限はリポジトリ全体に適用されます。対象はコンテナ、Rediaccfile の up() と down()、そして RAM ボリュームです。
# Cap my-app at 10 GB of memory and 4 CPU cores
rdc repo policy set my-app --memory-max 10G --cpu-max 4
# Cap its disk reads and writes
rdc repo policy set my-app --io-max rbps=200M,wbps=100M
# Show the size policy and the limits
rdc repo policy get my-app
# Remove every limit and the RAM volume
rdc repo policy set my-app --clear-limits
| フラグ | 意味 |
|---|---|
--memory-max | メモリ上限(10G)。上限に達すると、リポジトリのコンテナの 1 つが OOM で終了し、リポジトリの外には影響しません |
--memory-high | 上限より低い抑制ポイント。これを超えると、カーネルがリポジトリのメモリをより強く回収します |
--cpu-max | CPU 上限。コア数(4、2.5)または割合(250%)で指定します |
--io-max | リポジトリのデバイスに対するディスク上限。rbps= と wbps=(バイト/秒)、riops= と wiops=(操作/秒)を任意に組み合わせます |
--pids-max | プロセス数の上限 |
--ram-volume | リポジトリの RAM ボリュームのサイズ(後述) |
--clear-limits | すべての制限と RAM ボリュームを削除します |
--force | リポジトリの現在の使用量を下回るメモリ上限を許可します |
値 max は 1 つの制限だけを解除します(--memory-max max、--io-max wbps=max)。変更は実行中のリポジトリに再起動なしで反映されます。リポジトリの現在の使用量を下回るメモリ上限は、--force を指定しない限り拒否されます。
リポジトリがメモリ上限に達すると、カーネルは最大のプロセスを含むコンテナだけを終了します。他のコンテナは動き続け、他のリポジトリもすべてそのまま動き続けます。rdc machine status は、各リポジトリについて上限に対するメモリ使用量、OOM による終了回数、RAM ボリュームを表示し、メモリ上限なしで動いているリポジトリをすべて名前で示します。
マシンは制限を、リポジトリの外にある /etc/rediacc/grants 配下のオペレーター許可に保存します。リポジトリのコンテナ、Rediaccfile、ターミナルセッションは、これを読むことも変更することもできません。グランドリポジトリの制限を変更する AI エージェントには、パス許可と同じく REDIACC_ALLOW_GRAND_REPO が必要です。フォークには何も必要ありません。フォークは親の制限と RAM ボリュームを引き継ぐため、上限付きリポジトリのフォークが上限なしで動くことはありません。デフォルトでは制限は設定されていません。
RAM ボリューム
--ram-volume 8G は、リポジトリのマウント内の .ram に RAM ディスク(tmpfs)を用意します。コンテナはその中のパスを、リポジトリの他のパスと同じようにバインドします(例: ./.ram/data:/var/lib/data)。そのページはリポジトリのメモリ上限に算入されるため、上限はボリュームサイズより 1 GB 以上大きくする必要があります。--memory-max 10G --ram-volume 8G は受け付けられ、--memory-max 8G --ram-volume 8G は拒否されます。
ボリュームは、リポジトリの Docker デーモンを再起動しても残ります。リポジトリをアンマウントするとき、down() の実行後に削除されます。
| イベント | 失われるもの |
|---|---|
| Docker デーモンの再起動 | なし |
| コンテナが OOM で終了する | なし |
repo down --unmount、repo unmount、計画的な再起動 | down() が保存しないもの |
ホストのシャットダウン中に down() がタイムアウトする | down() がまだ保存していなかったもの |
| クラッシュ、停電、計画外の再起動 | 最後の down() 以降のすべて |
| バックアップ、フォーク | ボリュームはイメージに含まれません。フォークの up() は親の最後の保存から復元します |
ボリュームがマウントされている間、up() と down() は REDIACC_RAM_DIR を受け取ります。up() では $REDIACC_RAM_DIR/.restored がない場合だけ復元し、down() ではサービスを停止したあとに保存する、というのが基本の形です。
up() {
if [ -n "$REDIACC_RAM_DIR" ] && [ ! -e "$REDIACC_RAM_DIR/.restored" ]; then
mkdir -p "$REDIACC_RAM_DIR/data"
if [ -d data-saved ]; then cp -a data-saved/. "$REDIACC_RAM_DIR/data/" || return 1; fi
touch "$REDIACC_RAM_DIR/.restored"
fi
renet compose -- up -d
}
down() {
renet compose -- down
if [ -n "$REDIACC_RAM_DIR" ]; then
rm -rf data-saved.new && cp -a "$REDIACC_RAM_DIR/data" data-saved.new \
&& rm -rf data-saved && mv data-saved.new data-saved
fi
}
フォーク
既存のリポジトリを現在の状態でコピーします。
rdc repo fork my-app --tag staging
フォークはname:tagモデルを使用します。作成されたフォークは my-app:staging という名前になります。これにより、親の名前を共有しながら、独自のGUIDとネットワークIDを持つ新しい暗号化コピーが作成されます。フォークは親と同じLUKSクレデンシャルを共有します。
フォークはBTRFS reflinkを通じて親のデータを共有します。ディスク上に保存されたクレデンシャルも含まれます。それらのクレデンシャルがStripe、AWS、Railwayなどの外部サービスを認証する場合の影響については、Rediaccが隔離しないものを参照してください。デプロイ時のクレデンシャルをフォークからアクセスできないようにするには、リポジトリ内の
.envファイルに値を埋め込む代わりにリポジトリシークレットを使用してください。
フォーク作成時に、repo fork はボリュームをアンロックせずに即座に <datastore>/.interim/state/<fork-guid>/.rediacc.json にステートミラーサイドカーを書き込みます。これにより、新しいフォークは作成された瞬間から is_fork: true として正しく識別されます。一度もマウントされていなくても、スケジュールされたバックアップはフォークをスキップできます(フォークはデフォルトでアップロードパイプラインから除外されます)。フォークのフォークを作成する場合、grand_guid は正しくチェーンされます。新しいフォークのミラーは、中間フォークのGUIDではなく、元のグランド親のGUIDを指します。
1ステップでフォークして起動
--up はフォーク、マウント、サービス起動をリモートで一括実行します。--no-wait を追加すると、コンテナが起動した時点でターミナルに制御が戻ります。ヘルスチェックはバックグラウンドで完了し、プロキシは各サービスがバインドするまで再試行を続けます。
rdc repo fork my-app --tag staging --up
rdc repo fork my-app --tag scratch --up --no-wait
実測値として、128 GB のリポジトリをフォークしてサービスが稼働状態に達するまで約 57 秒、--no-wait では約 31 秒でした。デタッチ実行は進捗確認のヒントを出力します:rdc machine status <machine> --containers。
時間の内訳
数秒を超える実行が完了すると、タイミングサマリーが表示されます。ステップごとの所要時間、並列実行の様子を示すウォーターフォール、そして Rediacc パイプライン部分とサービス自体の起動時間を分けた帰属行です。
Rediacc pipeline 19.2s (61%) · service startup 12.3s (39%)
サービス起動はコンテナのブート、イメージ取得、init、ヘルスチェックを含み、Rediaccfile の定義に従ってアプリごとに変わります。チャートはインタラクティブなターミナルで描画されます。パイプ出力でも強制表示するには RDC_TIMING_CHART=1 を設定してください。
Gitのようなバージョニング
フォークはgitのコミットのように機能できます。rdc repo commit は作業中のフォークを不変のバイト安定コミットにフリーズし、rdc repo branch は履歴の系列に名前を付け、rdc repo checkout はコミットを書き込み可能なフォークにリフリンク複製し、rdc repo log は親チェーンをたどり、rdc repo merge はライブリポジトリをその場で変更することなく2つの系列を結合します。rdc repo fork --immutable は1ステップでコミット相当のベースを作成します。
rdc repo commit my-app:work --message "schema migration applied"
rdc repo branch my-app:work --branch staging
rdc repo checkout staging --from my-app:work --tag staging-copy
完全なコマンドセット、オプション、および実践例については Gitのようなブランチングリファレンス を参照してください。
シークレット
リポジトリシークレットは、暗号化リポジトリイメージに書き込まれることなくコンテナに注入されるデプロイ時のクレデンシャルです。リポジトリのデータとは別の層に保持されるため、rdc repo fork では伝播されません。フォークは空のシークレットマップから始まり、そのコンテナは親とは異なる外部プリンシパルとして起動します。
ステップバイステップのガイドをご希望の場合は、set/list/deploy/verify/rotateの全サイクルについてシークレット管理チュートリアルを参照してください。
書き込み専用モデル(GitHubスタイル): get はSHA-256ダイジェストのみを返します。平文の値は人間にもエージェントにも返されません。値を忘れた場合は、パスワードマネージャーで確認してローテーションしてください。設計上、Rediaccから値を読み戻すことはできません。これにより、ターミナル記録、シェル履歴、誤ったリダイレクト、ショルダーサーフィンなど、漏洩の一類型全体が排除されます。
2つの配信モード:
env: シークレットはターゲットマシンのrenetシェルでREDIACC_SECRET_<KEY>としてエクスポートされます。docker-compose.ymlから${REDIACC_SECRET_<KEY>}補間で参照します。コンテナの環境内で可視なので、アプリケーションがすでにenvで期待している接続文字列形式の値に使用してください。file: シークレットはホスト上の/var/run/rediacc/net-<networkID>/secrets/<KEY>に書き込まれます(tmpfs、永続化されません)。composeファイルからは、file:ソースを持つトップレベルのsecrets:宣言とサービスごとのsecrets:リストで参照します。コンテナは/run/secrets/<key>から読み取ります。機密性の高いものにはこのモードを使用してください。docker inspectや/proc/<pid>/environには表示されません。
# Set, list, get(ダイジェストのみ), unset
rdc repo secret set my-app --key STRIPE_LIVE_KEY --value sk_live_xxx --mode file --current ""
rdc repo secret set my-app --key DB_HOST --value postgres.internal --mode env --current ""
rdc repo secret list my-app
rdc repo secret get my-app --key DB_HOST # → { key, mode, digest } — 値なし
rdc repo secret unset my-app --key STRIPE_LIVE_KEY --current sk_live_xxx
対称変更ゲート。 人間もエージェントも、シークレットを上書きまたは削除するには --current <前回の値> が必要です(passwd形式の前提条件)。新しいキーの初回書き込みには --current ""(空)を渡します。前回の値を検証せずにローテーションするには --rotate-secret を使用します。これはローテーションとして大々的に監査されます。--current と --rotate-secret は相互排他的です。
シェル履歴への露出を避けるため、argvの代わりにstdinから読み取るには --value - を渡します。
docker-compose.yml での使用例:
services:
api:
image: myapp
environment:
DATABASE_HOST: ${REDIACC_SECRET_DB_HOST}
secrets:
- stripe_live_key
secrets:
stripe_live_key:
file: /var/run/rediacc/net-${REDIACC_NETWORK_ID}/secrets/STRIPE_LIVE_KEY
サービス側の小文字の参照(stripe_live_key)はコンテナ内の /run/secrets/<name> ファイル名です。ホストパスの大文字の末尾部分(STRIPE_LIVE_KEY)は --key で設定した値と一致します。${REDIACC_NETWORK_ID} は renet compose によって自動的に補間されます。
クロスリポジトリ隔離の強制: renetのcomposeバリデーターは、他のリポジトリのネットワークIDを参照する
secrets: file:(およびconfigs: file:、env_file:)パスを拒否します。/var/run/rediacc/net-<N>/secrets/...参照として受け入れられる形式はリテラルの${REDIACC_NETWORK_ID}トークン(または自分のネットワークの整数)のみです。--unsafeはこのチェックを上書きしません。RediaccfileのBashサブプロセスを囲むLandlockサンドボックスも、自分のネットワークのシークレットディレクトリのみにファイルシステムアクセスをスコープするため、Rediaccfileからの悪意あるcat /var/run/rediacc/net-<other>/secrets/Xはカーネル層でEACCESで失敗します。
フォーク:
rdc repo forkはシークレットをコピーしません。フォークでシークレットを使用するには、フォークに対してrdc repo secret set <fork>を明示的に実行します。これは重要な安全特性です。フォークのコンテナは、外部サービスに対して本番プリンシパルとして動作できるべきではありません。
エージェント(Claude Code、Cursorなど):
repo secret listとrepo secret getはMCPツールとして公開されています(読み取り安全。名前とダイジェストのみ、値は含まれません)。setとunsetはCLI専用です。--current/--rotate-secretの確認手順は人間の目視が必要なためです。シェル経由でこれらを呼び出すエージェントも人間と同じゲートを受けます。前提条件が失敗した場合、JSONエンベロープには構造化されたerrors[].next.options[].runフィールドが含まれます。エージェントはそれらのコマンドをそのままユーザーに伝えてください。完全なモデルについてはAIエージェントの安全性を参照してください。
検証
リポジトリのファイルシステムの整合性を確認します。
rdc repo admin validate my-app
所有権
リポジトリ内のファイル所有権をユニバーサルユーザー(UID 7111)に設定します。これは通常、ワークステーションからファイルをアップロードした後に必要です。アップロードされたファイルはローカルのUIDで到着するためです。
rdc repo admin ownership my-app
このコマンドはDockerコンテナのデータディレクトリ(書き込み可能なバインドマウント)を自動的に検出し、除外します。これにより、独自のUIDでファイルを管理するコンテナ(例: MariaDB=999、www-data=33)が壊れることを防ぎます。
| オプション | 説明 |
|---|---|
--uid <uid> | 7111の代わりにカスタムUIDを設定する |
--skip-router-restart | 操作後にルートサーバーの再起動をスキップする |
コンテナデータを含む全ファイルに所有権を強制するには:
rdc repo admin ownership my-app
プロジェクト移行時に所有権をいつどのように使用するかの完全なガイドは、移行ガイドを参照してください。
テンプレート
テンプレートを適用してリポジトリをファイルで初期化します。
rdc repo admin template apply my-app --template my-template --file ./my-template.tar.gz
削除
リポジトリとその中のすべてのデータを永久に破棄します。
rdc repo delete my-app
これにより暗号化ディスクイメージが永久に破棄されます。この操作は元に戻せません。
リポジトリの移行
あるマシンから別のマシンにリポジトリをライブ移行します。唯一のダウンタイムは最終デルタシンク段階であり、カットオーバー時の書き込みレートに応じて通常は数秒から数分です。
rdc repo migrate my-app@server-1 --to server-2
| オプション | 説明 |
|---|---|
--provision | 移行前にターゲットマシンにリポジトリをプロビジョニングする(LUKSイメージを作成し設定を登録する) |
--checkpoint | カットオーバー前に実行中コンテナのCRIUチェックポイントを作成する |
--bwlimit <kbps> | rsyncの帯域幅をキロバイト毎秒で制限する |
--skip-dns | カットオーバー後にDNSレコードの更新をスキップする |
3フェーズのフロー:
- ホットプリコピー - リポジトリがソースで稼働したままrsyncがデータを転送します。ダウンタイム前に大きなファイルを転送します。
- カットオーバー - リポジトリがソースで停止し、最終rsyncパスで残りの変更を同期してから、リポジトリがターゲットで起動します。
- ターゲットでの起動 - renetがターゲットマシンでリポジトリをマウントして起動します。
--skip-dnsが指定されない限りDNSが更新されます。
pushと移行の比較:
repo push | repo migrate | |
|---|---|---|
| 操作 | コピー | 移動 |
| 操作後のソース | 変更なし | 停止 |
| ダウンタイム | なし(コピーのみ) | 短いカットオーバーウィンドウ |
| DNS更新 | なし | あり(--skip-dns を指定しない場合) |
| ユースケース | バックアップ、ステージングクローン | マシン交換、サーバー移動 |
プルーニング
リポジトリを削除したり、失敗した操作から復旧したりした後、孤立したマウントディレクトリ、ロックファイル、移動不能なマーカーが残ることがあります。プルーニングはこれらを安全に削除します。
# 削除されるものをプレビュー
rdc machine prune server-1 --dry-run
# 孤立したリソースを削除
rdc machine prune server-1
対応するリポジトリイメージが存在しないリソースのみが対象となります。空でないマウントディレクトリは削除されません。