AppSpec Bagian 'sumber daya' (hanya Amazon ECS dan AWS Lambda penerapan) - AWS CodeDeploy

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

AppSpec Bagian 'sumber daya' (hanya Amazon ECS dan AWS Lambda penerapan)

Konten di 'resources' bagian AppSpec file bervariasi, tergantung pada platform komputasi penerapan Anda. 'resources'Bagian untuk ECS penyebaran Amazon berisi definisi ECS tugas Amazon, wadah, dan port untuk merutekan lalu lintas ke set ECS tugas Amazon yang diperbarui, dan informasi opsional lainnya. 'resources'Bagian untuk AWS Lambda penerapan berisi nama, alias, versi saat ini, dan versi target dari fungsi Lambda.

AppSpec Bagian 'sumber daya' untuk penerapan AWS Lambda

'resources'Bagian ini menentukan fungsi Lambda untuk menyebarkan dan memiliki struktur berikut:

YAML:

resources: - name-of-function-to-deploy: type: "AWS::Lambda::Function" properties: name: name-of-lambda-function-to-deploy alias: alias-of-lambda-function-to-deploy currentversion: version-of-the-lambda-function-traffic-currently-points-to targetversion: version-of-the-lambda-function-to-shift-traffic-to

JSON:

"resources": [ { "name-of-function-to-deploy" { "type": "AWS::Lambda::Function", "properties": { "name": "name-of-lambda-function-to-deploy", "alias": "alias-of-lambda-function-to-deploy", "currentversion": "version-of-the-lambda-function-traffic-currently-points-to", "targetversion": "version-of-the-lambda-function-to-shift-traffic-to" } } } ]

Setiap properti ditentukan dengan string.

  • name – Wajib. Ini adalah nama fungsi Lambda yang akan digunakan.

  • alias – Wajib. Ini adalah nama alias untuk fungsi Lambda.

  • currentversion – Wajib. Ini adalah versi lalu lintas fungsi Lambda yang saat ini menunjuk ke. Nilai ini harus berupa bilangan bulat positif yang valid.

  • targetversion – Wajib. Ini adalah versi lalu lintas fungsi Lambda yang digeser ke. Nilai ini harus berupa bilangan bulat positif yang valid.

AppSpec Bagian 'sumber daya' untuk ECS penerapan Amazon

'resources'Bagian ini menentukan ECS layanan Amazon untuk diterapkan dan memiliki struktur berikut:

YAML:

Resources: - TargetService: Type: AWS::ECS::Service Properties: TaskDefinition: "task-definition-arn" LoadBalancerInfo: ContainerName: "ecs-container-name" ContainerPort: "ecs-application-port" # Optional properties PlatformVersion: "ecs-service-platform-version" NetworkConfiguration: AwsvpcConfiguration: Subnets: ["ecs-subnet-1","ecs-subnet-n"] SecurityGroups: ["ecs-security-group-1","ecs-security-group-n"] AssignPublicIp: "ENABLED | DISABLED" CapacityProviderStrategy: - Base: integer CapacityProvider: "capacityProviderA" Weight: integer - Base: integer CapacityProvider: "capacityProviderB" Weight: integer

JSON:

"Resources": [ { "TargetService": { "Type": "AWS::ECS::Service", "Properties": { "TaskDefinition": "task-definition-arn", "LoadBalancerInfo": { "ContainerName": "ecs-container-name", "ContainerPort": "ecs-application-port" }, "PlatformVersion": "ecs-service-platform-version", "NetworkConfiguration": { "AwsvpcConfiguration": { "Subnets": [ "ecs-subnet-1", "ecs-subnet-n" ], "SecurityGroups": [ "ecs-security-group-1", "ecs-security-group-n" ], "AssignPublicIp": "ENABLED | DISABLED" } }, "CapacityProviderStrategy": [ { "Base": integer, "CapacityProvider": "capacityProviderA", "Weight": integer }, { "Base": integer, "CapacityProvider": "capacityProviderB", "Weight": integer } ] } } } ]

Setiap properti ditentukan dengan string kecuali untukContainerPort, yang merupakan angka.

  • TaskDefinition – Wajib. Ini adalah definisi tugas untuk ECS layanan Amazon untuk diterapkan. Ini ditentukan dengan ARN definisi tugas. ARNFormatnya adalaharn:aws:ecs:aws-region:account-id:task-definition/task-definition-family:task-definition-revision. Untuk informasi selengkapnya, lihat Amazon Resource Names (ARNs) dan ruang nama AWS layanan.

    catatan

    :task-definition-revisionBagian dari ARN adalah opsional. Jika dihilangkan, Amazon ECS menggunakan ACTIVE revisi terbaru dari definisi tugas.

  • ContainerName – Wajib. Ini adalah nama ECS wadah Amazon yang berisi ECS aplikasi Amazon Anda. Itu harus berupa wadah yang ditentukan dalam definisi ECS tugas Amazon Anda.

  • ContainerPort – Wajib. Ini adalah port pada kontainer tempat lalu lintas akan diarahkan ke.

  • PlatformVersion: Opsional. Versi platform dari tugas Fargate dalam layanan Amazon ECS yang digunakan. Untuk informasi selengkapnya, lihat Versi platform AWS Fargate. Jika tidak ditentukan, LATEST digunakan secara default.

  • NetworkConfiguration: Opsional. Di bawahAwsvpcConfiguration, Anda dapat menentukan yang berikut ini. Untuk informasi selengkapnya, lihat AwsVpcConfigurationdi APIReferensi Layanan ECS Kontainer Amazon.

    • Subnets: Opsional. Daftar terpisah koma dari satu atau beberapa subnet di layanan Amazon Anda. ECS

    • SecurityGroups: Opsional. Daftar terpisah koma dari satu atau beberapa grup keamanan di Amazon Elastic Container Service Anda.

    • AssignPublicIp: Opsional. String yang menentukan apakah elastic network interface ECS layanan Amazon Anda menerima alamat IP publik. Nilai yang valid adalah ENABLED dan DISABLED.

    catatan

    Semua atau tidak ada pengaturan di bawah NetworkConfiguration harus ditentukan. Misalnya, jika Anda ingin menentukanSubnets, Anda juga harus menentukan SecurityGroups danAssignPublicIp. Jika tidak ada yang ditentukan, CodeDeploy gunakan ECS pengaturan Amazon jaringan saat ini.

  • CapacityProviderStrategy: Opsional. Daftar penyedia ECS kapasitas Amazon yang ingin Anda gunakan untuk penyebaran Anda. Untuk informasi selengkapnya, lihat Penyedia ECS kapasitas Amazon di Panduan Pengembang Layanan Kontainer Elastis Amazon. Untuk setiap penyedia kapasitas, Anda dapat menentukan pengaturan berikut. Untuk detail tentang pengaturan ini, lihat AWS:ECS::: ServiceCapacityProviderStrategyItem di Panduan AWS CloudFormation Pengguna

    • Base: Opsional. Nilai dasar menandakan berapa banyak tugas, dengan angka minimum, yang berjalan pada penyedia kapasitas tertentu. Hanya satu penyedia kapasitas di strategi penyedia kapasitas yang dapat menentukan nilai dasar. Jika tidak ada nilai yang ditentukan, nilai default 0 digunakan.

    • CapacityProvider: Opsional. Nama singkat dari penyedia kapasitas. Contoh: capacityProviderA

    • Weight: Opsional.

      Nilai bobot menandakan persentase relatif dari jumlah total tugas yang diluncurkan yang harus menggunakan penyedia kapasitas tertentu. Nilai weight dipertimbangkan setelah nilai base, jika ditentukan, dianggap memuaskan.

      Jika tidak ada nilai weight yang ditentukan, nilai default 0 digunakan. Ketika beberapa penyedia kapasitas ditentukan dalam strategi penyedia kapasitas, setidaknya satu dari penyedia kapasitas harus memiliki nilai bobot lebih besar dari nol dan penyedia kapasitas apa pun dengan bobot 0 tidak akan digunakan untuk menempatkan tugas. Jika Anda menentukan beberapa penyedia kapasitas dalam strategi di mana semua memiliki bobot 0, tindakan RunTask atau CreateService apa pun yang menggunakan strategi penyedia kapasitas akan gagal.

      Contoh skenario untuk penggunaan bobot yang menentukan strategi yang berisi dua penyedia kapasitas dan keduanya memiliki bobot 1, jadi ketika base dianggap memuaskan, tugas akan dibagi secara merata ke dua penyedia kapasitas. Menggunakan logika yang sama, jika Anda menentukan bobot 1 untuk capacityProviderA dan bobot 4 untuk capacityProviderB, maka untuk setiap tugas yang dijalankan menggunakan capacityProviderA, empat tugas akan menggunakan capacityProviderB.