DevOps

AWS CodeDeploy の EC2/オンプレミスデプロイ - AppSpec とライフサイクルフックの設計

AppSpec ファイルでデプロイ先パスとライフサイクルフックを宣言的に定義する。タグベースのデプロイグループと Auto Scaling 統合によるフリート管理を紹介します。

約 1 分で読めます

AppSpec ファイルの構造

EC2/オンプレミスデプロイの AppSpec ファイル (appspec.yml) は、files セクションでソースファイルのデプロイ先パスを定義し、permissions セクションでファイルの所有者と権限を設定し、hooks セクションでライフサイクルの各段階で実行するスクリプトを指定します。files セクションでは source (リビジョン内のパス) と destination (インスタンス上のパス) のマッピングを定義します。permissions セクションでは owner、group、mode を指定し、デプロイされたファイルの権限を適切に設定します。

ライフサイクルフックの活用

ライフサイクルフックはデプロイの各段階で実行されるスクリプトです。BeforeInstall はファイルのデプロイ前に実行され、古いバージョンのクリーンアップや依存パッケージのインストールに使用します。AfterInstall はファイルのデプロイ後に実行され、設定ファイルの生成やデータベースマイグレーションに使用します。ApplicationStart はアプリケーションの起動スクリプトを実行します。ValidateService はデプロイ後のヘルスチェックを実行し、アプリケーションが正常に動作していることを検証します。ValidateService が失敗するとデプロイが失敗として記録され、自動ロールバックが設定されている場合は前バージョンに戻ります。

デプロイグループとフリート管理

デプロイグループはデプロイ対象のインスタンスをグループ化する単位です。タグフィルターで Environment:Production かつ Role:WebServer のインスタンスを選択するといった動的な指定が可能です。 Auto Scaling グループとの統合では、スケールアウトで新しく起動したインスタンスに自動的に最新のリビジョンがデプロイされます。デプロイ設定で最小正常ホスト数を指定し、デプロイ中に常に一定数のインスタンスがリクエストを処理し続けることを保証します。 CodeDeployDefault.OneAtATime は 1 台ずつ、 CodeDeployDefault.HalfAtATime は半数ずつデプロイする事前定義の設定です。 EC2 デプロイのプラクティスを深く理解するには、専門書籍 (Amazon)が役立ちます。

CodeDeploy の料金

CodeDeploy の EC2/オンプレミスデプロイは無料で利用できます。EC2 インスタンスへのデプロイに追加料金は発生しません。オンプレミスサーバーへのデプロイは 1 インスタンスあたり 1 デプロイにつき約 0.02 ドルです。ECS と Lambda へのデプロイも無料です。CodeDeploy 自体のコストは実質ゼロに近く、CI/CD パイプラインのデプロイステージとして導入のハードルが低い点が魅力です。

まとめ

CodeDeploy の EC2/オンプレミスデプロイは AppSpec ファイルとライフサイクルフックで宣言的にデプロイプロセスを定義します。タグベースのデプロイグループで動的なフリートに対応し、最小正常ホスト数でデプロイ中の可用性を保証します。オンプレミスサーバーも対象に含められるため、ハイブリッド環境の統一的なデプロイ管理に有効です。

関連するサービス

AWS CodeDeployEC2、Lambda、ECS へのアプリケーションデプロイを自動化するフルマネージドサービスAmazon EC2クラウド上で仮想サーバーを提供するコンピュートサービスAWS CodePipelineソースからデプロイまでの CI/CD パイプラインを構築・自動化するサービス

関連する記事

AWS CodeDeploy のデプロイ戦略 - EC2 ・ ECS ・ Lambda へのブルーグリーンデプロイEC2・ECS・Lambda の 3 プラットフォームに対応するデプロイ戦略を統一的に管理する。ECS ブルーグリーンデプロイと CloudWatch アラーム連動の自動ロールバックを紹介します。自動デプロイメント戦略 - AWS CodeDeploy と CodePipeline で実現する継続的デリバリーAWS CodeDeploy と CodePipeline を活用した自動デプロイメントの構築方法を解説します。EC2、Lambda、ECS への多様なデプロイ戦略と、パイプラインによる継続的デリバリーの実践手法を紹介します。AWS CodePipeline で構築する CI/CD パイプライン - ソースからデプロイまでの自動化ソースの変更検出からビルド・テスト・デプロイまでを自動化する。V2 トリガーフィルター、手動承認アクション、クロスアカウントデプロイの設計を紹介します。

同じテーマの記事

自動デプロイメント戦略 - AWS CodeDeploy と CodePipeline で実現する継続的デリバリーAWS CodeDeploy と CodePipeline を活用した自動デプロイメントの構築方法を解説します。EC2、Lambda、ECS への多様なデプロイ戦略と、パイプラインによる継続的デリバリーの実践手法を紹介します。re:Invent の発表から読む AWS の 3 年後 - サービスのライフサイクルと廃止の法則CodeCommit の新規受付停止、SimpleDB の事実上の終了など、AWS サービスにも寿命があるという事実を直視し、サービスのライフサイクル分析と「消えないサービス」を見極める技術選定の視点を提供します。カオスエンジニアリング実践 - AWS Fault Injection Simulator で耐障害性を検証するAWS Fault Injection Simulator (FIS) を使ったカオスエンジニアリングの実践を解説。障害注入シナリオの設計、EC2 ・ ECS ・ RDS への障害注入、安全な実験の進め方を紹介します。CI/CD パイプライン自動化 - AWS CodePipeline で実現する継続的デリバリーAWS CodePipeline と CodeBuild を活用した CI/CD パイプラインの自動化を解説します。CloudFormation のドリフト検出はどこまで見ているのか - 手動変更を追跡する仕組みと限界CloudFormation のドリフト検出が内部でどのようにリソースの現在状態とテンプレートの期待状態を比較しているのか、検出できる変更と検出できない変更の境界、ドリフト修復の戦略を解説します。CloudFormation のスタック更新で何が起きているのか - 変更セット・ロールバック・置換の裏側CloudFormation がスタックを更新する際の内部処理フローを、変更セットの差分検出、リソースの更新・置換・削除の判断ロジック、ロールバックの仕組みから解説します。AWS CodeDeploy のデプロイ戦略 - EC2 ・ ECS ・ Lambda へのブルーグリーンデプロイEC2・ECS・Lambda の 3 プラットフォームに対応するデプロイ戦略を統一的に管理する。ECS ブルーグリーンデプロイと CloudWatch アラーム連動の自動ロールバックを紹介します。AWS CodePipeline で構築する CI/CD パイプライン - ソースからデプロイまでの自動化ソースの変更検出からビルド・テスト・デプロイまでを自動化する。V2 トリガーフィルター、手動承認アクション、クロスアカウントデプロイの設計を紹介します。

内容が近い記事・サービス

AWS CodeDeployEC2、Lambda、ECS へのアプリケーションデプロイを自動化するサービスで、ローリング更新やブルー/グリーンデプロイによる安全なリリースを実現する自動デプロイメント戦略 - AWS CodeDeploy と CodePipeline で実現する継続的デリバリーAWS CodeDeploy と CodePipeline を活用した自動デプロイメントの構築方法を解説します。EC2、Lambda、ECS への多様なデプロイ戦略と、パイプラインによる継続的デリバリーの実践手法を紹介します。AWS CodeDeploy のデプロイ戦略 - EC2 ・ ECS ・ Lambda へのブルーグリーンデプロイEC2・ECS・Lambda の 3 プラットフォームに対応するデプロイ戦略を統一的に管理する。ECS ブルーグリーンデプロイと CloudWatch アラーム連動の自動ロールバックを紹介します。AWS CodePipeline で構築する CI/CD パイプライン - ソースからデプロイまでの自動化ソースの変更検出からビルド・テスト・デプロイまでを自動化する。V2 トリガーフィルター、手動承認アクション、クロスアカウントデプロイの設計を紹介します。