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

rdc vs renet

rdc を使う場面と renet を使う場面。

rdc vs renet

Rediaccには2つのバイナリがあります。それぞれの使い分けを説明します。

rdcrenet
実行環境ワークステーションリモートサーバー
接続方法SSHローカルでroot権限で実行
対象ユーザーすべてのユーザー高度なデバッグのみ
インストールユーザーがインストールrdcが自動的にプロビジョニング

日常的な作業にはrdcを使用してください。renetを直接使用する必要はほとんどありません。

連携の仕組み

rdcはSSH経由でサーバーに接続し、renetコマンドを代行実行します。ワークステーションで1つのコマンドを入力するだけで、rdcが残りの処理を行います:

  1. ローカル設定(~/.config/rediacc/rediacc.json)を読み取る
  2. SSH経由でサーバーに接続する
  3. 必要に応じてrenetバイナリを更新する
  4. サーバー上で対応するrenet操作を実行する
  5. 結果をターミナルに返す

通常の作業にはrdcを使用

すべての一般的なタスクはワークステーション上のrdcを通じて実行します:

# 新しいサーバーをセットアップ
rdc config machine setup --name server-1

# リポジトリを作成して起動
rdc repo create --name my-app -m server-1 --size 10G
rdc repo up --name my-app -m server-1 --mount

# リポジトリを停止
rdc repo down --name my-app -m server-1

# マシンの健全性を確認
rdc machine health server-1

完全なウォークスルーについては、クイックスタートを参照してください。

サーバーサイドのデバッグにはrenetを使用

renetを直接使用する必要があるのは、以下の目的でサーバーにSSH接続する場合のみです:

  • rdcが接続できない場合の緊急デバッグ
  • rdcを通じて利用できないシステム内部の確認
  • 低レベルの復旧操作

すべてのrenetコマンドにはroot権限(sudo)が必要です。renetコマンドの完全なリストについては、サーバーリファレンスを参照してください。

実験的機能:rdc ops(ローカルVM)

rdc opsは、ワークステーション上でローカルVMクラスターを管理するためにrenet opsをラップします:

rdc ops setup              # 前提条件をインストール(KVMまたはQEMU)
rdc ops up --basic         # 最小構成のクラスターを起動
rdc ops status             # VMステータスを確認
rdc ops ssh --vm-id 1  # ブリッジVMにSSH接続
rdc ops ssh --vm-id 1 -c hostname  # ブリッジVM上でコマンドを実行
rdc ops down               # クラスターを破棄

ローカルアダプターが必要です。クラウドアダプターでは利用できません。

これらのコマンドはrenetをローカルで実行します(SSH経由ではありません)。完全なドキュメントについては、実験的VMを参照してください。

Rediaccfileに関する注意

Rediaccfile内でrenet compose -- ...が使われているのを目にすることがあるかもしれません。これは正常です。Rediaccfileの関数はrenetが利用可能なサーバー上で実行されます。

ワークステーションからは、rdc repo uprdc repo downを使用してワークロードを起動・停止してください。