Rediaccでマシンをセットアップする方法
すべてのRediaccデプロイは、構成プロファイルと登録済みマシンから始まります。このチュートリアルでは、構成の作成、リモートサーバーの登録、SSH接続の検証、環境診断の実行、インフラストラクチャネットワークの構成を行います。完了すると、マシンはリポジトリのデプロイに対応できる状態になります。
前提条件
rdcCLIがインストール済み- SSH経由でアクセス可能なリモートサーバー（またはローカルVM）
- サーバーに認証できるSSH秘密鍵
インタラクティブ録画
ステップ1: 新しい構成を作成
構成プロファイルは、マシン定義、SSH認証情報、インフラストラクチャ設定を保存します。この環境用に1つ作成します。
rdc config init --name tutorial-demo --ssh-key ~/.ssh/id_ed25519これにより、~/.config/rediacc/tutorial-demo.jsonに名前付き構成ファイルが作成されます。
ステップ2: 構成を表示
新しいプロファイルが構成リストに表示されることを確認します。
rdc config list利用可能なすべての構成を、アダプタータイプ（ローカルまたはクラウド）とマシン数とともに一覧表示します。
ステップ3: マシンを追加
IPアドレスとSSHユーザーを指定してマシンを登録します。CLIはssh-keyscanを介してサーバーのホストキーを自動的に取得・保存します。
rdc config machine add --name bridge-vm --ip 192.168.111.1 --user muhammed --config tutorial-demoステップ4: マシンを表示
マシンが正しく登録されたことを確認します。
rdc config machine list --config tutorial-demo現在の構成内のすべてのマシンを接続情報とともに表示します。
ステップ5: デフォルトマシンを設定
デフォルトマシンを設定すると、すべてのコマンドで-m bridge-vmを繰り返す必要がなくなります。
rdc config set --key machine --value bridge-vm --config tutorial-demoステップ6: 接続をテスト
何かをデプロイする前に、マシンがSSH経由でアクセス可能であることを確認します。
rdc term connect -m bridge-vm -c "hostname"
rdc term connect -m bridge-vm -c "uptime"両方のコマンドはリモートマシンで実行され、すぐに結果を返します。どちらかが失敗した場合は、SSHキーが正しいこととサーバーにアクセスできることを確認してください。
ステップ7: 診断を実行
rdc doctorローカル環境を確認します: CLIバージョン、Docker、renetバイナリ、構成ステータス、SSHキー、仮想化の前提条件。各チェックはOK、Warning、またはErrorを報告します。
ステップ8: インフラストラクチャを構成
公開サービスの場合、マシンにはネットワーク構成が必要です, 外部IP、ベースドメイン、TLS用の証明書メールアドレス。
rdc config infra set -m bridge-vm \
--public-ipv4 192.168.111.1 \
--base-domain test.local \
--cert-email admin@test.local構成を確認します:
rdc config infra show -m bridge-vm生成されたTraefikプロキシ構成をrdc config infra push bridge-vmでサーバーにデプロイします。
トラブルシューティング
“SSH key not found”または”Permission denied (publickey)”
config initに渡したキーパスが存在し、サーバーのauthorized_keysと一致することを確認してください。権限を確認: 秘密鍵ファイルは600である必要があります（chmod 600 ~/.ssh/id_ed25519）。
SSHコマンドで”Connection refused”
サーバーが実行中でIPが正しいことを確認してください。ポート22が開いているか確認: nc -zv <ip> 22。非標準ポートを使用している場合は、マシン追加時に--portを渡してください。
“Host key verification failed”
保存されたホストキーがサーバーの現在のキーと一致しません。これはサーバーの再構築やIPの再割り当て後に発生します。rdc config machine scan-keys <machine>を実行してキーを更新してください。
次のステップ
構成プロファイルの作成、マシンの登録、接続の検証、インフラストラクチャネットワークの構成が完了しました。アプリケーションをデプロイするには:
- マシンセットアップ, すべての構成およびセットアップコマンドの完全なリファレンス
- チュートリアル: リポジトリライフサイクル, リポジトリの作成、デプロイ、管理
- クイックスタート, コンテナ化されたアプリケーションをエンドツーエンドでデプロイ