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

CloudFormation StackSets menyebarkan referensi tindakan

CodePipeline menawarkan kemampuan untuk melakukan CloudFormation StackSets operasi sebagai bagian dari CI/CD proses Anda. Anda menggunakan kumpulan tumpukan untuk membuat tumpukan di AWS akun di seluruh AWS Wilayah dengan menggunakan satu CloudFormation templat. Semua sumber daya yang disertakan dalam setiap tumpukan ditentukan oleh CloudFormation template set tumpukan. Saat Anda membuat kumpulan tumpukan, Anda menentukan template yang akan digunakan, serta parameter dan kemampuan apa pun yang diperlukan template.

Untuk informasi selengkapnya tentang konsep untuk CloudFormation StackSets, lihat StackSets konsep di Panduan AWS CloudFormation Pengguna.

Anda mengintegrasikan pipeline CloudFormation StackSets melalui dua jenis tindakan berbeda yang Anda gunakan bersama:

Anda dapat menggunakan tindakan ini untuk menerapkan ke AWS akun target atau ID unit AWS organisasi target Organisasi.

Bagaimana CloudFormation StackSets tindakan bekerja

T CloudFormationStackSet indakan membuat atau memperbarui sumber daya tergantung pada apakah tindakan berjalan untuk pertama kalinya.

T CloudFormationStackSet ind akan membuat atau memperbarui kumpulan tumpukan dan menerapkan perubahan tersebut ke instance tertentu.

T CloudFormationStackInstances indakan membuat instans tumpukan baru atau memperbarui instans tumpukan yang sudah usang. Sebuah instance menjadi usang ketika kumpulan tumpukan diperbarui, tetapi tidak semua instance di dalamnya diperbarui.

Sebagai bagian dari pembaruan, CloudFormationStackInstances tindakan CloudFormationStackSet dan dapat menentukan target penerapan baru, yang membuat instans tumpukan baru.

Sebagai bagian dari pembaruan, CloudFormationStackInstances tindakan CloudFormationStackSet dan tidak menghapus kumpulan tumpukan, instance, atau sumber daya. Ketika tindakan memperbarui tumpukan tetapi tidak menentukan semua instance yang akan diperbarui, instance yang tidak ditentukan untuk pembaruan dihapus dari pembaruan dan disetel ke statusOUTDATED.

Selama penerapan, instans tumpukan juga dapat menunjukkan status OUTDATED jika penerapan ke instans gagal.

Bagaimana menyusun StackSets tindakan dalam pipa

Sebagai praktik terbaik, Anda harus membangun pipeline Anda sehingga kumpulan tumpukan dibuat dan awalnya diterapkan ke subset atau satu instance. Setelah menguji penerapan dan melihat kumpulan tumpukan yang dihasilkan, tambahkan CloudFormationStackInstances tindakan sehingga instans yang tersisa dibuat dan diperbarui.

Gunakan konsol atau CLI untuk membuat struktur pipa yang direkomendasikan sebagai berikut:

Saat Anda memulai pembaruan tumpukan di mana Anda telah menghapus target penerapan dari konfigurasi tindakan, maka instans tumpukan yang tidak ditunjuk untuk pembaruan dihapus dari penerapan dan pindah ke status USGGED. Misalnya, untuk pembaruan instans tumpukan untuk akun Account-A di mana us-east-2 Region dihapus dari konfigurasi tindakan, instans tumpukan yang tersisa dibuat dan instance yang dihapus disetel ke ODDATED sebagai berikut:

Untuk informasi selengkapnya tentang praktik terbaik untuk menerapkan kumpulan tumpukan, lihat Praktik terbaik untuk StackSets di Panduan AWS CloudFormation Pengguna.

Tindakan CloudFormationStackSet

Tindakan ini membuat atau memperbarui kumpulan tumpukan dari template yang disimpan di lokasi sumber pipeline.

Setelah menentukan kumpulan tumpukan, Anda dapat membuat, memperbarui, atau menghapus tumpukan di akun target dan Wilayah yang ditentukan dalam parameter konfigurasi. Saat membuat, memperbarui, dan menghapus tumpukan, Anda dapat menentukan preferensi lain, seperti urutan Wilayah untuk operasi yang akan dilakukan, persentase toleransi kegagalan di luar penghentian operasi tumpukan, dan jumlah akun di mana operasi dilakukan pada tumpukan secara bersamaan.

Satu set tumpukan adalah sumber daya regional. Jika Anda membuat kumpulan tumpukan di satu Wil AWS ayah, Anda tidak dapat mengaksesnya dari Wilayah lain.

Ketika tindakan ini digunakan sebagai tindakan pembaruan ke kumpulan tumpukan, pembaruan pada tumpukan tidak diizinkan tanpa penerapan ke setidaknya satu instans tumpukan.

Tipe tindakan

Parameter konfigurasi

Artefak masukan

Anda harus menyertakan setidaknya satu artefak input yang berisi template untuk kumpulan tumpukan dalam suatu CloudFormationStackSet tindakan. Anda dapat menyertakan lebih banyak artefak input untuk daftar target penerapan, akun, dan parameter.

Artefak keluaran

Variabel keluaran

Jika Anda mengonfigurasi tindakan ini, ia menghasilkan variabel yang dapat direferensikan oleh konfigurasi tindakan hilir dalam pipeline. Anda mengonfigurasi tindakan dengan namespace untuk membuat variabel-variabel tersebut tersedia untuk konfigurasi tindakan hilir.

Untuk informasi selengkapnya, lihat Referensi variabel.

Contoh CloudFormationStackSet konfigurasi tindakan

Contoh berikut menunjukkan konfigurasi tindakan untuk CloudFormationStackSet tindakan tersebut.

Contoh untuk model izin yang dikelola sendiri

Contoh berikut menunjukkan CloudFormationStackSet tindakan di mana target penerapan yang dimasukkan adalah ID AWS akun.

YAML

Name: CreateStackSet
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackSet
  Version: '1'
RunOrder: 1
Configuration:
  DeploymentTargets: '111111222222'
  FailureTolerancePercentage: '20'
  MaxConcurrentPercentage: '25'
  PermissionModel: SELF_MANAGED
  Regions: us-east-1
  StackSetName: my-stackset
  TemplatePath: 'SourceArtifact::template.json'
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: us-west-2
Namespace: DeployVariables

JSON

{
    "Name": "CreateStackSet",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackSet",
        "Version": "1"
    },
    "RunOrder": 1,
    "Configuration": {
        "DeploymentTargets": "111111222222",
        "FailureTolerancePercentage": "20",
        "MaxConcurrentPercentage": "25",
        "PermissionModel": "SELF_MANAGED",
        "Regions": "us-east-1",
        "StackSetName": "my-stackset",
        "TemplatePath": "SourceArtifact::template.json"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "us-west-2",
    "Namespace": "DeployVariables"
}

Contoh untuk model izin yang dikelola layanan

Contoh berikut menunjukkan CloudFormationStackSet tindakan untuk model izin yang dikelola layanan di mana opsi untuk penerapan otomatis ke AWS Organisasi diaktifkan dengan retensi tumpukan.

YAML

Name: Deploy
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackSet
  Version: '1'
RunOrder: 1
Configuration:
  Capabilities: 'CAPABILITY_IAM,CAPABILITY_NAMED_IAM'
  OrganizationsAutoDeployment: EnabledWithStackRetention
  PermissionModel: SERVICE_MANAGED
  StackSetName: stacks-orgs
  TemplatePath: 'SourceArtifact::template.json'
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: eu-central-1
Namespace: DeployVariables

JSON

{
    "Name": "Deploy",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackSet",
        "Version": "1"
    },
    "RunOrder": 1,
    "Configuration": {
        "Capabilities": "CAPABILITY_IAM,CAPABILITY_NAMED_IAM",
        "OrganizationsAutoDeployment": "EnabledWithStackRetention",
        "PermissionModel": "SERVICE_MANAGED",
        "StackSetName": "stacks-orgs",
        "TemplatePath": "SourceArtifact::template.json"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "eu-central-1",
    "Namespace": "DeployVariables"
}

T CloudFormationStackInstances indakan

Tindakan ini membuat instance baru dan menerapkan kumpulan tumpukan ke instans tertentu. Instans tumpukan adalah referensi ke tumpukan di akun target dalam Wilayah. Instance tumpukan dapat ada tanpa tumpukan; misalnya, jika pembuatan tumpukan tidak berhasil, instance tumpukan menunjukkan alasan kegagalan pembuatan tumpukan. Sebuah instans templat dikaitkan dengan hanya satu set tumpukan.

Setelah pembuatan kumpulan tumpukan awal, Anda dapat menambahkan instance tumpukan baru dengan menggunakanCloudFormationStackInstances. Nilai parameter template dapat diganti pada tingkat instance tumpukan selama membuat atau memperbarui operasi instance kumpulan tumpukan.

Setiap set tumpukan memiliki satu template dan set parameter template. Saat Anda memperbarui template atau parameter template, Anda memperbaruinya untuk seluruh rangkaian. Kemudian semua status instance disetel OUTDATED hingga perubahan diterapkan ke instance itu.

Untuk mengganti nilai parameter pada instance tertentu, misalnya, jika template berisi parameter untuk stage dengan nilaiprod, Anda dapat mengganti nilai parameter tersebut menjadi beta atau. gamma

Tipe tindakan

Parameter konfigurasi

Artefak masukan

CloudFormationStackInstancesdapat berisi artefak yang mencantumkan target dan parameter penerapan.

Artefak keluaran

Variabel keluaran

Ketika dikonfigurasi, tindakan ini menghasilkan variabel yang dapat direferensikan oleh konfigurasi tindakan hilir dalam pipeline. Anda mengonfigurasi tindakan dengan namespace untuk membuat variabel tersebut tersedia untuk konfigurasi tindakan hilir.

Untuk informasi selengkapnya, lihat Referensi variabel.

Contoh konfigurasi tindakan

Contoh berikut menunjukkan konfigurasi tindakan untuk CloudFormationStackInstances tindakan tersebut.

Contoh untuk model izin yang dikelola sendiri

Contoh berikut menunjukkan CloudFormationStackInstances tindakan di mana target penerapan yang dimasukkan adalah Akun AWS ID111111222222.

YAML

Name: my-instances
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackInstances
  Version: '1'
RunOrder: 2
Configuration:
  DeploymentTargets: '111111222222'
  Regions: 'us-east-1,us-east-2,us-west-1,us-west-2'
  StackSetName: my-stackset
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: us-west-2

JSON

{
    "Name": "my-instances",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackInstances",
        "Version": "1"
    },
    "RunOrder": 2,
    "Configuration": {
        "DeploymentTargets": "111111222222",
        "Regions": "us-east-1,us-east-2,us-west-1,us-west-2",
        "StackSetName": "my-stackset"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "us-west-2"
}

Contoh untuk model izin yang dikelola layanan

Contoh berikut menunjukkan CloudFormationStackInstances tindakan untuk model izin yang dikelola layanan di mana target penerapan adalah ID unit AWS organisasi Organisasi. ou-1111-1example

YAML

Name: Instances
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: CloudFormationStackInstances
  Version: '1'
RunOrder: 2
Configuration:
  DeploymentTargets: ou-1111-1example
  Regions: us-east-1
  StackSetName: my-stackset
OutputArtifacts: []
InputArtifacts:
  - Name: SourceArtifact
Region: eu-central-1

JSON

{
    "Name": "Instances",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "CloudFormationStackInstances",
        "Version": "1"
    },
    "RunOrder": 2,
    "Configuration": {
        "DeploymentTargets": "ou-1111-1example",
        "Regions": "us-east-1",
        "StackSetName": "my-stackset"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "SourceArtifact"
        }
    ],
    "Region": "eu-central-1"
}

Izin peran layanan: CloudFormationStackSet tindakan

Untuk CloudFormation StackSets tindakan, izin minimum berikut diperlukan.

Untuk CloudFormationStackSet tindakan tersebut, tambahkan berikut ini ke pernyataan kebijakan Anda:

{
    "Effect": "Allow",
    "Action": [
        "cloudformation:CreateStackSet",
        "cloudformation:UpdateStackSet",
        "cloudformation:CreateStackInstances",
        "cloudformation:DescribeStackSetOperation",
        "cloudformation:DescribeStackSet",
        "cloudformation:ListStackInstances"
    ],
    "Resource": "resource_ARN"
},

Izin peran layanan: CloudFormationStackInstances tindakan

Untuk CloudFormationStackInstances tindakan tersebut, tambahkan berikut ini ke pernyataan kebijakan Anda:

{
    "Effect": "Allow",
    "Action": [
        "cloudformation:CreateStackInstances",
        "cloudformation:DescribeStackSetOperation"
    ],
    "Resource": "resource_ARN"
},

Model izin untuk operasi kumpulan tumpukan

Karena CloudFormation StackSets melakukan operasi di beberapa akun, Anda harus menentukan izin yang diperlukan di akun tersebut sebelum Anda dapat membuat kumpulan tumpukan. Anda dapat menentukan izin melalui izin yang dikelola sendiri atau izin yang dikelola layanan.

Dengan izin yang dikelola sendiri, Anda membuat dua peran IAM yang diperlukan oleh StackSets - peran administrator seperti AWSCloudFormationStackSetAdministrationRole di akun tempat Anda menentukan kumpulan tumpukan dan peran eksekusi seperti AWSCloudFormationStackSetExecutionRole di setiap akun tempat Anda menerapkan instans kumpulan tumpukan. Menggunakan model izin ini, StackSets dapat menerapkan ke AWS akun mana pun di mana pengguna memiliki izin untuk membuat peran IAM. Untuk informasi selengkapnya, lihat Memberikan izin yang dikelola sendiri di Panduan AWS CloudFormation Pengguna.

Dengan izin yang dikelola layanan, Anda dapat menerapkan instans tumpukan ke akun yang dikelola oleh AWS Organisasi. Menggunakan model izin ini, Anda tidak perlu membuat peran IAM yang diperlukan karena StackSets membuat peran IAM atas nama Anda. Dengan model ini, Anda juga dapat mengaktifkan penerapan otomatis ke akun yang ditambahkan ke organisasi di masa mendatang. Lihat Mengaktifkan akses tepercaya dengan AWS Organisasi di Panduan AWS CloudFormation Pengguna.

Jenis data parameter template

Parameter template yang digunakan dalam operasi set tumpukan mencakup tipe data berikut. Untuk informasi selengkapnya, lihat DescribeStackSet.

Setiap set tumpukan memiliki satu template dan set parameter template. Saat Anda memperbarui template atau parameter template, Anda memperbaruinya untuk seluruh rangkaian. Kemudian semua status instance disetel ke DISETEL hingga perubahan diterapkan ke instance itu.

Untuk mengganti nilai parameter pada instance tertentu, misalnya, jika template berisi parameter untuk stage dengan nilaiprod, Anda dapat mengganti nilai parameter tersebut menjadi beta atau. gamma

Lihat juga

Sumber daya terkait berikut dapat membantu Anda saat Anda mengerjakan tindakan ini.