バグ修正タスク起票テンプレート¶

1. バグ概要¶

• 発生環境：VPS-ROOT (Ubuntu 24.04.2 LTS)
• 発生条件：vps-statusコマンド実行時
• 再現手順：vps-statusコマンドを実行すると、「Could not resolve hostname vps-main: Temporary failure in name resolution」エラーが発生
• 影響範囲：システム状態監視機能、チケット作成後のステータス確認

2. 切り戻し準備¶

• 最新バックアップ日時：2025-06-07 00:51:00
• バックアップ場所：/root/mcp-ubuntu-production/workspace/vps-status
• 復元手順の確認：完了 [x]

3. ゴール確認¶

• 修正目標：vps-statusコマンドがホスト名解決エラーなく正常に実行されるようにする
• 期待される動作：システム状態（Docker、Nginx、ディスク使用量など）が正確に取得・表示される
• 完了条件：SSHホスト名解決エラーなしでvps-statusコマンドが実行できること

4. 前提確認¶

インフラ構成¶

• VPS-root構成状態：Ubuntu 24.04.2 LTS
• 動作中コンテナ：redmine-mcp, redmine-prod
• 関連サービスの状態：SSH、Hostname Resolution

バージョン管理¶

• Gitリポジトリ：/root/mcp-ubuntu-production
• ブランチ戦略：master
• 現在のブランチ：master

関連リソース¶

• 関連チケット：#287, #289, #292
• エラーログ：ssh: Could not resolve hostname vps-main: Temporary failure in name resolution
• モニタリング情報：vps-statusコマンド出力

5. 修正方針¶

• 原因分析：
  1. vps-statusスクリプト内で「vps-main」というホスト名に対してSSH接続を試みている
  2. このホスト名は/etc/hostsに定義されておらず、DNSでも解決できない
  3. 結果としてSSHのホスト名解決エラーが発生している
• 修正アプローチ：
  1. 「vps-main」ホスト名をIPアドレスに置き換える
  2. /etc/hostsファイルに「vps-main」のエントリを追加する
  3. vps-statusスクリプトを修正して、ローカル環境で直接コマンドを実行するようにする
• 対応優先度の判断理由：システム監視機能に影響するため、中優先度で対応

6. 修正設計¶

• 影響を受けるコンポーネント：
  • /root/mcp-ubuntu-production/workspace/vps-status
  • /etc/hosts（オプション）
• 変更が必要なコード：
  • vps-statusスクリプト内の「ssh vps-main」コマンドを修正
• 副作用の可能性：システム状態監視方法の変更による影響

7. 試験仕様¶

• 再現テスト：現状のvps-statusコマンドを実行して、ホスト名解決エラーが発生することを確認
• 修正確認テスト：修正後のvps-statusコマンドを実行して、エラーなく全ての情報が表示されることを確認
• 回帰テスト：チケット作成時のvps-status実行で問題が発生しないことを確認

8. デプロイ方法¶

• デプロイ手順：
  1. vps-statusスクリプトをバックアップ
  2. スクリプトを修正
  3. テスト実行
• リリースタイミング：即時
• ロールバック手順：バックアップから元のスクリプトを復元

9. 成果物と残課題¶

• 作成する成果物：修正済みvps-statusスクリプト
• 修正後のモニタリング計画：vps-statusコマンドの出力を確認
• 残課題：より堅牢なシステム監視方法の検討

タスク管理¶

• 担当者：システム管理者
• 優先度：中
• 完了予定日：2025-06-10
• 工数見積：0.5人日

コミュニケーション¶

• 進捗報告方法：Redmineチケットへのコメント
• レビュアー：開発チーム
• 関係者への通知：システム管理チーム