cfn-hup - AWS CloudFormation
描述語法選項cfn-hup.conf 組態檔案hooks.conf 組態檔案hooks.d 目錄範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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。