deployment-procedures
本番環境へのデプロイにおける原則と意思決定を支援します。安全なデプロイワークフロー、ロールバック戦略、デプロイ後の検証方法を扱い、単なる手順スクリプトではなく「考え方」そのものを習得できるよう導きます。
description の原文を見る
Production deployment principles and decision-making. Safe deployment workflows, rollback strategies, and verification. Teaches thinking, not scripts.
SKILL.md 本文
デプロイ手順
本番リリースのための安全なデプロイメント原則と意思決定 スクリプトを暗記するのではなく、考え方を学ぶ。
⚠️ このスキルの使い方
このスキルはデプロイメント原則を教えるもので、コピーするためのbashスクリプトではありません。
- すべてのデプロイメントはユニークです
- 各ステップの背景にある理由を理解してください
- 手順をあなたのプラットフォームに適応させてください
1. プラットフォーム選択
意思決定ツリー
何をデプロイしていますか?
│
├── 静的サイト / JAMstack
│ └── Vercel, Netlify, Cloudflare Pages
│
├── シンプルなウェブアプリ
│ ├── マネージド → Railway, Render, Fly.io
│ └── コントロール → VPS + PM2/Docker
│
├── マイクロサービス
│ └── コンテナオーケストレーション
│
└── サーバーレス
└── Edge functions, Lambda
各プラットフォームでは異なる手順があります
| プラットフォーム | デプロイ方法 |
|---|---|
| Vercel/Netlify | Git push, 自動デプロイ |
| Railway/Render | Git push または CLI |
| VPS + PM2 | SSH + 手動ステップ |
| Docker | イメージpush + オーケストレーション |
| Kubernetes | kubectl apply |
2. デプロイ前の原則
4つの検証カテゴリ
| カテゴリ | 確認内容 |
|---|---|
| コード品質 | テスト合格、linting合格、レビュー完了 |
| ビルド | 本番ビルド成功、警告なし |
| 環境 | 環境変数セット済み、シークレット最新版 |
| 安全性 | バックアップ完了、ロールバック計画準備完了 |
デプロイ前チェックリスト
- すべてのテストが合格している
- コードがレビュー・承認されている
- 本番ビルドが成功している
- 環境変数が検証されている
- データベースマイグレーション準備完了(あれば)
- ロールバック計画が文書化されている
- チームに通知済み
- モニタリング準備完了
3. デプロイメントワークフロー原則
5段階プロセス
1. 準備
└── コード、ビルド、環境変数を検証
2. バックアップ
└── 変更前に現在の状態を保存
3. デプロイ
└── モニタリングを開いた状態で実行
4. 検証
└── ヘルスチェック、ログ、主要フロー確認
5. 確認またはロールバック
└── 良好? 確認。 問題? ロールバック。
段階別原則
| 段階 | 原則 |
|---|---|
| 準備 | テストされていないコードはデプロイしない |
| バックアップ | バックアップなしではロールバックできない |
| デプロイ | 見守る、その場を離れない |
| 検証 | 信頼しても検証する |
| 確認 | ロールバック トリガーを用意しておく |
4. デプロイ後の検証
検証内容
| チェック項目 | 理由 |
|---|---|
| ヘルスエンドポイント | サービスが実行中 |
| エラーログ | 新しいエラーがない |
| 主要なユーザーフロー | 重要な機能が動作している |
| パフォーマンス | レスポンスタイムが許容範囲内 |
検証ウィンドウ
- 最初の5分: アクティブモニタリング
- 15分: 安定を確認
- 1時間: 最終検証
- 翌日: メトリクスを確認
5. ロールバック原則
ロールバックが必要な場合
| 症状 | 対応 |
|---|---|
| サービスダウン | 直ちにロールバック |
| 重大エラー | ロールバック |
| パフォーマンス >50% 低下 | ロールバック検討 |
| 軽微な問題 | 迅速に修正できればそのまま進める |
プラットフォーム別ロールバック戦略
| プラットフォーム | ロールバック方法 |
|---|---|
| Vercel/Netlify | 前のコミットを再デプロイ |
| Railway/Render | ダッシュボードでロールバック |
| VPS + PM2 | バックアップを復元、再起動 |
| Docker | 前のイメージタグを使用 |
| K8s | kubectl rollout undo |
ロールバック原則
- 速度を優先: ロールバック第一、デバッグは後
- エラーを複雑にしない: 1回のロールバック、複数の変更ではなく
- 通信: チームに何が起きたかを伝える
- ポストモーテム: 安定後になぜを理解する
6. ゼロダウンタイムデプロイメント
戦略
| 戦略 | 動作方法 |
|---|---|
| ローリング | インスタンスを1つずつ置換 |
| ブルーグリーン | 環境間でトラフィックを切り替え |
| カナリア | 段階的なトラフィック移行 |
選択原則
| シナリオ | 戦略 |
|---|---|
| 通常のリリース | ローリング |
| 高リスク変更 | ブルーグリーン(簡単なロールバック) |
| 検証が必要 | カナリア(実トラフィックでテスト) |
7. 緊急手順
サービスダウン優先順位
- 評価: 症状は何か?
- クイックフィックス: 不明な場合は再起動
- ロールバック: 再起動で解決しない場合
- 調査: 安定後に実施
調査順序
| チェック項目 | よくある問題 |
|---|---|
| ログ | エラー、例外 |
| リソース | ディスク満杯、メモリ不足 |
| ネットワーク | DNS、ファイアウォール |
| 依存関係 | データベース、API |
8. アンチパターン
| ❌ しない | ✅ する |
|---|---|
| 金曜日にデプロイ | 週の早い時期にデプロイ |
| 急いでデプロイ | 手順に従う |
| ステージングをスキップ | 常に事前テスト |
| バックアップなしでデプロイ | デプロイ前にバックアップ |
| デプロイ後に立ち去る | 15分以上監視する |
| 一度に複数の変更 | 1回に1つの変更 |
9. 意思決定チェックリスト
デプロイ前に確認:
- プラットフォーム適切な手順か?
- バックアップ戦略は準備できているか?
- ロールバック計画は文書化されているか?
- モニタリングは構成されているか?
- チームに通知済みか?
- デプロイ後に監視する時間があるか?
10. ベストプラクティス
- 大きなリリースよりも小さく頻繁なデプロイ
- リスクのある変更にはフィーチャーフラグを使用
- 繰り返しステップを自動化
- すべてのデプロイを文書化
- 問題後に何が悪かったかをレビュー
- 必要になる前にロールバックをテスト
覚えておいて: すべてのデプロイメントはリスクです。速度ではなく準備を通じてリスクを最小化してください。
いつ使うか
このスキルは、概要に説明されたワークフローまたはアクションを実行する場合に適用されます。
制限事項
- このスキルは、説明されたスコープと明確に一致する場合にのみ使用してください。
- 出力を環境固有の検証、テスト、または専門家レビューの代替として扱わないでください。
- 必要な入力、権限、安全性の境界、または成功基準が不明な場合は、一旦停止して明確化を求めてください。
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- sickn33
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/sickn33/antigravity-awesome-skills / ライセンス: MIT
関連スキル
superfluid
Superfluidプロトコルおよびそのエコシステムに関するナレッジベースです。Superfluidについて情報を検索する際は、ウェブ検索の前にこちらを参照してください。対応キーワード:Superfluid、CFA、GDA、Super App、Super Token、stream、flow rate、real-time balance、pool(member/distributor)、IDA、sentinels、liquidation、TOGA、@sfpro/sdk、semantic money、yellowpaper、whitepaper
civ-finish-quotes
実質的なタスクが真に完了した際に、文明風の儀式的な引用句を追加します。ユーザーやエージェントが機能追加、リファクタリング、分析、設計ドキュメント、プロセス改善、レポート、執筆タスクといった実際の成果物を完成させるときに、明示的な依頼がなくても使用します。短い返信や小さな修正、未完成の作業には適用しません。
nookplot
Base(Ethereum L2)上のAIエージェント向け分散型調整ネットワークです。エージェントがオンチェーンアイデンティティを登録する、コンテンツを公開する、他のエージェントにメッセージを送る、マーケットプレイスで専門家を雇う、バウンティを投稿・請求する、レピュテーションを構築する、共有プロジェクトで協業する、リサーチチャレンジを解くことでNOOKをマイニングする、キュレーションされたナレッジを備えたスタンドアロンオンチェーンエージェントをデプロイする、またはアグリーメントとリワードで収益を得る場合に利用できます。エージェントネットワーク、エージェント調整、分散型エージェント、NOOKトークン、マイニングチャレンジ、ナレッジバンドル、エージェントレピュテーション、エージェントマーケットプレイス、ERC-2771メタトランザクション、Prepare-Sign-Relay、AgentFactory、またはNookplotが言及された場合にトリガーされます。
web3-polymarket
Polygon上でのPolymarket予測市場取引統合です。認証機能(L1 EIP-712、L2 HMAC-SHA256、ビルダーヘッダー)、注文発注(GTC/GTD/FOK/FAK、バッチ、ポストオンリー、ハートビート)、市場データ(Gamma API、Data API、オーダーブック、サブグラフ)、WebSocketストリーミング(市場・ユーザー・スポーツチャネル)、CTF操作(分割、統合、償却、ネガティブリスク)、ブリッジ機能(入金、出金、マルチチェーン)、およびガスレスリレイトランザクションに対応しています。AIエージェント、自動マーケットメーカー、予測市場UI、またはPolygraph上のPolymarketと統合するアプリケーション構築時に活用できます。
ethskills
Ethereum、EVM、またはブロックチェーン関連のリクエストに対応します。スマートコントラクト、dApps、ウォレット、DeFiプロトコルの構築、監査、デプロイ、インタラクションに適用されます。Solidityの開発、コントラクトアドレス、トークン規格(ERC-20、ERC-721、ERC-4626など)、Layer 2ネットワーク(Base、Arbitrum、Optimism、zkSync、Polygon)、Uniswap、Aave、Curveなどのプロトコルとの統合をカバーします。ガスコスト、コントラクトのデシマル設定、オラクルセキュリティ、リエントランシー、MEV、ブリッジング、ウォレット管理、オンチェーンデータの取得、本番環境へのデプロイ、プロトコル進化(EIPライフサイクル、フォーク追跡、今後の変更予定)といったトピックを含みます。
xxyy-trade
このスキルは、ユーザーが「トークン購入」「トークン売却」「トークンスワップ」「暗号資産取引」「取引ステータス確認」「トランザクション照会」「トークンスキャン」「フィード」「チェーン監視」「トークン照会」「トークン詳細」「トークン安全性確認」「ウォレット一覧表示」「マイウォレット」「AIスキャン」「自動スキャン」「ツイートスキャン」「オンボーディング」「IP確認」「IPホワイトリスト」「トークン発行」「自動売却」「損切り」「利益確定」「トレーリングストップ」「保有者」「トップホルダー」「KOLホルダー」などをリクエストした場合、またはSolana/ETH/BSC/BaseチェーンでXXYYを経由した取引について言及した場合に使用します。XXYY Open APIを通じてオンチェーン取引とデータ照会を実現します。