翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AppSpec 「フック」セクション

AppSpec ファイル'hooks'のセクションの内容は、デプロイのコンピューティングプラットフォームによって異なります。EC2/オンプレミスデプロイ'hooks'のセクションには、デプロイライフサイクルイベントフックを 1 つ以上のスクリプトにリンクするマッピングが含まれています。Lambda または Amazon ECSデプロイ'hooks'のセクションでは、デプロイライフサイクルイベント中に実行する Lambda 検証関数を指定します。イベントフックが存在しない場合、そのイベントに対してオペレーションは実行されません。このセクションは、デプロイの一部としてスクリプトまたは Lambda 検証の関数を実行する場合のみ必須です。

AppSpec Amazon ECSデプロイの「フック」セクション

Amazon ECSデプロイのライフサイクルイベントフックのリスト

AWS Lambda フックは、ライフサイクルイベントの名前の後に新しい行に文字列で指定された 1 つの Lambda 関数です。各フックはデプロイごとに 1 回実行されます。以下は、Amazon ECSデプロイ中にフックを実行できるライフサイクルイベントの説明です。

詳細については、「Amazon ECSデプロイ中に発生すること」および「チュートリアル: 検証テストを使用して Amazon ECSサービスをデプロイする」を参照してください。

Amazon ECSデプロイでフックの順序を実行します。

Amazon ECSデプロイでは、イベントフックは次の順序で実行されます。

「hooks」 セクションの構造

次の例は、'hooks' セクションの構造の例を示します。

の使用YAML：

Hooks:
  - BeforeInstall: "BeforeInstallHookFunctionName"
  - AfterInstall: "AfterInstallHookFunctionName"
  - AfterAllowTestTraffic: "AfterAllowTestTrafficHookFunctionName"
  - BeforeAllowTraffic: "BeforeAllowTrafficHookFunctionName"
  - AfterAllowTraffic: "AfterAllowTrafficHookFunctionName"

の使用JSON：

"Hooks": [
		{
			"BeforeInstall": "BeforeInstallHookFunctionName"
		},
		{
			"AfterInstall": "AfterInstallHookFunctionName"
		},
		{
			"AfterAllowTestTraffic": "AfterAllowTestTrafficHookFunctionName"
		},
		{
			"BeforeAllowTraffic": "BeforeAllowTrafficHookFunctionName"
		},
		{
			"AfterAllowTraffic": "AfterAllowTrafficHookFunctionName"
		}
	]
}

Lambda の「フック」関数のサンプル

'hooks' セクションを使用して、 を呼び出して Amazon ECSデプロイを検証 CodeDeploy できる Lambda 関数を指定します。、BeforeInstall、、AfterInstallAfterAllowTestTrafficBeforeAllowTraffic、および AfterAllowTraffic デプロイライフサイクルイベントには、同じ関数または別の関数を使用できます。検証テストが完了すると、Lambda AfterAllowTraffic関数は または Succeeded の結果を呼び出して CodeDeploy配信しますFailed。

Lambda フック関数を呼び出す前に、サーバーは putLifecycleEventHookExecutionStatus コマンドを使用して、デプロイ ID およびライフサイクルイベントフック実行 ID について通知される必要があります。

次に示すのは、Node.js で記述されたサンプルの Lambda フック関数の例です。

'use strict';

const aws = require('aws-sdk');
const codedeploy = new aws.CodeDeploy({apiVersion: '2014-10-06'});

exports.handler = (event, context, callback) => {
    //Read the DeploymentId from the event payload.
    var deploymentId = event.DeploymentId;

    //Read the LifecycleEventHookExecutionId from the event payload
    var lifecycleEventHookExecutionId = event.LifecycleEventHookExecutionId;

    /*
     Enter validation tests here.
    */

    // Prepare the validation test results with the deploymentId and
    // the lifecycleEventHookExecutionId for CodeDeploy.
    var params = {
        deploymentId: deploymentId,
        lifecycleEventHookExecutionId: lifecycleEventHookExecutionId,
        status: 'Succeeded' // status can be 'Succeeded' or 'Failed'
    };
    
    // Pass CodeDeploy the prepared validation test results.
    codedeploy.putLifecycleEventHookExecutionStatus(params, function(err, data) {
        if (err) {
            // Validation failed.
            callback('Validation test failed');
        } else {
            // Validation succeeded.
            callback(null, 'Validation test succeeded');
        }
    });
};

AppSpec AWS Lambda デプロイの「フック」セクション

AWS Lambda デプロイのライフサイクルイベントフックのリスト

AWS Lambda フックは、ライフサイクルイベントの名前の後に新しい行に文字列で指定された 1 つの Lambda 関数です。各フックはデプロイごとに 1 回実行されます。ファイルで使用できるフックの説明を次に示します AppSpec 。

Lambda 関数のバージョンのデプロイでのフックの実行順

サーバーレスの Lambda 関数のバージョンのデプロイでは、イベントフックは次の順序で実行されます。

「hooks」 セクションの構造

次の例は、「hooks」セクションの例を示します。

の使用YAML：

hooks:
   - BeforeAllowTraffic: BeforeAllowTrafficHookFunctionName
   - AfterAllowTraffic: AfterAllowTrafficHookFunctionName

の使用JSON：

"hooks": [{
    "BeforeAllowTraffic": "BeforeAllowTrafficHookFunctionName"
    },
    {
    "AfterAllowTraffic": "AfterAllowTrafficHookFunctionName"
}]

Lambda の「フック」関数のサンプル

「フック」セクションを使用して、Lambda デプロイを検証するために を呼び CodeDeploy 出すことができる Lambda 関数を指定します。BeforeAllowTraffic および AfterAllowTrafficデプロイライフサイクルイベントには、同じ関数または別の関数を使用できます。検証テストが完了すると、Lambda 検証関数は CodeDeploy または Succeeded の結果を呼び出して配信しますFailed。

Lambda フック関数を呼び出す前に、サーバーは putLifecycleEventHookExecutionStatus コマンドを使用して、デプロイ ID およびライフサイクルイベントフック実行 ID について通知される必要があります。

次に示すのは、Node.js で記述されたサンプルの Lambda フック関数の例です。

'use strict';

const aws = require('aws-sdk');
const codedeploy = new aws.CodeDeploy({apiVersion: '2014-10-06'});

exports.handler = (event, context, callback) => {
    //Read the DeploymentId from the event payload.
    var deploymentId = event.DeploymentId;

    //Read the LifecycleEventHookExecutionId from the event payload
    var lifecycleEventHookExecutionId = event.LifecycleEventHookExecutionId;

    /*
     Enter validation tests here.
    */

    // Prepare the validation test results with the deploymentId and
    // the lifecycleEventHookExecutionId for CodeDeploy.
    var params = {
        deploymentId: deploymentId,
        lifecycleEventHookExecutionId: lifecycleEventHookExecutionId,
        status: 'Succeeded' // status can be 'Succeeded' or 'Failed'
    };
    
    // Pass CodeDeploy the prepared validation test results.
    codedeploy.putLifecycleEventHookExecutionStatus(params, function(err, data) {
        if (err) {
            // Validation failed.
            callback('Validation test failed');
        } else {
            // Validation succeeded.
            callback(null, 'Validation test succeeded');
        }
    });
};

AppSpec EC2/オンプレミスデプロイの「フック」セクション

ライフサイクルイベントフックのリスト

EC2/オンプレミスデプロイフックは、インスタンスへのデプロイごとに 1 回実行されます。フックには実行するスクリプトを 1 つまたは複数指定することができます。ライフサイクルイベントの各フックは、文字列で個別の行に指定します。ファイルで使用できるフックの説明を次に示します AppSpec 。

デプロイおよびロールバックの種類別の有効なライフサイクルフックの詳細については、「ライフサイクルイベントフックの可用性」を参照してください。

ライフサイクルイベントフックの可用性

次の表に、各デプロイおよびロールバックシナリオで使用できるライフサイクルイベントフックを示します。

デプロイでのフックの実行順

Auto Scaling 起動デプロイ

Auto Scaling 起動デプロイ中に、 はイベントフックを次の順序で CodeDeploy 実行します。

Auto Scaling 起動デプロイの詳細については、「Amazon EC2 Auto Scaling と の連携方法 CodeDeploy」を参照してください。

Auto Scaling 終了デプロイ

Auto Scaling 終了デプロイ中、 はイベントフックを次の順序で CodeDeploy 実行します。

Auto Scaling 終了デプロイの詳細については、「Auto Scaling スケールインイベント中の終了デプロイの有効化」を参照してください。

インプレースデプロイ

インプレースデプロイのロールバックを含むインプレースデプロイで、イベントフックは次の順序で実行されます。

Blue/Green デプロイ

Blue/Green デプロイでは、イベントフックは次の順序で実行されます。

「hooks」 セクションの構造

'hooks' セクションは以下の構造を持ちます。

hooks:
   deployment-lifecycle-event-name:
     - location: script-location
       timeout: timeout-in-seconds
       runas: user-name

デプロイライフサイクルイベント名の後で、次の要素を hook エントリに含めることができます。

フックスクリプトでのファイルの参照

の説明に従ってスクリプトを CodeDeploy ライフサイクルイベントに接続しAppSpec 「フック」セクション、スクリプトでファイル (例: helper.sh) を参照する場合は、以下helper.shを使用して を指定する必要があります。

絶対パスの使用

絶対パスを使用してファイルを参照するには、次のいずれかを行うことができます。

デプロイアーカイブの場所

DownloadBundle ライフサイクルイベント中、 CodeDeploy エージェントはデプロイのリビジョンを次の形式のディレクトリに抽出します。

root-directory/deployment-group-id/deployment-id/deployment-archive

- root-directory パスの 部分は、常に次の表に示すデフォルトに設定されるか、:root_dir設定によって制御されます。構成設定の詳細については、「CodeDeploy エージェント設定リファレンス」を参照してください。

フックスクリプトから、ルートディレクトリパスおよび環境変数 (DEPLOYMENT_ID と DEPLOYMENT_GROUP_ID) を使用して現在のデプロイアーカイブにアクセスできます。使用できる変数の詳細については、「フックの環境変数の可用性」を参照してください。

例えば、Linux のリビジョンのルートにある data.json ファイルにアクセスする方法は次のとおりです。

#!/bin/bash

rootDirectory="/opt/codedeploy-agent/deployment-root" # note: this will be different if you
                                                      # customize the :root_dir configuration
dataFile="$rootDirectory/$DEPLOYMENT_GROUP_ID/$DEPLOYMENT_ID/deployment-archive/data.json"
data=$(cat dataFile)

別の例として、Windows の Powershell を使用してリビジョンのルートにある data.json ファイルにアクセスする方法は次のとおりです。

$rootDirectory="$env:ProgramData\Amazon\CodeDeploy" # note: this will be different if you
                                                    # customize the :root_dir configuration
$dataFile="$rootDirectory\$env:DEPLOYMENT_GROUP_ID\$env:DEPLOYMENT_ID\deployment-archive\data.json"
$data=(Get-Content $dataFile)

相対パスの使用

相対パスを使用してファイルを参照するには、 CodeDeploy エージェントの作業ディレクトリを知る必要があります。ファイルパスは、このディレクトリからの相対パスです。

次の表は、 CodeDeploy エージェントのサポートされている各プラットフォームの作業ディレクトリを示しています。

フックの環境変数の可用性

各デプロイライフサイクルイベントの間、フックスクリプトは次の環境変数にアクセスできます。

これらの環境変数は各デプロイライフサイクルイベントにローカルです。

デプロイバンドルのソースに応じて、スクリプトをフックできる環境変数が他にもあります。

Amazon S3 からのバンドル

からのバンドル GitHub

次のスクリプトは、DEPLOYMENT_GROUP_NAME の値が に等しい場合、Apache HTTPサーバーのリッスンポートを 80 ではなく 9090 に変更しますStaging。このスクリプトは BeforeInstall デプロイライフサイクルイベント中に呼び出される必要があります。

if [ "$DEPLOYMENT_GROUP_NAME" == "Staging" ]
then
    sed -i -e 's/Listen 80/Listen 9090/g' /etc/httpd/conf/httpd.conf
fi

次のスクリプト例では、DEPLOYMENT_GROUP_NAME 環境変数の値が に等しい場合、エラーログに記録されたメッセージの冗長性レベルを警告からデバッグに変更しますStaging。このスクリプトは BeforeInstall デプロイライフサイクルイベント中に呼び出される必要があります。

if [ "$DEPLOYMENT_GROUP_NAME" == "Staging" ]
then
    sed -i -e 's/LogLevel warn/LogLevel debug/g' /etc/httpd/conf/httpd.conf
fi

以下のスクリプトの例では、指定されたウェブページを、これらの環境変数の値を表示するテキストで置き換えます。このスクリプトは AfterInstall デプロイライフサイクルイベント中に呼び出される必要があります。

#!/usr/bin/python

import os
 
strToSearch="<h2>This application was deployed using CodeDeploy.</h2>"
strToReplace="<h2>This page for "+os.environ['APPLICATION_NAME']+" application and "+os.environ['DEPLOYMENT_GROUP_NAME']+" deployment group with "+os.environ['DEPLOYMENT_GROUP_ID']+" deployment group ID was generated by a "+os.environ['LIFECYCLE_EVENT']+" script during "+os.environ['DEPLOYMENT_ID']+" deployment.</h2>"
 
fp=open("/var/www/html/index.html","r")
buffer=fp.read()
fp.close()
 
fp=open("/var/www/html/index.html","w")
fp.write(buffer.replace(strToSearch,strToReplace))
fp.close()

hooks の例

hooks エントリの例を次に示します。AfterInstall ライフサイクルイベントに 2 つのフックを指定しています。

hooks:
   AfterInstall:
     - location: Scripts/RunResourceTests.sh
       timeout: 180
     - location: Scripts/PostDeploy.sh
       timeout: 180

デプロイプロセスの AfterInstall ステージ中に、Scripts/RunResourceTests.sh スクリプトが実行されます。スクリプトの実行に 180 秒 (3 分) 以上かかる場合、デプロイは成功しません。

「hooks」セクションで指定するスクリプトの場所は、アプリケーションリビジョンバンドルのルートに相対的な位置です。前述の例では、RunResourceTests.sh という名前のファイルが Scripts という名前のディレクトリにあります。Scripts ディレクトリはバンドルのルートレベルにあります。詳細については、「のリビジョンを計画する CodeDeploy」を参照してください。