Bagian sumber daya dari file manifes cfCT

Topik ini menjelaskan bagian sumber daya dari file manifes cFct, di mana Anda akan menentukan sumber daya yang diperlukan untuk penyesuaian Anda. Bagian dari file manifes cfCT ini dimulai pada sumber daya kata kunci dan berlanjut ke akhir file.

Bagian sumber daya dari file manifes menentukan CloudFormation StackSets, atau AWS Organizations SCP dan RCP, yang digunakan CfCT secara otomatis melalui pipa kode. Anda dapat mencantumkan OU, akun, dan Wilayah untuk menerapkan instans tumpukan.

Instans tumpukan digunakan di tingkat akun, bukan tingkat OU. SCP dan RCP dikerahkan di tingkat OU. Untuk informasi selengkapnya, lihat Membuat penyesuaian Anda sendiri.

Template contoh berikut menjelaskan kemungkinan entri yang tersedia untuk bagian sumber daya dari file manifes.


resources: # List of resources
  - name: [String]
    resource_file: [String] [Local File Path, S3 URI, S3 URL] 
    deployment_targets: # account and/or organizational unit names
      accounts: # array of strings, [0-9]{12}
        - 012345678912
        - AccountName1
      organizational_units: #array of strings
        - OuName1
        - OuName2 
    deploy_method: scp | stack_set | rcp
    parameters: # List of parameters [SSM, Alfred, Values]
      - parameter_key: [String]
        parameter_value: [String]  
    export_outputs: # list of ssm parameters to store output values
      - name: /org/member/test-ssm/app-id
        value: $[output_ApplicationId]    
    regions: #list of strings
    - [String]

Sisa topik ini memberikan definisi terperinci untuk kata kunci yang ditunjukkan dalam contoh kode sebelumnya.

name — Nama yang terkait dengan CloudFormation StackSets. String yang Anda berikan memberikan nama yang lebih ramah pengguna untuk kumpulan tumpukan.

Tipe: String
Wajib: Ya
Nilai yang Valid: a-z, A-Z, 0-9, dan tanda hubung (-). Nama harus dimulai dengan karakter abjad.

deskripsi — Deskripsi untuk sumber daya.

Tipe: String
Wajib: Tidak

resource_file — File ini dapat ditentukan sebagai lokasi relatif ke file manifes, URI Amazon S3 atau URL yang menunjuk ke CloudFormation template atau kebijakan kontrol AWS Organizations layanan di JSON untuk membuat CloudFormation sumber daya, SCP, atau RCP.

Tipe: String
Wajib: Ya

Contoh berikut menunjukkanresource_file, diberikan sebagai lokasi relatif ke file sumber daya di dalam paket konfigurasi.
```
resources:
  - name: SecurityRoles
    resource_file: templates/custom-security.template
```

Contoh berikut menunjukkan file sumber daya yang diberikan sebagai URI Amazon S3


resources:
  - name: SecurityRoles
    resource_file: s3://amzn-s3-demo-bucket/[key-name]

Contoh berikut menunjukkan file sumber daya yang diberikan sebagai URL HTTPS Amazon S3
```
resources:
  - name: SecurityRoles
    resource_file: https://bucket-name.s3.Region.amazonaws.com/key-name
```
catatan
Jika Anda memberikan URL Amazon S3, verifikasi bahwa kebijakan bucket mengizinkan akses baca untuk akun manajemen AWS Control Tower tempat Anda menerapkan CfCT. Jika Anda memberikan URL HTTPS Amazon S3, verifikasi bahwa jalur tersebut menggunakan notasi titik. Misalnya, S3.us-west-1. CfCT tidak mendukung titik akhir yang berisi tanda hubung antara S3 dan Wilayah, seperti. S3‐us-west-2
Contoh berikut menunjukkan kebijakan bucket Amazon S3 dan ARN tempat sumber daya disimpan.
```
{
   "Version": "2012-10-17",
   "Statement": [
       {
        "Effect": "Allow",
        "Principal": {"AWS": "arn:aws:iam::AccountId:root"},
        "Action": "s3:GetObject",
        "Resource": "arn:aws:s3:::my-bucket/*”
       }
   ]
}  
```
Anda akan mengganti AccountId variabel yang ditunjukkan dalam contoh dengan ID AWS akun untuk akun manajemen yang menerapkan CfCT. Untuk contoh selengkapnya, lihat contoh kebijakan Bucket di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

parameter — Menentukan nama dan nilai untuk CloudFormation parameter.

Jenis MapList:
Wajib: Tidak

Bagian parameter berisi pasangan key/value parameter. Template semu berikut menguraikan bagian parameter.


parameters:
  - parameter_key: [String]
    parameter_value: [String]

parameter_key — Kunci yang terkait dengan parameter.
- Tipe: String
- Diperlukan: Ya (di bawah properti parameter)
- Nilai yang Valid: a-z, A-Z, dan 0-9
parameter_value — Nilai input yang terkait dengan parameter.
- Tipe: String
- Diperlukan: Ya (di bawah properti parameter)

deploy_method — Metode penerapan untuk menyebarkan sumber daya ke dalam akun. Saat ini, deploy_method mendukung penerapan sumber daya menggunakan stack_set opsi untuk penyebaran sumber daya melalui CloudFormation StackSets, scp opsi jika Anda menerapkan SCP, atau rcp opsi jika Anda menerapkan RCP.

Tipe: String
Nilai yang Valid: stack_set | scp | rcp
Wajib: Ya

deployment_target — Daftar akun atau Unit Organisasi (OU), di mana CfCT akan menyebarkan CloudFormation sumber daya, ditentukan sebagai akun atau organizational_units.

catatan

Jika Anda ingin menerapkan SCP atau RCP, targetnya harus OU, bukan akun.

Jenis: Daftar string account name atau account number untuk menunjukkan bahwa sumber daya ini akan digunakan ke daftar akun yang diberikan, atau OU names untuk menunjukkan bahwa sumber daya ini akan digunakan ke daftar OU yang diberikan.
Diperlukan: Setidaknya satu akun atau organizational_units
- akun:
  
  Jenis: Daftar string account name atau account number untuk menunjukkan bahwa sumber daya ini akan digunakan ke daftar akun yang diberikan.
- unit_organisasi:
  
  Jenis: Daftar string OU names untuk menunjukkan bahwa sumber daya ini akan digunakan ke daftar OU tertentu. Jika Anda menyediakan OU yang tidak berisi akun dan properti account tidak ditambahkan, CfCt hanya membuat kumpulan tumpukan.
  
  catatan
  ID akun manajemen organisasi bukanlah nilai yang diizinkan. CfCT tidak mendukung penerapan instans tumpukan ke akun manajemen organisasi, secara default. Jika Anda memiliki kasus penggunaan khusus, lihat Root OU.

export_output — Daftar name/value pasangan yang menunjukkan kunci parameter SSM. Kunci parameter SSM ini memungkinkan Anda untuk menyimpan output template ke dalam penyimpanan parameter SSM. Output dimaksudkan untuk referensi oleh sumber daya lain, yang didefinisikan sebelumnya dalam file manifes.


export_outputs: # List of SSM parameters
  - name: [String]
    value: [String]

Jenis: Daftar pasangan kunci nama dan nilai. Nama berisi name string kunci penyimpanan parameter SSM, dan nilai berisi value string parameter.
Nilai Valid: Setiap string atau $[output_CfnOutput-Logical-ID] variabel yang CfnOutput-Logical-ID sesuai dengan variabel keluaran template. Untuk informasi selengkapnya tentang bagian Output dalam CloudFormation template, lihat Output di Panduan CloudFormation Pengguna.
Wajib: Tidak

Misalnya, cuplikan kode berikut menyimpan variabel VPCID keluaran template ke dalam kunci parameter SSM yang diberi nama. /org/member/audit/vpc_id


export_outputs: # List of SSM parameters
  - name: /org/member/audit/VPC-ID
    value: $[output_VPCID]

catatan

Nama kunci export_output mungkin berisi nilai selain. output Misalnya, jika namanya /org/environment-name, nil ainya mungkinproduction.

wilayah — Daftar Wilayah di mana CfCT akan menerapkan instans CloudFormation tumpukan.

Jenis: Setiap daftar nama AWS Wilayah komersial, untuk menunjukkan bahwa sumber daya ini akan digunakan ke daftar Wilayah yang diberikan. Jika kata kunci ini tidak ada di file manifes, sumber daya digunakan di Wilayah beranda saja.
Wajib: Tidak

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

File manifes cfCT

Root OU