qwencloud-operate

Qwen Cloud Operate

Alibaba Cloud International に qwencloud-deploy でデプロイされたアプリケーションの障害診断と、確認を得たうえでの復旧を行います。診断は読み取り専用で、確認は不要です。クラウドまたはアプリケーションの状態を変更する操作には、明示的な確認が必要です。

Interaction Flow

Identify app & resources
→ Minimal diagnosis (read-only)
→ Give cause, evidence, recommended action
→ Show impact and request confirmation
→ Execute one recovery action
→ Verify application, ECS, RDS
→ Return result + audit info
→ Offer to re-score via qwencloud-observe (before → after)

Interaction form

• 読み取り専用の情報（診断、原因、証拠、検証）：プレーンテキストで提示し、各判断の後に証拠を1行（メトリクス、ステータス、RequestId）示します。
• 状態を変更する操作（ECS の起動／停止、アプリケーションの再起動、Nginx の再読み込みなど、書き込みを伴う呼び出し）：最初に AskUserQuestion を行い、その質問で操作内容・影響（ダウンタイム／不可逆性）・検証方法を説明します。確認を得る前に何も実行せず、復旧操作は一度に1つだけ提案します。
• 先回りした対応の原則：復旧後、正常な状態であれば静かに終了します。リスクが残る場合、または復旧に失敗した場合に限って次の手順を伝え、ユーザーに選択してもらいます。

Scope

対象範囲	対象外
qwencloud-deploy でデプロイされたアプリケーション（状態ファイルが存在するもの）	.qwencloud-deploy 状態ファイルがないアプリケーション
単一の ECS、または ECS ＋ RDS MySQL 8.0	その他のトポロジー／セルフマネージドサーバー
診断 ＋ 確認を得た復旧（ECS の起動、アプリケーションの再起動、Nginx の再読み込み）	データを破壊する操作、スケーリング、設定の再設計
アプリケーション層のエラーの特定（障害が発生した層とエラーの内容）	ソースコードのレビュー、バグや脆弱性の発見、誤りのある行の判断、コードの編集
Alibaba Cloud International	Aliyun China → qianwenai-operate を使用

Code issues are out of scope

このスキルが扱うのはインフラストラクチャと実行時の障害です。ソースコードのレビュー、欠陥の特定、コードの編集は行いません。診断では、原因を絞り込むためにアプリケーション層のエラーと発生した内容を特定できますが、誤りのある行を判断したり、コードを変更したりすることはありません。

コードが関係する場合は、このスキルの対象範囲外であるためコードの編集は行えず、ユーザー自身が変更を判断して実施する必要があり、結果についてもユーザー自身が責任を負うことを明確に伝えてください。復旧操作にコード変更を紛れ込ませてはいけません。

Prerequisites

Aliyun CLI：aliyun version（3.x が必要です）。すべてのコマンドで、プラグインに依存せず、OpenAPI に PascalCase のネイティブ形式で直接アクセスします。認証情報の確認には aliyun configure list のみを使用してください。 AK／SK／トークンを読み取ったり、エコーしたり、表示したり、尋ねたりしてはいけません。 有効なプロファイルがない場合は処理を中止し、このセッションの外で認証情報を設定するようユーザーに依頼してください。詳細は references/cli_installation_guide.md を参照してください。

How to work

1. .qwencloud-deploy からアプリケーションを特定します。ワークフローを参照してください。
2. 診断します（読み取り専用で、確認は不要です）。障害箇所、考えられる原因、証拠、および対応方法を特定します。診断を参照してください。
3. 確認を得て、1つの操作だけを実行して復旧します。診断結果に合った操作を選び、影響をユーザーに説明して承認を得た後、その操作だけを実行します。
   • 停止中のサーバーを起動する → recover-ecs
   • ハングしたサーバーを再起動する → recover-reboot
   • アプリケーションサービスを再起動する → recover-app
   • nginx -t の成功後に Nginx を再読み込みする → recover-nginx
   • EIP が未バインドの場合に再バインドする → recover-eip
   • セキュリティグループで 80／443 の受信を許可する → recover-securitygroup
   • データベース関連の問題 → recover-rds
   • 証明書の期限切れ／HTTPS ハンドシェイクの失敗 → recover-cert
   • ルートディスクの空き容量が少ない／クリーンアップ後も不足している（リサイズ） → recover-disk
4. アプリケーションが復旧したかを検証し、実施した内容を記録します。ワークフローを参照してください。

復旧の安全を保つルール

• 診断は読み取り専用です。復旧には、安全性が確認済みの限られた固定コマンドを使用します。
• 変更を加える操作はすべて、事前にユーザーの確認を得ます。キャンセルした場合、何も変更されません。
• 操作を1つ実行して検証し、その後で次の操作を判断します。復旧手順をまとめて実行することはありません。
• 復旧操作は繰り返し実行しても安全です。
• タイムアウト、権限エラー、または予期しない状態変化が発生した場合、それ以上の変更を加える前に停止します。
• パスワード、トークン、完全な接続文字列を監査記録やチャットに記載してはいけません。

変更を加える前に、確認時にユーザーへ次の内容を伝えます。対象のリソース、実行する操作、アプリが一時的に中断するかどうか、バージョンが変わるかどうか、新たな費用が発生するかどうか、検証方法、および失敗した場合の対応です。

必要な権限

references/ram_policies.mdを参照してください。読み取り：ecs:DescribeInstances、ecs:DescribeInvocations、ecs:DescribeSecurityGroupAttribute、ecs:DescribeDisks、vpc:DescribeEipAddresses、RDS の説明／パフォーマンス／スローログ。書き込み（復旧）：ecs:StartInstance、ecs:RebootInstance、ecs:AuthorizeSecurityGroup、ecs:ResizeDisk、vpc:AssociateEipAddress、ecs:RunCommand（許可リストにある復旧コマンドのみ）。証明書の再発行には、alidnsのレコード読み取り／書き込み権限も必要です（DNS-01 チャレンジ）。

詳細情報

手順を追ったガイドは、上記の「作業方法」からリンクされています。セットアップに関する参考資料は次の2つです。

• CLI のセットアップ — インストールと認証情報の確認。
• CLI の注意点 — パラメーターの形式、時刻の形式、レスポンスの解析。
• RAM ポリシー — このスキルに必要な権限。