k2works/orchestrating-operation

運用フェーズオーケストレーション

運用フェーズ全体の作業を支援します。環境構築からデプロイ設定、運用スクリプト作成までの包括的なワークフローを提供します。

Instructions

1. 運用フェーズの全体像

運用フェーズは「構築」と「配置」の 2 つの活動で構成されます。各環境の構築作業では、環境固有の手順書を作成・参照しながら進めます。

構築 → 配置 → ドキュメント更新

構築

環境の準備とインフラの整備を行います。

1. 環境構築 — 各環境のセットアップ
2. プロビジョニング — IaC によるインフラ管理
3. CI/CD 構築 — パイプラインの設計と実装
4. 運用スクリプト作成 — 各環境のタスクランナー・自動化スクリプト

配置

アプリケーションのビルドとデプロイを行います。

1. デプロイ設定 — デプロイ戦略の設計と実装

2. 環境構築の段階的フロー

環境構築は以下の順序で段階的に進めます。各環境のセットアップ時には対応するテンプレートを参照し、手順書を作成します。

アプリケーション開発環境 → 開発環境 → ステージング環境 → 本番環境

| 段階 | 環境 | 目的 | 手順書テンプレート | |------|------|------|------------------| | 1 | アプリケーション開発環境 | ローカル開発の効率化 | @docs/template/アプリケーション開発環境セットアップ手順書.md | | 2 | 開発環境 | チーム共有の動作確認環境 | @docs/template/開発環境セットアップ手順書.md | | 3 | ステージング環境 | 本番相当のテスト環境 | @docs/template/AWSステージング環境セットアップ手順書.md | | 4 | 本番環境 | プロダクション環境 | @docs/template/AWSプロダクション環境セットアップ手順書.md |

各環境のセットアップ完了後、運用スクリプトを作成し、ドキュメントを更新します。

3. プロビジョニング

IaC（Infrastructure as Code）によるインフラ管理を行います。

主要な活動:

• Terraform / CloudFormation 等によるインフラ定義
• 状態管理（S3 + DynamoDB 等）
• モジュール化とコードの再利用
• テスト（LocalStack / Terratest 等）

プロビジョニングのサイクル:

インフラコード作成 → plan → apply → テスト → ドキュメント更新

4. CI/CD 構築

継続的インテグレーション・デプロイのパイプラインを構築します。

主要な活動:

• CI パイプライン設計（ビルド・テスト・品質チェック）
• CD パイプライン設計（デプロイ自動化）
• OIDC 認証によるセキュアな CI/CD 連携
• 環境別のデプロイ戦略

5. デプロイ設定

各環境へのデプロイ戦略を設計・実装します。

| デプロイ方式 | 説明 | 用途 | |-------------|------|------| | ローリングデプロイ | 段階的にインスタンスを更新 | ECS / Kubernetes | | Blue/Green | 新旧環境を切り替え | RDS アップグレード等 | | Docker イメージ配布 | Registry 経由でイメージをプル | 開発環境サーバー |

6. 運用スクリプト作成

各環境の構築・デプロイ・管理を自動化するスクリプトを作成します。

@docs/reference/運用スクリプト作成ガイド.md に従い、ネーミングルール・ディレクトリ構成・実装スタイルを統一します。

作成タイミング: 各環境のセットアップ完了時に、その環境の運用スクリプトを作成します。

スクリプトの種類:

• 環境構築・セットアップ
• ビルド・プッシュ
• デプロイ・ロールバック
• ステータス確認・ログ取得
• バックアップ・リストア
• クリーンアップ

7. 実行手順

運用フェーズを開始する際の推奨手順:

1. 現状確認: 既存の環境・インフラ・ドキュメントを確認
2. 環境計画: 必要な環境と構築順序を決定
3. 手順書作成: テンプレートを基に環境ごとの手順書を作成
4. 環境構築: 手順書に従い段階的に環境を構築（Skill: managing-operations）
5. CI/CD 構築: パイプラインの設計と実装
6. 運用スクリプト: タスクランナー・自動化スクリプトの作成
7. ドキュメント更新: 手順書・コマンドリファレンスの整備

8. コンテキスト管理

長時間の運用セッションでは Context limit reached エラーを回避するため、タスクの区切りごとに /compact を実施してコンテキストを圧縮する。

/compact を実施するタイミング:

• 環境 1 つのセットアップが完了したとき
• プロビジョニングの plan → apply サイクルが完了したとき
• CI/CD パイプラインの設計・実装が一段落したとき
• 運用スクリプト一式の作成が完了したとき
• コミット完了後、次の環境構築に着手する前

運用ルール:

1. /compact 実施前に、現在の作業状態と次の工程をメモとして出力する
2. /compact 実施後、次の工程の作業を継続する
3. 大規模な環境構築（例: AWS ステージング環境）では、リソースグループごとに /compact を検討する

9. 注意事項

• 前提条件: 分析フェーズで運用要件が定義済みであること
• 制限事項: 本番環境の構築・デプロイは十分な確認と承認のもとで実行
• 推奨事項: ステージング環境で十分に検証してから本番環境に適用

10. ベストプラクティス

1. 段階的構築: アプリ開発環境 → 開発環境 → ステージング → 本番の順序を厳守
2. IaC 優先: 手作業を最小限に抑え、インフラをコードで管理
3. テンプレート活用: 手順書テンプレートを基に環境固有の手順書を作成
4. 自動化徹底: 環境構築の各段階で運用スクリプトを作成
5. ドキュメント同期: 環境変更時は手順書・コマンドリファレンスを同時更新

関連スキル

• operating-setup : 環境構築の段階的実行
• operating-provision : IaC によるインフラプロビジョニング
• operating-cicd : CI/CD パイプライン構築
• operating-deploy : デプロイ・ロールバック
• operating-backup : バックアップ・リストア
• analyzing-operation : 運用要件の定義