Ini adalah *Panduan Referensi CloudFormation Template* baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat [Panduan AWS CloudFormation Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# cfn-hup
`cfn-hup`Helper adalah daemon yang mendeteksi perubahan dalam metadata sumber daya dan menjalankan tindakan yang ditentukan pengguna saat perubahan terdeteksi. Ini memungkinkan Anda membuat pembaruan konfigurasi pada instans Amazon EC2 yang sedang berjalan melalui tindakan API. `UpdateStack`
Untuk informasi selengkapnya, lihat tutorial [Memperbarui CloudFormation tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/updating.stacks.walkthrough.html) di *Panduan AWS CloudFormation Pengguna*.
**Topics**
+ [Sintaksis](#cfn-hup-Syntax)
+ [Opsi](#cfn-hup-options)
+ [file konfigurasi cfn-hup.conf](#cfn-hup-config-file)
+ [`hooks.conf`berkas konfigurasi](#cfn-hup-hook-file)
+ [`hooks.d`direktori](#cfn-hup-hooks-dir)
+ [Contoh](#cfn-hup-examples)
+ [Sumber daya terkait](#cfn-hup-related-resources)
## Sintaksis
```
cfn-hup --config|-c config.dir \
--no-daemon \
--verbose|-v
```
## Opsi
| Nama | Deskripsi | Diperlukan |
| --- | --- | --- |
| `--config\|-c config.dir` | Menentukan jalur yang `cfn-hup` script mencari `cfn-hup.conf` dan `hooks.d` direktori. Di Windows, jalur default-nya adalah `system_drive\cfn`. Di Linux, jalur default-nya adalah `/etc/cfn`. | Tidak |
| `--no-daemon` | Tentukan opsi ini untuk menjalankan `cfn-hup` skrip sekali dan keluar. | Tidak |
| `-v, --verbose ` | Tentukan opsi ini untuk menggunakan mode verbose. | Tidak |
## file konfigurasi cfn-hup.conf
`cfn-hup.conf`File menyimpan nama tumpukan dan AWS kredensil yang ditargetkan `cfn-hup` daemon.
`cfn-hup.conf`File menggunakan format berikut:
```
[main]
stack=
```
| Nama | Deskripsi | Diperlukan |
| --- | --- | --- |
| `stack` | Nama atau ID tumpukan. *Tipe*: String | Ya |
| `credential-file` | File kredensial khusus pemilik, dalam format yang sama yang digunakan untuk alat baris perintah. *Tipe*: String *Syarat*: Parameter `role` menggantikan parameter ini. | Tidak |
| `role` | Nama peran IAM yang terkait dengan instance. *Tipe*: String | Tidak |
| `region` | Nama yang Wilayah AWS berisi tumpukan. *Contoh* | Tidak |
| `umask` | Yang `umask` digunakan oleh `cfn-hup` daemon. Nilai ini dapat ditentukan dengan atau tanpa awalan 0. Dalam kedua kasus, itu ditafsirkan sebagai angka oktal (mirip dengan `umask` perintah Linux). Parameter ini tidak berpengaruh pada Windows. *Jenis*: Bilangan bulat oktal antara `0` dan `0777` *Default*:`022`, versi 1.4—22 dan lebih tinggi. Nilai default dari grup `022` mask dan izin penulisan dunia, sehingga file yang dibuat oleh `cfn-hup` daemon tidak dapat ditulis grup atau dunia secara default. Nilai default untuk versi 1.4 —21 dan sebelumnya adalah`0`, yang tidak menutupi apa pun. | Tidak |
| `interval` | Interval yang digunakan untuk memeriksa perubahan metadata sumber daya dalam hitungan menit. *Tipe*: Integer *Default*: `15` | Tidak |
| `verbose` | Menentukan apakah akan menggunakan pencatatan verbose. *Jenis*: Boolean *Default*: `false` | Tidak |
## `hooks.conf`berkas konfigurasi
Tindakan pengguna yang dipanggil `cfn-hup` daemon secara berkala ditentukan dalam file `hooks.conf` konfigurasi. `hooks.conf`File menggunakan *format* berikut:
```
[hookname]
triggers=post.add or post.update or post.remove
path=Resources. (.Metadata or .PhysicalResourceId)(.)
action=
runas=
```
Ketika operasi dijalankan, itu dijalankan dalam salinan lingkungan saat ini (yang `cfn-hup` ada di), dengan `CFN_OLD_METADATA` disetel ke nilai metadata sebelumnya yang ditentukan oleh jalur, dan `CFN_NEW_METADATA` disetel ke nilai saat ini.
File konfigurasi hook dimuat saat `cfn-hup` daemon start up saja, jadi kait baru akan memerlukan daemon untuk di-restart. Cache nilai metadata sebelumnya disimpan di `/var/lib/cfn-hup/data/metadata_db` — Anda dapat menghapus cache ini `cfn-hup` untuk memaksa menjalankan semua `post.add` tindakan lagi.
| Nama | Deskripsi | Diperlukan |
| --- | --- | --- |
| `hookname` | Nama unik untuk kait ini. *Tipe*: String | Ya |
| `triggers` | Daftar syarat yang dipisahkan koma untuk dideteksi. *Nilai yang valid*: `post.add`, `post.update`, atau `post.remove` *Contoh*: `post.add, post.update` | Ya |
| `path` | Jalur ke objek metadata. Mendukung jalur dalam yang berubah-ubah di dalam blok Metadata. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSCloudFormation/latest/TemplateReference/cfn-hup.html) | Ya |
| `action` | Perintah shell berubah-ubah yang dijalankan seperti yang diberikan. | Ya |
| `runas` | Seorang pengguna untuk menjalankan perintah sebagai. `cfn-hup`menggunakan perintah su untuk beralih ke pengguna. | Ya |
## `hooks.d`direktori
Untuk mendukung komposisi beberapa aplikasi yang menggunakan kait pemberitahuan perubahan, `cfn-hup` mendukung direktori bernama `hooks.d` yang terletak di direktori konfigurasi kait. Anda dapat menempatkan satu atau lebih file konfigurasi kait tambahan di `hooks.d` direktori. File kait tambahan harus menggunakan tata letak yang sama dengan `hooks.conf` file.
`cfn-hup`Daemon mem-parsing dan memuat setiap file dalam direktori ini. Jika ada kait di `hooks.d` direktori yang memiliki nama yang sama dengan hook in`hooks.conf`, kait akan digabungkan (artinya `hooks.d` akan `hooks.conf` menimpa nilai apa pun yang ditentukan oleh kedua file).
## Contoh
Dalam contoh berikut, CloudFormation memicu file `cfn-auto-reloader.conf` kait saat Anda mengubah `AWS::CloudFormation::Init` sumber daya yang terkait dengan sumber daya. `LaunchConfig`
### JSON
```
...
"LaunchConfig": {
"Type" : "AWS::AutoScaling::LaunchConfiguration",
"Metadata" : {
"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:
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"
...
```
## Sumber daya terkait
Anda juga dapat mengunjungi GitHub repositori kami untuk mengunduh [contoh templat](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html#sample-templates) yang digunakan`cfn-hup`, termasuk templat berikut.
+ [InstanceWithCfnInit.yaml](https://github.com/aws-cloudformation/aws-cloudformation-templates/blob/main/EC2/InstanceWithCfnInit.yaml)
+ [AutoScalingRollingUpdates.yaml](https://github.com/aws-cloudformation/aws-cloudformation-templates/blob/main/AutoScaling/AutoScalingRollingUpdates.yaml)