Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md). Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Tindakan 'AWS CDK menyebarkan' YAMAL Berikut ini adalah definisi YAMAL dari tindakan **AWS CDK penerapan**. Untuk mempelajari cara menggunakan tindakan ini, lihat[Menerapkan AWS CDK aplikasi dengan alur kerja](cdk-dep-action.md). Definisi tindakan ini ada sebagai bagian dalam file definisi alur kerja yang lebih luas. Untuk informasi selengkapnya tentang file ini, lihat[Alur kerja definisi YAMAL](workflow-reference.md). **catatan** Sebagian besar properti YAMB yang mengikuti memiliki elemen UI yang sesuai di editor visual. Untuk mencari elemen UI, gunakan **Ctrl\$1F**. Elemen akan terdaftar dengan properti YAMLnya yang terkait. ``` # The workflow definition starts here. # See Properti tingkat atas for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. CDKDeploy\$1nn: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: # Specify a source or an artifact, but not both. Sources: - source-name-1 Artifacts: - artifact-name Outputs: Artifacts: - Name: cdk_artifact Files: - "cdk.out/**/*" Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: StackName: my-cdk-stack Region: us-west-2 Tags: '{"key1": "value1", "key2": "value2"}' Context: '{"key1": "value1", "key2": "value2"}' CdkCliVersion: version CdkRootPath: directory-containing-cdk.json-file CfnOutputVariables: '["CnfOutputKey1","CfnOutputKey2","CfnOutputKey3"]' CloudAssemblyRootPath: path-to-cdk.out ``` ## CDKDeploy (Diperlukan) Tentukan nama tindakan. Semua nama tindakan harus unik dalam alur kerja. Nama aksi terbatas pada karakter alfanumerik (a-z, A-Z, 0-9), tanda hubung (-), dan garis bawah (\$1). Spasi tidak diizinkan. Anda tidak dapat menggunakan tanda kutip untuk mengaktifkan karakter dan spasi khusus dalam nama tindakan. Default: `CDKDeploy_nn`. UI yang sesuai: Tab konfigurasi/Nama **tindakan** ## Identifier (*CDKDeploy*/**Identifier**) (Diperlukan) Mengidentifikasi tindakan. Jangan mengubah properti ini kecuali Anda ingin mengubah versi. Untuk informasi selengkapnya, lihat [Menentukan versi tindakan yang akan digunakan](workflows-action-versions.md). **catatan** Menentukan `aws/cdk-deploy@v2` menyebabkan tindakan berjalan pada [gambar Maret 2024](build-images.md#build.default-image) yang menyertakan perkakas yang lebih baru seperti Node.js 18. Menentukan `aws/cdk-deploy@v1` menyebabkan tindakan berjalan pada [gambar November 2022](build-images.md#build.previous-image) yang menyertakan perkakas lama seperti Node.js 16. Default: `aws/cdk-deploy@v2`. **UI yang sesuai: Diagram alur CDKDeploy kerja/\$1nn/ aws/cdk-deploy @v2 label** ## DependsOn (*CDKDeploy*/**DependsOn**) (Opsional) Tentukan grup tindakan atau tindakan yang harus berjalan dengan sukses agar tindakan **AWS CDK penerapan** berjalan. Kami merekomendasikan untuk menentukan tindakan **AWS CDK bootstrap** di `DependsOn` properti, seperti ini: ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 DependsOn: - CDKBootstrap ``` **catatan** [Bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) adalah prasyarat wajib untuk menerapkan aplikasi. AWS CDK Jika Anda tidak menyertakan tindakan **AWS CDK Bootstrap** dalam alur kerja Anda, maka Anda harus menemukan cara lain untuk menyebarkan tumpukan AWS CDK bootstrap sebelum menjalankan tindakan **AWS CDK penerapan** Anda. Untuk informasi selengkapnya, lihat [Menambahkan tindakan 'AWS CDK deploy'](cdk-dep-action-add.md) di [Menerapkan AWS CDK aplikasi dengan alur kerja](cdk-dep-action.md). Untuk informasi selengkapnya tentang fungsionalitas 'tergantung pada', lihat. [Tindakan pengurutan](workflows-depends-on.md) UI yang sesuai: Tab **masukan/Tergantung pada** - opsional ## Compute (*CDKDeploy*/**Compute**) (Opsional) Mesin komputasi yang digunakan untuk menjalankan tindakan alur kerja Anda. Anda dapat menentukan komputasi baik di tingkat alur kerja atau di tingkat tindakan, tetapi tidak keduanya. Ketika ditentukan pada tingkat alur kerja, konfigurasi komputasi berlaku untuk semua tindakan yang ditentukan dalam alur kerja. Pada tingkat alur kerja, Anda juga dapat menjalankan beberapa tindakan pada instance yang sama. Untuk informasi selengkapnya, lihat [Berbagi komputasi di seluruh tindakan](compute-sharing.md). UI yang sesuai: *tidak ada* ## Type (*CDKDeploy*/Compute/**Type**) (Diperlukan [Compute](#cdk.dep.computename) jika disertakan) Jenis mesin komputasi. Anda dapat menggunakan salah satu nilai berikut: + **EC2**(editor visual) atau `EC2` (editor YAMAL) Dioptimalkan untuk fleksibilitas selama aksi berjalan. + **Lambda** (editor visual) atau `Lambda` (editor YAMAL) Kecepatan start-up aksi yang dioptimalkan. Untuk informasi selengkapnya tentang jenis komputasi, lihat[Jenis komputasi](workflows-working-compute.md#compute.types). **UI yang sesuai: Konfigurasi tab/Advanced - tipe opsional/Komputasi** ## Fleet (*CDKDeploy*/Compute/**Fleet**) (Opsional) Tentukan mesin atau armada yang akan menjalankan alur kerja atau tindakan alur kerja Anda. Dengan armada sesuai permintaan, ketika suatu tindakan dimulai, alur kerja menyediakan sumber daya yang dibutuhkan, dan mesin dihancurkan ketika tindakan selesai. Contoh armada sesuai permintaan:`Linux.x86-64.Large`,. `Linux.x86-64.XLarge` Untuk informasi lebih lanjut tentang armada sesuai permintaan, lihat. [Properti armada sesuai permintaan](workflows-working-compute.md#compute.on-demand) Dengan armada yang disediakan, Anda mengonfigurasi satu set mesin khusus untuk menjalankan tindakan alur kerja Anda. Mesin-mesin ini tetap menganggur, siap untuk memproses tindakan segera. Untuk informasi selengkapnya tentang armada yang disediakan, lihat. [Properti armada yang disediakan](workflows-working-compute.md#compute.provisioned-fleets) Jika `Fleet` dihilangkan, defaultnya adalah. `Linux.x86-64.Large` **UI yang sesuai: Konfigurasi tab/Advanced - armada opsional/Komputasi** ## Timeout (*CDKDeploy*/**Timeout**) (Diperlukan) Tentukan jumlah waktu dalam menit (editor YAMB), atau jam dan menit (editor visual), bahwa tindakan dapat berjalan sebelum CodeCatalyst mengakhiri tindakan. Minimal adalah 5 menit dan maksimum dijelaskan dalam[Kuota untuk alur kerja di CodeCatalyst](workflows-quotas.md). Batas waktu default sama dengan batas waktu maksimum. UI yang sesuai: Tab **konfigurasi/Timeout** - opsional ## Inputs (*CDKDeploy*/**Inputs**) (Opsional) `Inputs`Bagian ini mendefinisikan data yang `CDKDeploy` dibutuhkan selama menjalankan alur kerja. **catatan** Hanya satu input (baik sumber atau artefak) yang diizinkan untuk setiap tindakan **AWS CDK penerapan**. UI yang sesuai: **Tab input** ## Sources (*CDKDeploy*/Inputs/**Sources**) (Diperlukan jika AWS CDK aplikasi yang ingin Anda terapkan disimpan dalam repositori sumber) Jika AWS CDK aplikasi Anda disimpan dalam repositori sumber, tentukan label repositori sumber tersebut. Tindakan **AWS CDK penerapan** mensintesis aplikasi di repositori ini sebelum memulai proses penerapan. Saat ini, satu-satunya label yang didukung adalah`WorkflowSource`. Jika AWS CDK aplikasi Anda tidak terkandung dalam repositori sumber, itu harus berada dalam artefak yang dihasilkan oleh tindakan lain. Untuk informasi selengkapnya tentang sumber, lihat [Menghubungkan repositori sumber ke alur kerja](workflows-sources.md). UI yang sesuai: **Tab/Sumber** Input - opsional ## Artifacts - input (*CDKDeploy*/Inputs/**Artifacts**) (Diperlukan jika AWS CDK aplikasi yang ingin Anda terapkan disimpan dalam [artefak keluaran](workflows-working-artifacts-output.md) dari tindakan sebelumnya) Jika AWS CDK aplikasi Anda terkandung dalam artefak yang dihasilkan oleh tindakan sebelumnya, tentukan artefak tersebut di sini. Tindakan **AWS CDK penerapan** mensintesis aplikasi dalam artefak yang ditentukan ke dalam CloudFormation templat sebelum memulai proses penerapan. Jika AWS CDK aplikasi Anda tidak terkandung dalam artefak, itu harus berada di repositori sumber Anda. Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md). UI yang sesuai: Tab **masukan/Artefak** - opsional ## Outputs (*CDKDeploy*/**Outputs**) (Opsional) Mendefinisikan data yang dihasilkan oleh tindakan selama menjalankan alur kerja. UI yang sesuai: **Tab keluaran** ## Artifacts - output (*CDKDeploy*/Outputs/**Artifacts** (Opsional) Tentukan artefak yang dihasilkan oleh tindakan. Anda dapat mereferensikan artefak ini sebagai masukan dalam tindakan lain. Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md). **UI yang sesuai: Tab keluaran/Artefak** ## Name (*CDKDeploy*/Outputs/Artifacts/**Name**) (Diperlukan [Artifacts - output](#cdk.dep.outputs.artifacts) jika disertakan) Tentukan nama artefak yang akan berisi CloudFormation template yang disintesis oleh tindakan **AWS CDK penerapan saat runtime**. Nilai default-nya adalah `cdk_artifact`. Jika Anda tidak menentukan artefak, maka tindakan mensintesis template tetapi tidak akan menyimpannya dalam artefak. Pertimbangkan untuk menyimpan template yang disintesis dalam artefak untuk menyimpan catatannya untuk tujuan pengujian atau pemecahan masalah. **UI yang sesuai: Menghasilkan tab/Artifacts/Add artefak/Membangun nama artefak** ## Files (*CDKDeploy*/Outputs/Artifacts/**Files**) (Diperlukan [Artifacts - output](#cdk.dep.outputs.artifacts) jika disertakan) Tentukan file yang akan disertakan dalam artefak. Anda harus menentukan `"cdk.out/**/*"` untuk menyertakan CloudFormation template yang disintesis AWS CDK aplikasi Anda. **catatan** `cdk.out`adalah direktori default tempat file yang disintesis disimpan. Jika Anda menentukan direktori keluaran selain `cdk.out` di `cdk.json` file Anda, tentukan direktori itu di sini, bukan`cdk.out`. **UI yang sesuai: Mengeluarkan tab/Artifacts/Add artefak/File yang dihasilkan oleh build** ## Environment (*CDKDeploy*/**Environment**) (Diperlukan) Tentukan CodeCatalyst lingkungan yang akan digunakan dengan tindakan. Tindakan terhubung ke Akun AWS dan VPC Amazon opsional yang ditentukan di lingkungan yang dipilih. Tindakan ini menggunakan peran IAM default yang ditentukan di lingkungan untuk terhubung ke Akun AWS, dan menggunakan peran IAM yang ditentukan dalam [koneksi VPC Amazon untuk terhubung ke VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) Amazon. **catatan** Jika peran IAM default tidak memiliki izin yang diperlukan oleh tindakan, Anda dapat mengonfigurasi tindakan untuk menggunakan peran yang berbeda. Untuk informasi selengkapnya, lihat [Mengubah peran IAM dari suatu tindakan](deploy-environments-switch-role.md). Untuk informasi selengkapnya tentang lingkungan, lihat [Menyebarkan ke dalam Akun AWS dan VPCs](deploy-environments.md) dan[Pembuatan lingkungan](deploy-environments-creating-environment.md). **UI yang sesuai: Tab konfigurasi/Lingkungan** ## Name (*CDKDeploy*/Environment/**Name**) (Diperlukan [Environment](#cdk.dep.environment) jika disertakan) Tentukan nama lingkungan yang ada yang ingin Anda kaitkan dengan tindakan. **UI yang sesuai: Tab konfigurasi/Lingkungan** ## Connections (*CDKDeploy*/Environment/**Connections**) (Opsional dalam versi tindakan yang lebih baru; diperlukan dalam versi yang lebih lama) Tentukan koneksi akun untuk dikaitkan dengan tindakan. Anda dapat menentukan maksimum satu koneksi akun di bawah`Environment`. Jika Anda tidak menentukan koneksi akun: + Tindakan menggunakan Akun AWS koneksi dan peran IAM default yang ditentukan di lingkungan di CodeCatalyst konsol. Untuk informasi tentang menambahkan koneksi akun dan peran IAM default ke lingkungan, lihat[Pembuatan lingkungan](deploy-environments-creating-environment.md). + Peran IAM default harus menyertakan kebijakan dan izin yang diperlukan oleh tindakan. Untuk menentukan kebijakan dan izin tersebut, lihat deskripsi properti **Peran** dalam dokumentasi definisi YAMAL tindakan. Untuk informasi selengkapnya tentang koneksi akun, lihat[Memungkinkan akses ke AWS sumber daya yang terhubung Akun AWS](ipa-connect-account.md). Untuk informasi tentang menambahkan koneksi akun ke lingkungan, lihat[Pembuatan lingkungan](deploy-environments-creating-environment.md). UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan: + (Versi yang lebih baru) Konfigurasi tab/Environment/What masuk? *my-environment* **/menu tiga titik/Beralih peran** + **(Versi lama) Tab konfigurasi/' Environment/account/role AWS '/ koneksi akun** ## Name (*CDKDeploy*/Environment/Connections/**Name**) (Diperlukan [Connections](#cdk.dep.environment.connections) jika disertakan) Tentukan nama koneksi akun. UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan: + (Versi yang lebih baru) Konfigurasi tab/Environment/What masuk? *my-environment* **/menu tiga titik/Beralih peran** + **(Versi lama) Tab konfigurasi/' Environment/account/role AWS '/ koneksi akun** ## Role (*CDKDeploy*/Environment/Connections/**Role**) (Diperlukan [Connections](#cdk.dep.environment.connections) jika disertakan) Tentukan nama koneksi akun. Tentukan nama peran IAM yang **AWS CDK digunakan tindakan penerapan** untuk mengakses AWS dan menyebarkan tumpukan aplikasi. AWS CDK Pastikan Anda telah [menambahkan peran ke CodeCatalyst ruang Anda](ipa-connect-account-addroles.md), dan peran tersebut mencakup kebijakan berikut. Jika Anda tidak menentukan peran IAM, maka tindakan tersebut menggunakan peran IAM default yang tercantum di [lingkungan](deploy-environments.md) di CodeCatalyst konsol. Jika Anda menggunakan peran default di lingkungan, pastikan itu memiliki kebijakan berikut. + Kebijakan izin berikut: **Awas** Batasi izin untuk yang ditampilkan dalam kebijakan berikut. Menggunakan peran dengan izin yang lebih luas dapat menimbulkan risiko keamanan. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "cloudformation:DescribeStackEvents", "cloudformation:DescribeChangeSet", "cloudformation:DescribeStacks", "cloudformation:ListStackResources" ], "Resource": "*" }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "arn:aws:iam::111122223333:role/cdk-*" } ] } ``` ------ + Kebijakan kepercayaan khusus berikut: **catatan** Anda dapat menggunakan `CodeCatalystWorkflowDevelopmentRole-spaceName` peran dengan tindakan ini, jika Anda mau. Untuk informasi selengkapnya tentang peran ini, silakan lihat [Membuat **CodeCatalystWorkflowDevelopmentRole-*spaceName***peran untuk akun dan ruang Anda](ipa-iam-roles.md#ipa-iam-roles-service-create). Memahami bahwa `CodeCatalystWorkflowDevelopmentRole-spaceName` peran tersebut memiliki izin akses penuh yang dapat menimbulkan risiko keamanan. Kami menyarankan Anda hanya menggunakan peran ini dalam tutorial dan skenario di mana keamanan kurang menjadi perhatian. UI yang sesuai: Salah satu dari berikut ini tergantung pada versi tindakan: + (Versi yang lebih baru) Konfigurasi tab/Environment/What masuk? *my-environment* **/menu tiga titik/Beralih peran** + **(Versi lama) Tab konfigurasi/' '/ Environment/account/role Peran** ## Configuration (*CDKDeploy*/**Configuration**) (Diperlukan) Bagian di mana Anda dapat menentukan properti konfigurasi tindakan. UI yang sesuai: Tab **konfigurasi** ## StackName (*CDKDeploy*/Configuration/**StackName**) (Diperlukan) Nama tumpukan AWS CDK aplikasi Anda, seperti yang muncul di file entrypoint di direktori AWS CDK aplikasi Anda. `bin` Contoh berikut menunjukkan isi file TypeScript entrypoint, dengan nama stack disorot. *red italics* Jika file entrypoint Anda dalam bahasa yang berbeda, itu akan terlihat serupa. ``` import * as cdk from 'aws-cdk-lib'; import { CdkWorksopTypescriptStack } from '../lib/cdk_workshop_typescript-stack'; const app = new cdk.App(); new CdkWorkshopTypescriptStack(app, 'CdkWorkshopTypescriptStack'); ``` Anda hanya dapat menentukan satu tumpukan. **Tip** Jika Anda memiliki beberapa tumpukan, Anda dapat membuat tumpukan induk dengan tumpukan bersarang. Anda kemudian dapat menentukan tumpukan induk dalam tindakan ini untuk menerapkan semua tumpukan. UI yang sesuai: Tab konfigurasi/Nama **tumpukan** ## Region (*CDKDeploy*/Configuration/**Region**) (Opsional) Tentukan Wilayah AWS ke mana tumpukan AWS CDK aplikasi akan digunakan. Untuk daftar kode Wilayah, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes). Jika Anda tidak menentukan Wilayah, tindakan **AWS CDK penerapan** akan diterapkan ke Wilayah yang ditentukan dalam kode Anda AWS CDK . Untuk informasi selengkapnya, lihat [Lingkungan](https://docs.aws.amazon.com/cdk/v2/guide/environments.html) di *Panduan AWS Cloud Development Kit (AWS CDK) Pengembang*. **UI yang sesuai: Tab konfigurasi/Wilayah** ## Tags (*CDKDeploy*/Configuration/**Tags**) (Opsional) Tentukan tag yang ingin Anda terapkan ke AWS sumber daya di tumpukan AWS CDK aplikasi. Tag diterapkan ke tumpukan itu sendiri serta sumber daya individu di tumpukan. Untuk informasi selengkapnya tentang penandaan, lihat [Penandaan](https://docs.aws.amazon.com/cdk/v2/guide/tagging.html) di Panduan *AWS Cloud Development Kit (AWS CDK) Pengembang*. **UI yang sesuai: Konfigurasi tab/Advanced - opsional/Tag** ## Context (*CDKDeploy*/Configuration/**Context**) (Opsional) Tentukan konteks, dalam bentuk pasangan kunci-nilai, untuk dikaitkan dengan tumpukan aplikasi. AWS CDK *Untuk informasi selengkapnya tentang konteks, lihat konteks [Runtime di Panduan Pengembang](https://docs.aws.amazon.com/cdk/v2/guide/context.html).AWS Cloud Development Kit (AWS CDK) * **UI yang sesuai: Konfigurasi tab/Advanced - opsional/Konteks** ## CdkCliVersion (*CDKDeploy*/Configuration/**CdkCliVersion**) (Opsional) **Properti ini tersedia dengan versi 1.0.13 atau yang lebih baru dari tindakan **AWS CDK penerapan**, dan versi 1.0.8 atau yang lebih baru dari tindakan bootstrap.AWS CDK ** Tentukan satu dari yang berikut ini: + Versi lengkap dari AWS Cloud Development Kit (AWS CDK) Command Line Interface (CLI) (juga disebut AWS CDK Toolkit) yang Anda ingin tindakan ini untuk digunakan. Contoh:`2.102.1`. Pertimbangkan untuk menentukan versi lengkap untuk memastikan konsistensi dan stabilitas saat membangun dan menerapkan aplikasi Anda. Atau + `latest`. Pertimbangkan `latest` untuk menentukan untuk memanfaatkan fitur dan perbaikan terbaru CDK CLI. Tindakan akan mengunduh versi AWS CDK CLI yang ditentukan (atau versi terbaru) ke [gambar CodeCatalyst build](build-images.md), dan kemudian menggunakan versi ini untuk menjalankan perintah yang diperlukan untuk menyebarkan aplikasi CDK Anda atau mem-bootstrap lingkungan Anda. AWS [Untuk daftar versi CDK CLI yang didukung yang dapat Anda gunakan,AWS CDK lihat Versi.](https://docs.aws.amazon.com/cdk/api/versions.html) Jika Anda menghilangkan properti ini, tindakan menggunakan versi AWS CDK CLI default yang dijelaskan dalam salah satu topik berikut: + [Versi CDK CLI yang digunakan oleh tindakan 'penerapan'AWS CDK](cdk-dep-action.md#cdk-dep-action-cdk-version) + [Versi CDK CLI yang digunakan oleh tindakan AWS CDK "bootstrap”](cdk-boot-action.md#cdk-boot-action-cdk-version) UI yang sesuai: Tab konfigurasi/versi **AWS CDK CLI** ## CdkRootPath (*CDKDeploy*/Configuration/**CdkRootPath**) (Opsional) Path ke direktori yang berisi `cdk.json` file AWS CDK proyek Anda. Tindakan **AWS CDK penyebaran** berjalan dari folder ini, dan output apa pun yang dibuat oleh tindakan akan ditambahkan ke direktori ini. Jika tidak ditentukan, tindakan **AWS CDK penerapan** mengasumsikan bahwa `cdk.json` file tersebut ada di root proyek Anda. AWS CDK UI yang sesuai: Tab **konfigurasi/Direktori tempat cdk.json** berada ## CfnOutputVariables (*CDKDeploy*/Configuration/**CfnOutputVariables**) (Opsional) Tentukan `CfnOutput` konstruksi mana dalam kode AWS CDK aplikasi yang ingin Anda paparkan sebagai variabel keluaran alur kerja. Anda kemudian dapat mereferensikan variabel keluaran alur kerja dalam tindakan selanjutnya dalam alur kerja Anda. Untuk informasi lebih lanjut tentang variabel di CodeCatalyst, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md). Misalnya, jika kode AWS CDK aplikasi Anda terlihat seperti ini: ``` import { Duration, Stack, StackProps, CfnOutput, RemovalPolicy} from 'aws-cdk-lib'; import * as dynamodb from 'aws-cdk-lib/aws-dynamodb'; import * as s3 from 'aws-cdk-lib/aws-s3'; import { Construct } from 'constructs'; import * as cdk from 'aws-cdk-lib'; export class HelloCdkStack extends Stack { constructor(scope: Construct, id: string, props?: StackProps) { super(scope, id, props); const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', { removalPolicy: RemovalPolicy.DESTROY, }); new CfnOutput(this, 'bucketName', { value: bucket.bucketName, description: 'The name of the s3 bucket', exportName: 'amzn-s3-demo-bucket', }); const table = new dynamodb.Table(this, 'todos-table', { partitionKey: {name: 'todoId', type: dynamodb.AttributeType.NUMBER}, billingMode: dynamodb.BillingMode.PAY_PER_REQUEST, removalPolicy: RemovalPolicy.DESTROY, }) new CfnOutput(this, 'tableName', { value: table.tableName, description: 'The name of the dynamodb table', exportName: 'myDynamoDbTable', }); ... } } ``` ... dan `CfnOutputVariables` properti Anda terlihat seperti ini: ``` Configuration: ... CfnOutputVariables: '["bucketName","tableName"]' ``` ... maka tindakan menghasilkan variabel output alur kerja berikut: | Key | Nilai | | --- | --- | | bucketName | `bucket.bucketName` | | tableName | `table.tableName` | Anda kemudian dapat mereferensikan `tableName` variabel `bucketName` dan dalam tindakan selanjutnya. Untuk mempelajari cara mereferensikan variabel keluaran alur kerja dalam tindakan selanjutnya, lihat[Merujuk variabel yang telah ditentukan](workflows-working-with-variables-reference-output-vars.md). Jika Anda tidak menentukan `CfnOutput` konstruksi apa pun di `CfnOutputVariables` properti, maka tindakan tersebut mengekspos empat (atau lebih sedikit) variabel CloudFormation keluaran pertama yang ditemukannya sebagai variabel keluaran alur kerja. Untuk informasi selengkapnya, lihat [variabel 'AWS CDK penyebaran'](cdk-dep-action-variables.md). **Tip** Untuk mendapatkan daftar semua variabel CloudFormation keluaran yang dihasilkan tindakan, jalankan alur kerja yang berisi tindakan **AWS CDK penerapan** sekali, lalu lihat di tab **Log** tindakan. Log berisi daftar semua variabel CloudFormation keluaran yang terkait dengan AWS CDK aplikasi Anda. Setelah Anda tahu apa semua CloudFormation variabel, Anda dapat menentukan mana yang ingin Anda konversi ke variabel output alur kerja menggunakan `CfnOutputVariables` properti. Untuk informasi selengkapnya tentang variabel CloudFormation keluaran, lihat dokumentasi untuk `CfnOutput` konstruksi, yang tersedia di [class CfnOutput (construct)](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnOutput.html) di Referensi *AWS Cloud Development Kit (AWS CDK) API*. UI yang sesuai: Variabel **CloudFormation tab/output** konfigurasi ## CloudAssemblyRootPath (*CDKDeploy*/Configuration/**CloudAssemblyRootPath**) (Opsional) Jika Anda telah mensintesis tumpukan AWS CDK aplikasi ke dalam rakitan cloud (menggunakan `cdk synth` operasi), tentukan jalur root direktori perakitan cloud (`cdk.out`). CloudFormation Template yang terletak di direktori perakitan cloud yang ditentukan akan digunakan oleh tindakan **AWS CDK penerapan** ke dalam Anda Akun AWS menggunakan perintah. `cdk deploy --app` Ketika `--app` opsi hadir, `cdk synth` operasi tidak terjadi. Jika Anda tidak menentukan direktori perakitan cloud, maka tindakan **AWS CDK penerapan** akan menjalankan `cdk deploy` perintah tanpa `--app` opsi. Tanpa `--app` opsi, `cdk deploy` operasi akan mensintesis (`cdk synth`) dan menerapkan aplikasi Anda ke dalam AWS CDK aplikasi Anda. Akun AWS **Mengapa saya menentukan rakitan cloud yang sudah ada dan disintesis ketika tindakan "AWS CDK penerapan” dapat melakukan sintesis pada waktu berjalan?** Anda mungkin ingin menentukan rakitan cloud yang sudah ada dan disintesis ke: + **Pastikan bahwa kumpulan sumber daya yang sama persis digunakan setiap kali tindakan "AWS CDK penerapan” berjalan** Jika Anda tidak menentukan rakitan cloud, tindakan **AWS CDK penerapan dapat mensintesis dan menyebarkan** file yang berbeda tergantung pada kapan dijalankan. Misalnya, tindakan **AWS CDK penerapan** mungkin mensintesis perakitan cloud dengan satu set dependensi selama tahap pengujian, dan kumpulan dependensi lainnya selama tahap produksi (jika dependensi tersebut berubah di antara tahapan). Untuk menjamin paritas yang tepat antara apa yang diuji dan apa yang diterapkan, kami sarankan untuk mensintesis sekali dan kemudian menggunakan bidang **direktori perakitan Path to cloud** (editor visual) atau `CloudAssemblyRootPath` properti (editor YAMAL) untuk menentukan rakitan cloud yang sudah disintesis. + **Gunakan pengelola dan perkakas paket non-standar dengan aplikasi AWS CDK ** Selama `synth` operasi, tindakan **AWS CDK penerapan** mencoba menjalankan aplikasi Anda menggunakan alat standar seperti npm atau pip. Jika tindakan tidak berhasil menjalankan aplikasi Anda menggunakan alat tersebut, sintesis tidak akan terjadi dan tindakan akan gagal. Untuk mengatasi masalah ini, Anda dapat menentukan perintah persis yang diperlukan untuk menjalankan aplikasi dengan sukses di `cdk.json` file AWS CDK aplikasi, lalu mensintesis aplikasi Anda menggunakan metode yang tidak melibatkan tindakan **AWS CDK penerapan**. Setelah perakitan cloud dibuat, Anda dapat menentukannya di bidang **direktori Path to cloud assembly** (editor visual) atau `CloudAssemblyRootPath` properti (editor YAMAL) dari tindakan **AWS CDK penerapan**. Untuk informasi tentang mengonfigurasi `cdk.json` file agar menyertakan perintah untuk menginstal dan menjalankan AWS CDK aplikasi, lihat [Menentukan perintah aplikasi](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-app-command). *Untuk informasi tentang `cdk synth` perintah `cdk deploy` dan, serta `--app` opsi, lihat Menerapkan tumpukan, [Mensintesis tumpukan](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-deploy), dan [Melewati](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-deploy-nosynth) [sintesis di Panduan](https://docs.aws.amazon.com/cdk/v2/guide/cli.html#cli-synth) Pengembang.AWS Cloud Development Kit (AWS CDK) * Untuk informasi tentang rakitan cloud, lihat [Cloud Assembly di Referensi AWS Cloud Development Kit (AWS CDK)](https://docs.aws.amazon.com/cdk/api/v2/docs/cloud-assembly-schema-readme.html) *API*. UI yang sesuai: Tab **konfigurasi/Jalur ke direktori perakitan cloud**