メインコンテンツにスキップ ナビゲーションにスキップ フッターにスキップ

リポジトリ

リモートマシン上のLUKS暗号化リポジトリの作成、管理、操作。

リポジトリ

リポジトリとは、リモートサーバー上の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-step1回の拡張で追加する容量: 絶対値(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-maxCPU 上限。コア数(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フェーズのフロー:

  1. ホットプリコピー - リポジトリがソースで稼働したままrsyncがデータを転送します。ダウンタイム前に大きなファイルを転送します。
  2. カットオーバー - リポジトリがソースで停止し、最終rsyncパスで残りの変更を同期してから、リポジトリがターゲットで起動します。
  3. ターゲットでの起動 - renetがターゲットマシンでリポジトリをマウントして起動します。--skip-dns が指定されない限りDNSが更新されます。

リポジトリライブ移行

pushと移行の比較:

repo pushrepo migrate
操作コピー移動
操作後のソース変更なし停止
ダウンタイムなし(コピーのみ)短いカットオーバーウィンドウ
DNS更新なしあり(--skip-dns を指定しない場合)
ユースケースバックアップ、ステージングクローンマシン交換、サーバー移動

プルーニング

リポジトリを削除したり、失敗した操作から復旧したりした後、孤立したマウントディレクトリ、ロックファイル、移動不能なマーカーが残ることがあります。プルーニングはこれらを安全に削除します。

# 削除されるものをプレビュー
rdc machine prune server-1 --dry-run

# 孤立したリソースを削除
rdc machine prune server-1

対応するリポジトリイメージが存在しないリソースのみが対象となります。空でないマウントディレクトリは削除されません。