ec2-backend-deployer

EC2 バックエンドデプロイヤー

承認されたスコープ

ユーザーの依頼と既存の承認の範囲内でのみ作業してください。このスキルを読み込んでも、新たな権限は付与されません。報告のみを求められた場合は報告のみにとどめ、依頼者が指定した対象、ホスト、プロバイダー、コストの上限を守ってください。スコープを拡大する前に確認し、これらの制限を委任先にも伝えてください。

契約

入力：

• 対象リポジトリ、デプロイの目的、承認済みの AWS アカウント／環境
• 既存の Docker、レジストリ、CI、ホストアクセスの設定

出力：

• スコープを限定したデプロイ設定、またはレビュー済みのデプロイ計画
• デプロイが承認されている場合のヘルスチェックの証拠

作成／変更するもの：

• 依頼されたセットアップの範囲内での Docker および CI の設定
• 対象と操作が承認されている場合に限る、リモートデプロイ状態

外部への副作用：

• 承認済みのデプロイに必要なレジストリ、CI、SSH、AWS の呼び出し

確認が必要な場合：

• 課金対象のインフラストラクチャを作成する前、シークレットを変更する前、または明示的に承認された対象と操作の範囲外にデプロイする前
• 依頼された変更の範囲を超えて既存のデプロイ設定を置き換える前

委任先：

• リポジトリのリリースおよびデプロイのゲートには deploy-app

使用する場面

次の場合に使用します：

• EC2 へのバックエンドデプロイ向けに CI/CD を設定する
• Docker ベースのデプロイを設定する
• 自動デプロイパイプラインを実装する
• NestJS、Next.js、Express のバックエンドをデプロイする
• コンテナレジストリとイメージ管理を設定する
• セキュアな EC2 アクセス（Tailscale）を設定する

クイックワークフロー

1. Dockerfile：マルチステージビルド（base → builder → production）
2. レジストリ：GitHub Container Registry（ghcr.io）を推奨
3. CI/CD：セキュアな SSH 接続に Tailscale を使用する GitHub Actions
4. デプロイ：ヘルスチェックを備えた EC2 上の Docker Compose
5. 検証：ヘルスエンドポイントとデプロイの検証

主なコンポーネント

Docker

• イメージを小さくするマルチステージビルド
• セキュリティのための非 root ユーザー
• コンテナオーケストレーション用の HEALTHCHECK
• 機密データ用の BuildKit シークレット

GitHub Actions

• イメージのビルドに docker/build-push-action
• セキュアなアクセスに tailscale/github-action
• デプロイに appleboy/ssh-action

EC2

• Docker Compose v2 が必要です
• ヘルスチェックの検証
• ロールバック手順

参考資料

• 完全ガイド：Dockerfile、CI/CD ワークフロー、デプロイ、トラブルシューティング