トラブルシューティング

サーバーが起動しない

アプリケーションを実行しようとしてエラーメッセージが発生した場合：

• アドレス/ポートがすでに使用されています: 他のアプリケーションがポート 7080（デフォルト）を使用していないことを確認してください。--listenフラグを使用して、別のポートで実行します。

  kudashai --listen :8080

• アクセス拒否: 一部のOS（特に1024未満のポートへのバインドを試みる場合、または暗号化を伴う場合）では、管理者/ルートアクセスが必要になるか、ファイルの実行モードを調整する必要がある場合があります。

  chmod +x kudashai
  ./kudashai

Platformモードが接続できない

Kudashai Studioを通じてPlatformモードをアクティブにできない場合は、以下を確認してください：

• App Keyが無効: AwanIO Enterprise Portalから正しいApp Key（ライセンスキー）を入力していることを確認してください。キーの有効期限が切れている、または取り消されている場合は、管理者またはAwanIOサポートチームに連絡してください。
• ネットワーク接続: Kudashai Studioは、データベースをプロビジョニングするためにAwanIOバックエンドとの自動ハンドシェイクを実行します。マシンにアウトバウンドインターネットアクセスがあり、ファイアウォールやプロキシによってブロックされていないことを確認してください。
• ハンドシェイクタイムアウト: ハンドシェイクプロセスに時間がかかりすぎたり、サイレントに失敗する場合は、アプリケーションログで接続エラーを確認してください。Kudashaiアプリケーションを再起動して、アクティベーションを再試行してください。
• アクティベーション後にデータが表示されない: ハンドシェイクが成功してもクラスターデータが表示されない場合は、ログを確認してください。システムは、Platformモードが初めてアクティブになったときに自動移行を実行しようとします。

データを移動する際の資格情報に関する問題 (Standaloneモード)

Standaloneモードでは、クラスターの資格情報はローカルに保存され、コンピューター上のシステムによって自動的に生成される秘密キー（暗号化キー）を使用して安全に暗号化されます。

• 元の暗号化キーファイルを含めずにKudashaiアプリケーションデータファイルを別のコンピューターに移動した場合、新しいコンピューター上のKudashaiはクラスターの資格情報を読み取ることができません。
• 解決策: 一部のデータだけでなく、デフォルトのKudashai設定フォルダー全体をバックアップして移行するようにしてください。

AIトラブルシューティング支援

KudashaiがK8sポッドまたはサービスがエラー状態（ImagePullBackOff、CrashLoopBackOffなど）にあることを検出した場合、Kudashaiインターフェース上の組み込みの**"Ask AI"**ボタンを使用できます。内部のAIエージェントは、最近のログとメトリクスを分析して問題を診断し、解決を支援し、新しい設定オプションを提案することさえあります。