• JSON 形式のテキストファイル
• パラメータは1~10個
• 代表的なパラメータ(一部)
  • ファミリー(必須)
    • タスク定義の名前のようなもの。ファミリーとリビジョン番号(最初は1)で1つのタスク定義が特定される。
  • コンテナ定義(必須)
    • コンテナのイメージやポートマッピング、メモリ制限などを指定する
  • タスクサイズ(要求CPU & メモリ)
  • タスクロール
    • コンテナが利⽤できる IAM ロールを指定する
  • タスク実行ロール
    • ECS コンテナエージェントが利⽤する IAMロールを指定する
  • ネットワークモード
    • タスクのコンテナが使⽤するDocker ネットワークモードを指定する。none | bridge | host | awsvpc のいずれかを設定。
  • コンテナのログ設定(logConfiguration)
  • 環境変数(environment)
    • 平文
  • 環境変数(secrets)
    • Secrets Manager シークレット、ssmパラメータを参照可能
    • それぞれタスク実⾏ロールに適切なIAM アクセス許可の設定が必要
  • dependsOnパラメータ
    • 実⾏順序の制御を⾏いたい時に利⽤
    • condition ” に設定できる値→ START | COMPLETE | SUCCESS | HEALTHY

• アプリケーション
  • デプロイするアプリケーションを一意に識別する名前
• コンピューティングプラットフォーム
  • アプリケーションがデプロイされるプラットフォーム
    • EC2/オンプレ
    • Lambda
    • ECS
• デプロイグループ
  • デプロイ環境の定義
  • Auto Scaling グループ
  • タグのグループ
    • EC2 インスタンス、オンプレミスインスタンス
  • ECS サービス
• デプロイタイプ
  • In-Place
    • EC2,オンプレ
  • Blue/Green
    • EC2,Lambda,ECS
• デプロイ設定
  • どのようにデプロイするかを定義したもの
  • デプロイする割合やデプロイ成功、失敗の条件が異なる
  • EC2/オンプレ
    • One-at-a-time
    • [Custom]
    • Half-at-a-time
    • All-at-once
  • Lambda/ECS
    • Linear
    • Canary
    • All-at-once
• リビジョン
  • EC2
    • ソースコード、Webページ、スクリプト等とAppSpecファイルをまとめたアーカイブ
  • Lambda
    • Lambda デプロイ用のAppSpecファイル
  • ECS
    • ECS デプロイ用のAppSpecファイル
• ターゲットリビジョン
  • リポジトリにアップロードした直近のリビジョン
  • デプロイグループへデプロイする対象
  • 自動デプロイで取得されるリビジョン
• サービスロール
  • CodeDaployに付与するIAMロール
  • CodeDaploy から AWS リソースを操作するために必要
• IAM インスタンスプロファイル
  • EC2インスタンスに付与するIAMロール

• CodeDeploy Agentのインストールが必要
• デプロイグループに Auto Scaling Group を指定することで、スケールアウト時に最新のリビジョンが自動でデプロイされる
• ライフサイクルイベントへ Hook を指定し、スクリプトを実行可能

リビジョンの構成

• appspec.yml (必須)
  • osやソースファイル、パーミッション、hooksスクリプトのディレクトリを指定する
• ビルド済みの成果物
• その他の配布物
• Hook スクリプト
  • ApplicationStop
  • BeforeInstall
  • AfterInstall
  • ApplicationStart
  • ValidateService
  • BeforeAllowTraffic
  • AfterAllowTraffic
  • BeforeBlockTraffic
  • AfterBlockTraffic

• 関数重み付けエイリアスを利用したトラフィックのシフト
• カナリアデプロイ (10分間 10% のトラフィックをシフト、その後残り全部もシフト ) やリニアデプロイ(毎10分ごとに10％ずつシフト)を選択可能
• Validation Hookは各ステージへのデプロイ時のテストを有効化

appspecの定義

• Lambda
  • デプロイするLambdaの指定
  • Hook用Lambda関数の指定
• Lambda(SAM)
  • SAMによるLambdaの指定
  • カナリアデプロイの定義
  • CloudWatchアラームの定義
  • Hook用Lambda関数の指定

• Greenタスクをプロビジョニングし、ロードバランサーのトラフィックを切
  り替え
• 検証Hookによって各ステージのデプロイメントでテストを有効化

appspecの定義

• ターゲットタイプの指定
• タスク定義
• ロードバランサの定義
• フック関数の定義
  • LambdaのARNを指定

重要：デプロイメントのためのコンテナイメージのタグ付け

• Dockerタグはデプロイ時のみではなく個々のコンテナの開始時にも利用
• latest や prod タグはスケールアウトイベント発生時に未テストのコードを本番環境へデプロイする結果を招く
• デプロイメントにはユニークでイミュータブルなタグを利用すべき

• version(必須)
• run-as
  • コマンドを実行するLinuxユーザ
  • 指定しない場合、すべてのコマンドが root ユーザで実行される
• env
  • 環境変数
• proxy
  • アーティファクトのアップロード時、CloudWatch Logs へのログ送信時に プロキシサーバを利用するか個別に定義可能
• batch
  • バッチビルド設定
  • 3つのタイプ
    • build-graph
      • バッチ内の他のタスクに依存する一連のタスクを定義
    • build-list
      • 同時に実行されるタスクを定義
    • build-matrix
    • さまざまな環境と並行して実行されるタスクを定義
      • install, pre_build, build, post_build
• phases
  • ビルドの各段階で CodeBuild が実行するコマンド記述する
• reports
  • テストレポート の作成
    • 対応フォーマット
      • Cucumber JSON, JUnitXML, NUnitXML, NUnit3 XML, TestNGXML,Visual Studio TRX
  • コードカバレッジレポートの作成
    • C0,C1
    • 対応フォーマット
      • Clover XML, Cobertula XML, JaCoCoXML, SimpleCovJSON
• artifacts
  • CodeBuild の出力を定義
• cache