cfn-hup

描述

cfn-hup 協助程式是偵測任何資源中繼資料的變更，並在偵測到變更時執行使用者指定的動作之協助程式。這可讓您透過 UpdateStackAPI動作在執行中的 Amazon EC2執行個體上進行組態更新。

語法

cfn-hup --config|-c config.dir \
        --no-daemon \
        --verbose|-v

選項

名稱	描述	必要
--config|-c config.dir	指定路徑，讓 cfn-hup 指令碼尋找 cfn-hup.conf 和 hooks.d 目錄。在 Windows 上，預設路徑為 system_drive\cfn。在 Linux 上，預設路徑為 /etc/cfn。	否
--no-daemon	指定此選項以執行 cfn-hup 指令碼一次並結束。	否
-v, --verbose	指定此選項以使用詳細資訊模式。	否

cfn-hup.conf 組態檔案

cfn-hup.conf 檔案會存放堆疊的名稱，以及 cfn-hup 協助程式目標的 AWS 登入資料。

cfn-hup.conf 檔案使用下列格式：

[main]
stack=<stack-name-or-id>  

名稱	描述	必要
stack	堆疊名稱或 ID。 類型：字串	是
credential-file	僅限擁有者的憑證檔案，其格式與命令列工具所使用的格式相同。 類型：字串 條件：role 參數會取代此參數。	否
role	與執行個體相關聯的 IAM 角色名稱。 類型：字串	否
region	包含堆疊 AWS 的區域名稱。 範例：us-east-2	否
umask	cfn-hup 協助程式使用的 umask。 指定此值時可以包含或不包含前置 0。在這兩種情況下，都會解譯為八進位數字 (類似於 Linux umask 命令)。此參數在 Windows 上不會造成影響。 類型：介於 0 至 0777 的八進位整數 預設：022，1.4–22 版和更高版本。022 的預設值會遮罩群組和世界寫入許可，因此 cfn-hup 常駐程式建立的檔案預設為無法寫入群組或世界。1.4-21 版本和更早版本的預設值為 0，表示不遮罩任何內容。	否
interval	用來檢查資源中繼資料變更的間隔，以分鐘為單位。 類型：整數 預設：15	否
verbose	指定是否使用詳細資訊記錄。 類型：布林值 預設：false	否

hooks.conf 組態檔案

cfn-hup 協助程式定期呼叫的使用者動作是在 hooks.conf 組態檔案中定義。hooks.conf 檔案使用下列「格式」：

[hookname]
triggers=post.add or post.update or post.remove
path=Resources.<logicalResourceId> (.Metadata or .PhysicalResourceId)(.<optionalMetadatapath>)
action=<arbitrary shell command>
runas=<runas user> 

執行操作時，它會在目前環境 (cfn-hup 位於其中） 的複本中執行，其中 CFN_OLD_METADATA 設定為路徑指定的先前中繼資料值，而 CFN_NEW_METADATA 設定為目前值。

掛接組態檔案只會在 cfn-hup 常駐程式啟動時載入，因此新的掛接需要重新啟動常駐程式。先前中繼資料值的快取會存放為 at /var/lib/cfn-hup/data/metadata_db — 您可以刪除此快取，強制 cfn-hup 再次執行所有 post.add 動作。

名稱	描述	必要
hookname	此掛接的唯一名稱。 類型：字串	是
triggers	要偵測的條件逗號分隔清單。 有效值：post.add、post.update 或 post.remove 範例：post.add, post.update	是
path	中繼資料物件的路徑。支援在中繼資料區塊內有任意深度的路徑。 途徑格式選項 資源。<LogicalResourceId>— 監控資源的上次更新時間，在資源變更時觸發。 資源<LogicalResourceId>。PhysicalResourceId— 監控資源的實體 ID，只有在相關聯的資源身分變更時觸發 （例如新EC2執行個體）。 資源<LogicalResourceId>。Metadata(.optional path)— 監控資源的中繼資料是否有變更 （中繼資料子路徑可指定為任意深度層級，以監控特定值）。	是
action	按照指定執行的任意 shell 命令。	是
runas	要執行命令的使用者身分。Cfn-hup 使用 su 命令來切換到使用者。	是

hooks.d 目錄

為了支援部署變更通知勾點的數個應用程式組合，cfn-hup 支援勾點組態目錄中名為 hooks.d 的目錄。您可以將一或多個額外的勾點組態檔案放在 hooks.d 目錄中。這些額外的勾點檔案必須與 hooks.conf 檔案使用相同的配置。

cfn-hup 協助程式會剖析及載入此目錄中的每個檔案。如果 hooks.d 目錄中有任何勾點與 hooks.conf 中的勾點同名，則會合併這些勾點 (這表示 hooks.d 會覆寫 hooks.conf 中兩個檔案同時指定的任何值)。

範例

在下列範本程式碼片段中，當您變更與LaunchConfig資源相關聯的AWS::CloudFormation::Init資源時 CloudFormation ， 會觸發cfn-auto-reloader.conf勾點檔案。

JSON

...
    "LaunchConfig": {
      "Type" : "AWS::AutoScaling::LaunchConfiguration",
      "Metadata" : {
        "QBVersion": {"Ref": "paramQBVersion"},
        "AWS::CloudFormation::Init" : {
...
              "/etc/cfn/hooks.d/cfn-auto-reloader.conf": {
                "content": { "Fn::Join": [ "", [
                  "[cfn-auto-reloader-hook]\n",
                  "triggers=post.update\n",
                  "path=Resources.LaunchConfig.Metadata.AWS::CloudFormation::Init\n",
                  "action=/opt/aws/bin/cfn-init -v ",
                          "         --stack ", { "Ref" : "AWS::StackName" },
                          "         --resource LaunchConfig ",
                          "         --configsets wordpress_install ",
                          "         --region ", { "Ref" : "AWS::Region" }, "\n",
                  "runas=root\n"
                ]]},          
                "mode"  : "000400",
                "owner" : "root",
                "group" : "root"
              }
...

YAML

...
  LaunchConfig:
    Type: "AWS::AutoScaling::LaunchConfiguration"
    Metadata:
      QBVersion: !Ref paramQBVersion
      AWS::CloudFormation::Init:
...
            /etc/cfn/hooks.d/cfn-auto-reloader.conf:
              content: !Sub |
                [cfn-auto-reloader-hook]
                triggers=post.update
                path=Resources.LaunchConfig.Metadata.AWS::CloudFormation::Init
                action=/opt/aws/bin/cfn-init -v --stack ${AWS::StackName} --resource LaunchConfig --configsets wordpress_install --region ${AWS::Region}
                runas=root
              mode: "000400"
              owner: "root"
              group: "root"
...

其他範例

如需範例範本，請參閱在 Amazon 上部署應用程式 EC2。