feat: 個別サーバー作成用のRakeタスクとサーバー状況確認タスクのメッセージ改善

[yasulab]

概要

個別サーバー作成用のRakeタスクを追加し、CI/CDを待たずに特定のサーバーをテスト作成できるようにしました。
また、セキュリティ設計とコード品質の大幅な改善を実施しました。

主な変更点

1. ✅ 個別サーバー作成タスク (server:create)

• 特定のサーバーを個別に作成可能
• 既存のdeploy.rbのロジックを再利用（DRY原則）
• テスト環境での動作確認に最適

2. ✅ サーバーリストの改善 (server:list)

• NEW: リアルタイムのサーバーステータスを表示（✅ up / ⏸️ down / 🧹 cleaning）
• API認証情報がない場合は説明メッセージを表示
• API接続エラー時もリストの表示を継続

3. 🔒 セキュリティ設計の文書化

• 多層防御（Defense in Depth）戦略を詳細に文書化
• パケットフィルターとiptablesの二層構成を説明
• パケットフィルター確認ツール（check_packet_filter.rb）を追加

4. 🎯 大規模リファクタリング（DRY原則）

• SakuraServerUserAgentクラスにデフォルトパラメータを実装
  • zone: '31002' (石狩第二)
  • packet_filter_id: '112900922505'
• 7つのユーティリティスクリプトから52行の重複コードを削除
• ハードコーディングされた値を1箇所に集約

5. ✨ コード品質の向上

• マジックナンバー60をSEPARATOR_WIDTH定数に置き換え
• 自動デプロイのコミットメッセージを簡潔化
• YAGNI原則に基づき不要なrecreateタスクを削除

使用方法

個別サーバーの作成

# サーバーを個別に作成（servers.csvに登録済みのものが対象）
bundle exec rake "server:create[coderdojo-japan]"

サーバーリストの確認（ステータス付き）

# サーバー一覧をステータス付きで表示
bundle exec rake server:list

パケットフィルター設定の確認

# セキュリティ設定を確認
ruby scripts/utils/check_packet_filter.rb

変更ファイル

追加

• docs/security-defense-in-depth.md - セキュリティ設計文書
• scripts/utils/check_packet_filter.rb - パケットフィルター確認ツール

修正（リファクタリング）

• Rakefile - server:create, server:list タスクの追加・改善
• scripts/sakura_server_user_agent.rb - デフォルトパラメータの実装
• scripts/initialize_server.rb - ハードコーディング削除
• scripts/utils/*.rb - 全7ファイルでデフォルト値を活用

テスト結果

• ✅ coderdojo-japanサーバーの削除・再作成でテスト済み
• ✅ 同一IPアドレス（133.242.227.219）が維持されることを確認
• ✅ サーバーステータス表示が正常に動作
• ✅ パケットフィルター設定の正常性を確認（SSH/HTTP/HTTPS開放）
• ✅ デフォルトパラメータが全スクリプトで正常動作

影響範囲

• 既存のCI/CDフローには影響なし
• 後方互換性を維持
• セキュリティ強化とコード品質向上

関連Issue

• サーバーの初期化依頼 #253 SSH接続の問題調査用にテスト機能が必要

[yasulab]

🐛 重要なバグ修正を追加

cloud-init対応を削除した際に発生したスタートアップスクリプトが実行されない問題を修正しました。

問題の詳細

• cloud-init削除時（ b64d768 ）にスタートアップスクリプトの実行も削除されていた
• disk/config APIのNotesフィールドは単なるメモで、スクリプト実行のトリガーではなかった
• 結果として：
  • ❌ iptables設定が適用されない
  • ❌ SSH強化設定が適用されない
  • ❌ Ansibleがインストールされない

修正内容

1. サーバー起動時（/power API）にNotesパラメータでスタートアップスクリプトIDを指定
2. notesパラメータをinitializeメソッドに追加（デフォルト値付き）

デフォルト値の設計

パラメータ	デフォルト値	用途
zone	"31002"	石狩第二ゾーン
packet_filter_id	'112900922505'	ファイアウォール
notes	[{ID: 112900928939}]	スタートアップスクリプト（新規追加）

これにより、セキュリティ設定がデフォルトで確実に適用されるようになりました。

関連: #253 SSH接続問題の根本原因の一つ

[yasulab]

📁 テストファイルの整理

scripts/utils/test_*.rb を test/integration/ ディレクトリに移動し、テスト構造を整理しました。

変更内容

• 統合テスト（実際のAPI呼び出し）を test/integration/ に分離
• ユニットテストと統合テストの明確な分離
• test/README.md を追加してテスト構造を文書化

新しいディレクトリ構造

test/
├── README.md                  # テストガイド
├── csv_test.rb               # ユニットテスト
├── ip_validation_test.rb     # ユニットテスト
└── integration/              # 統合テスト（API使用）
    ├── test_regex_patterns.rb
    ├── test_server_with_notes.rb
    ├── test_with_packet_filter.rb
    └── test_with_startup_script.rb

これによりテストの種類が明確になり、保守性が向上しました。