cfn-init - AWS CloudFormation
SintaksisOpsiContohSumber daya terkait

Ini adalah Panduan Referensi AWS CloudFormation Template baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat Panduan AWS CloudFormation Pengguna.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

cfn-init

Dalam CloudFormation templat, Anda dapat menggunakan AWS::CloudFormation::Init Metadata bagian EC2 sumber daya Amazon untuk menentukan tugas inisialisasi. Untuk informasi selengkapnya, lihat AWS::CloudFormation::Init.

Skrip cfn-init pembantu membaca metadata template dari AWS::CloudFormation::Init kunci dan bertindak sesuai dengan:

  • Ambil dan parse metadata dari CloudFormation

  • Menginstal paket

  • Menulis file ke disk

  • Layanan Enable/disable and start/stop

Skrip cfn-init helper biasanya dijalankan dari data pengguna EC2 instans Amazon atau peluncuran template.

Jika Anda baru menggunakan skrip pembantu, kami sarankan Anda terlebih dahulu menyelesaikan EC2 tutorial Menyebarkan aplikasi di Amazon di Panduan Pengguna.AWS CloudFormation

catatan

Jika Anda menggunakan cfn-init untuk memperbarui file yang ada, itu membuat salinan cadangan dari file asli di direktori yang sama dengan ekstensi.bak. Misalnya, jika Anda memperbarui /path/to/file_name, tindakan tersebut menghasilkan dua file: /path/to/file_name.bak berisi konten file asli dan /path/to/file_name berisi konten yang diperbarui.

Sintaksis

cfn-init --stack|-s stack.name.or.id \
         --resource|-r logical.resource.id \
         --region region \
         --access-key access.key \
         --secret-key secret.key \
         --role rolename \
         --credential-file|-f credential.file \
         --configsets|-c config.sets \
         --url|-u service.url \
         --http-proxy HTTP.proxy \
         --https-proxy HTTPS.proxy \
         --verbose|-v
catatan

cfn-inittidak memerlukan kredensil, jadi Anda tidak perlu menggunakan--access-key,, --secret-key--role, atau --credential-file opsi. Namun, jika tidak ada kredensial yang ditentukan, CloudFormation memeriksa keanggotaan tumpukan dan membatasi cakupan panggilan ke tumpukan tempat instans berada. Untuk informasi selengkapnya, lihat Izin untuk skrip pembantu.

Opsi

Nama Deskripsi Wajib

-s, --stack

Nama tumpukan atau ID tumpukan.

Tipe: String

Default: Tidak Ada

Contoh: --stack { "Ref" : "AWS::StackName" },

Ya

-r, --resource

ID sumber daya logis dari sumber daya yang berisi metadata.

Tipe: String

Contoh: --resource WebServerHost

Ya

--region

Titik akhir CloudFormation regional untuk digunakan.

Tipe: String

Default: us-east-1

Contoh: --region ", { "Ref" : "AWS::Region" },

Tidak

--access-key

AWS kunci akses untuk akun dengan izin untuk DescribeStackResource menelepon CloudFormation. Parameter file kredensial menggantikan parameter ini.

Tipe: String

Tidak

--secret-key

AWS kunci akses rahasia yang sesuai dengan kunci AWS akses yang ditentukan.

Tipe: String

Tidak

--role

Nama peran IAM yang terkait dengan instance.

Tipe: String

Syarat: Parameter file kredensial menggantikan parameter ini.

Tidak

-f, --credential-file

File yang berisi secret access key dan access key. Parameter file kredensial menggantikan parameter --peran, --access-key, dan -secret key.

Tipe: String

Tidak

-c, --configsets

Daftar konfigurasi yang dipisahkan koma untuk dijalankan (secara berurutan).

Tipe: String

Default: default

Tidak

-u, --url

CloudFormation Endpoint yang akan digunakan.

Tipe: String

Tidak

--http-proxy

Proksi HTTP (bukan SSL). Gunakan format berikut: http://user:password@host:port

Tipe: String

Tidak

--https-proxy

Proksi HTTPS. Gunakan format berikut: https://user:password@host:port

Tipe: String

Tidak

-v, --verbose

Output verbose. Ini berguna untuk kasus debugging di mana gagal cfn-init untuk menginisialisasi.

catatan

Untuk men-debug peristiwa inisialisasi, Anda harus mengaktifkanDisableRollback. Anda kemudian dapat SSH ke konsol dan membaca log di/var/log/cfn-init.log. Untuk informasi selengkapnya, lihat Memilih cara menangani kegagalan saat menyediakan sumber daya di AWS CloudFormation Panduan Pengguna.

Tidak

-h, --help

Menampilkan pesan bantuan dan keluar.

Tidak

Contoh

Contoh Amazon Linux

Contoh berikut menunjukkan UserData properti EC2 instance, yang menjalankan InstallAndRun configset yang terkait dengan sumber daya. WebServerInstance

Untuk menyertakan versi terbaru, tambahkan yum install -y aws-cfn-bootstrap ke fileUserData.

JSON

UserDataproperti menggunakan fungsi Fn::Join intrinsik.

{
    "UserData": {
        "Fn::Base64": {
            "Fn::Join": [
                "",
                [
                    "#!/bin/bash -xe\n",
                    "",
                    "yum install -y aws-cfn-bootstrap",
                    "/opt/aws/bin/cfn-init -v ",
                    "         --stack ",
                    {
                        "Ref": "AWS::StackName"
                    },
                    "         --resource WebServerInstance ",
                    "         --configsets InstallAndRun ",
                    "         --region ",
                    {
                        "Ref": "AWS::Region"
                    },
                    "\n"
                ]
            ]
        }
    }
}

YAML

UserDataproperti menggunakan fungsi Fn::Sub intrinsik.

UserData: !Base64
  Fn::Sub: |-
    #!/bin/bash -xe
    yum update -y aws-cfn-bootstrap
    # Install the files and packages from the metadata
    /opt/aws/bin/cfn-init -v --stack ${AWS::StackName} --resource WebServerInstance --configsets InstallAndRun --region ${AWS::Region}

Untuk tutorial dengan contoh template, lihat Menyebarkan aplikasi di Amazon EC2 di Panduan AWS CloudFormation Pengguna.

Sebagai Windows contoh, lihat CloudFormation Tumpukan Windows berbasis Bootstrapping di Panduan Pengguna.AWS CloudFormation

Anda juga dapat mengunjungi GitHub repositori kami untuk mengunduh contoh templat yang digunakancfn-init, termasuk templat berikut.

Misalnya template stack LAMP yang menggunakancfn-init, lihat ec2-lamp-server di situs web. GitHub