

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.

# Bootstrapping AWS CDK aplikasi dengan alur kerja
<a name="cdk-boot-action"></a>

Bagian ini menjelaskan cara bootstrap AWS CDK aplikasi menggunakan CodeCatalyst alur kerja. Untuk mencapai ini, Anda harus menambahkan tindakan **AWS CDK bootstrap** ke alur kerja Anda. Tindakan **AWS CDK bootstrap** menyediakan tumpukan bootstrap di AWS lingkungan Anda menggunakan [template modern](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template). Jika tumpukan bootstrap sudah ada, tindakan akan memperbaruinya jika perlu. Memiliki tumpukan bootstrap yang ada di dalamnya AWS adalah prasyarat untuk menerapkan aplikasi. AWS CDK 

*Untuk informasi selengkapnya tentang bootstrap, lihat [Bootstrapping di Panduan Pengembang](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html).AWS Cloud Development Kit (AWS CDK) *

**Topics**
+ [Kapan menggunakan tindakan 'AWS CDK bootstrap'](#cdk-boot-action-when-to-use)
+ [Bagaimana tindakan 'AWS CDK bootstrap' bekerja](#cdk-boot-action-how-it-works)
+ [Versi CDK CLI yang digunakan oleh tindakan AWS CDK "bootstrap”](#cdk-boot-action-cdk-version)
+ [Gambar runtime yang digunakan oleh aksi 'AWS CDK bootstrap'](#cdk-boot-action-runtime)
+ [Contoh: Bootstrapping aplikasi AWS CDK](cdk-boot-action-example-workflow.md)
+ [Menambahkan aksi 'AWS CDK bootstrap'](cdk-boot-action-add.md)
+ [Variabel 'AWS CDK bootstrap'](cdk-boot-action-variables.md)
+ [Aksi 'AWS CDK bootstrap' YAMAL](cdk-boot-action-ref.md)

## Kapan menggunakan tindakan 'AWS CDK bootstrap'
<a name="cdk-boot-action-when-to-use"></a>

Gunakan tindakan ini jika Anda memiliki alur kerja yang menerapkan AWS CDK aplikasi, dan Anda ingin menerapkan (dan memperbarui, jika perlu) tumpukan bootstrap secara bersamaan. Dalam kasus ini, Anda akan menambahkan tindakan **AWS CDK bootstrap** ke alur kerja yang sama dengan yang menerapkan aplikasi Anda AWS CDK .

**Jangan** gunakan tindakan ini jika salah satu dari berikut ini berlaku:
+ Anda sudah menerapkan tumpukan bootstrap menggunakan mekanisme lain, dan Anda ingin menjaganya tetap utuh (tidak ada pembaruan).
+ Anda ingin menggunakan [template bootstrap khusus](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing), yang tidak didukung dengan tindakan **AWS CDK bootstrap**.

## Bagaimana tindakan 'AWS CDK bootstrap' bekerja
<a name="cdk-boot-action-how-it-works"></a>

**AWS CDK Bootstrap** bekerja sebagai berikut:

1. [Saat runtime, jika Anda menentukan versi 1.0.7 atau tindakan sebelumnya, tindakan akan mengunduh CDK CLI terbaru (juga disebut AWS CDK Tookit) ke image build. CodeCatalyst ](build-images.md)

   Jika Anda menentukan versi 1.0.8 atau yang lebih baru, tindakan tersebut dibundel dengan [versi tertentu](cdk-dep-action.md#cdk-dep-action-cdk-version) dari CDK CLI, jadi tidak ada unduhan yang terjadi.

1. Tindakan menggunakan CDK CLI untuk menjalankan `cdk bootstrap` perintah. *Perintah ini melakukan tugas bootstrap yang dijelaskan dalam topik [Bootstrapping](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) di Panduan Pengembang.AWS Cloud Development Kit (AWS CDK) *

## Versi CDK CLI yang digunakan oleh tindakan AWS CDK "bootstrap”
<a name="cdk-boot-action-cdk-version"></a>

**Tabel berikut menunjukkan versi CDK CLI mana yang digunakan secara default oleh berbagai versi tindakan bootstrap AWS CDK .**

**catatan**  
Anda mungkin dapat mengganti default. Untuk informasi selengkapnya, lihat [CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version) di [Aksi 'AWS CDK bootstrap' YAMAL](cdk-boot-action-ref.md).


| Versi AWS CDK tindakan 'bootstrap' | AWS CDK Versi CLI | 
| --- | --- | 
|  1.0.0 — 1.0.7  |  terbaru  | 
|  1.0.8 atau lebih baru  |  2.99.1  | 

## Gambar runtime yang digunakan oleh aksi 'AWS CDK bootstrap'
<a name="cdk-boot-action-runtime"></a>

Tabel berikut menunjukkan gambar lingkungan runtime yang CodeCatalyst digunakan untuk menjalankan berbagai versi tindakan **AWS CDK bootstrap**. Gambar-gambar tersebut mencakup berbagai set perkakas yang sudah diinstal sebelumnya. Untuk informasi selengkapnya, lihat [Gambar aktif](build-images.md#build-curated-images).

**catatan**  
Kami merekomendasikan untuk meningkatkan tindakan **AWS CDK bootstrap** Anda ke versi 2.x untuk memanfaatkan perkakas terbaru yang tersedia pada gambar Maret 2024. Untuk memutakhirkan tindakan, setel `Identifier` propertinya ke `aws/cdk-bootstrap@v2` dalam file definisi alur kerja Anda. Untuk informasi selengkapnya, lihat [Tindakan 'AWS CDK menyebarkan' YAMAL](cdk-dep-action-ref.md). 


| Versi AWS CDK tindakan 'bootstrap' | Gambar lingkungan runtime | 
| --- | --- | 
|  1.x  |  Gambar November 2022  | 
|  2.x  |  Maret 2024 foto  | 

# Contoh: Bootstrapping aplikasi AWS CDK
<a name="cdk-boot-action-example-workflow"></a>

Lihat [Contoh: Menerapkan aplikasi AWS CDK](cdk-dep-action-example-workflow.md) di [Menerapkan AWS CDK aplikasi dengan alur kerja](cdk-dep-action.md) untuk alur kerja yang mencakup tindakan **AWS CDK bootstrap**.

# Menambahkan aksi 'AWS CDK bootstrap'
<a name="cdk-boot-action-add"></a>

 Gunakan petunjuk berikut untuk menambahkan tindakan **AWS CDK bootstrap** ke alur kerja Anda. 

**Sebelum Anda memulai**

Sebelum Anda dapat menggunakan tindakan **AWS CDK bootstrap**, pastikan Anda memiliki AWS CDK aplikasi yang siap. Tindakan bootstrap akan mensintesis AWS CDK aplikasi sebelum bootstrap. Anda dapat menulis aplikasi Anda dalam bahasa pemrograman apa pun yang didukung oleh AWS CDK.

Pastikan file AWS CDK aplikasi Anda tersedia di:
+ Sebuah [repositori CodeCatalyst sumber](source.md), atau 
+ [Artefak CodeCatalyst keluaran](workflows-working-artifacts.md) yang dihasilkan oleh aksi alur kerja lain

------
#### [ Visual ]

**Untuk menambahkan tindakan 'AWS CDK bootstrap' menggunakan editor visual**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

1. Pilih **Edit**.

1. Pilih **Visual**.

1. Di kiri atas, pilih **\$1 Tindakan** untuk membuka katalog tindakan.

1. Dari daftar drop-down, pilih **Amazon CodeCatalyst**.

1. Cari tindakan **AWS CDK bootstrap**, dan lakukan salah satu hal berikut:
   + Pilih tanda plus (**\$1**) untuk menambahkan tindakan ke diagram alur kerja dan buka panel konfigurasinya.

     Atau
   + Pilih **AWS CDK bootstrap**. Kotak dialog detail tindakan muncul. Pada kotak dialog ini:
     + (Opsional) Pilih **Lihat sumber** untuk [melihat kode sumber tindakan](workflows-view-source.md#workflows-view-source.title).
     + Pilih **Tambahkan ke alur kerja** untuk menambahkan tindakan ke diagram alur kerja dan buka panel konfigurasinya.

1. Pada tab **Input**, **Konfigurasi**, dan **Output**, lengkapi bidang sesuai dengan kebutuhan Anda. Untuk deskripsi setiap bidang, lihat[Aksi 'AWS CDK bootstrap' YAMAL](cdk-boot-action-ref.md). Referensi ini memberikan informasi rinci tentang setiap bidang (dan nilai properti YAMAL yang sesuai) seperti yang muncul di YAMAL dan editor visual.

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, lalu pilih **Komit** lagi.
**catatan**  
Jika tindakan **AWS CDK bootstrap** Anda gagal dengan `npm install` kesalahan, lihat [Bagaimana cara memperbaiki kesalahan “npm install”?](troubleshooting-workflows.md#troubleshooting-workflows-npm) untuk informasi tentang cara memperbaiki kesalahan.

------
#### [ YAML ]

**Untuk menambahkan tindakan 'AWS CDK bootstrap' menggunakan editor YAMAL**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Di kiri atas, pilih **\$1 Tindakan** untuk membuka katalog tindakan.

1. Dari daftar drop-down, pilih **Amazon CodeCatalyst**.

1. Cari tindakan **AWS CDK bootstrap**, dan pilih **\$1** untuk menambahkannya ke diagram alur kerja dan buka panel konfigurasinya.

1. Ubah properti dalam kode YAMAL sesuai dengan kebutuhan Anda. Penjelasan tentang setiap properti yang tersedia disediakan di[Aksi 'AWS CDK bootstrap' YAMAL](cdk-boot-action-ref.md).

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, lalu pilih **Komit** lagi.
**catatan**  
Jika tindakan **AWS CDK bootstrap** Anda gagal dengan `npm install` kesalahan, lihat [Bagaimana cara memperbaiki kesalahan “npm install”?](troubleshooting-workflows.md#troubleshooting-workflows-npm) untuk informasi tentang cara memperbaiki kesalahan.

------

# Variabel 'AWS CDK bootstrap'
<a name="cdk-boot-action-variables"></a>

Tindakan **AWS CDK bootstrap** menghasilkan dan menetapkan variabel berikut pada waktu berjalan. Ini dikenal sebagai *variabel yang telah ditentukan*.

Untuk informasi tentang mereferensikan variabel-variabel ini dalam alur kerja, lihat. [Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md)


| Key | Nilai | 
| --- | --- | 
|  platform penyebaran  |  Nama platform penyebaran. Hardcode ke. `AWS:CloudFormation`  | 
|  region  |  Kode wilayah tempat Wilayah AWS tumpukan AWS CDK bootstrap digunakan selama alur kerja dijalankan. Contoh: `us-west-2`  | 
|  tumpukan-id  |  Nama Sumber Daya Amazon (ARN) dari tumpukan bootstrap yang diterapkan AWS CDK . Contoh: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df`  | 
|  LEWATI PENYEBARAN  |  Nilai `true` menunjukkan bahwa penerapan tumpukan AWS CDK bootstrap Anda dilewati selama alur kerja dijalankan. Penerapan tumpukan akan dilewati jika tidak ada perubahan dalam tumpukan sejak penerapan terakhir. Variabel ini hanya diproduksi jika nilainya`true`. Hardcode ke. `true`  | 

# Aksi 'AWS CDK bootstrap' YAMAL
<a name="cdk-boot-action-ref"></a>

Berikut ini adalah definisi YAMAL dari tindakan **AWS CDK bootstrap**. Untuk mempelajari cara menggunakan tindakan ini, lihat[Bootstrapping AWS CDK aplikasi dengan alur kerja](cdk-boot-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.    
  CDKBootstrapAction\$1nn: 
    Identifier: aws/cdk-bootstrap@v2
    DependsOn:
      - action-name
    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_bootstrap_artifacts
          Files: 
            - "cdk.out/**/*"
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: iam-role-name
    Configuration:
      Region: us-west-2
      CdkCliVersion: version
```

## CDKBootstrapAction
<a name="cdk.boot.name"></a>

(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: `CDKBootstrapAction_nn`.

UI yang sesuai: Tab **konfigurasi/Nama tampilan tindakan**

## Identifier
<a name="cdk.boot.identifier"></a>

(*CDKBootstrapAction*/**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-bootstrap@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-bootstrap@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-bootstrap@v2`.

**UI yang sesuai: Diagram alur CDKBootstrapAction kerja/\$1nn/ aws/cdk-bootstrap @v2 label**

## DependsOn
<a name="cdk.boot.dependson"></a>

(*CDKBootstrapAction*/**DependsOn**)

(Opsional)

Tentukan tindakan, grup tindakan, atau gerbang yang harus berjalan dengan sukses agar tindakan ini berjalan.

Untuk informasi selengkapnya tentang fungsionalitas 'tergantung pada', lihat. [Tindakan pengurutan](workflows-depends-on.md)

UI yang sesuai: Tab **masukan/Tergantung pada** - opsional

## Compute
<a name="cdk.boot.computename"></a>

(*CDKBootstrapAction*/**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
<a name="cdk.boot.computetype"></a>

(*CDKBootstrapAction*/Compute/**Type**)

(Diperlukan [Compute](#cdk.boot.computename) jika disertakan)

Jenis mesin komputasi. Anda dapat menggunakan salah satu nilai berikut:
+ **EC2**(editor visual) atau `EC2` (editor YAMB)

  Dioptimalkan untuk fleksibilitas selama aksi berjalan.
+ **Lambda** (editor visual) atau `Lambda` (editor YAMG)

  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
<a name="cdk.boot.computefleet"></a>

(*CDKBootstrapAction*/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 lebih lanjut 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
<a name="cdk.boot.timeout"></a>

(*CDKBootstrapAction*/**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
<a name="cdk.boot.inputs"></a>

(*CDKBootstrapAction*/**Inputs**)

(Opsional)

`Inputs`Bagian ini mendefinisikan data yang dibutuhkan tindakan **AWS CDK bootstrap** selama menjalankan alur kerja.

UI yang sesuai: **Tab input**

**catatan**  
Hanya satu input (baik sumber atau artefak) yang diizinkan untuk setiap tindakan **AWS CDK bootstrap**.

## Sources
<a name="cdk.boot.inputs.sources"></a>

(*CDKBootstrapAction*/Inputs/**Sources**)

(Diperlukan jika AWS CDK aplikasi Anda disimpan dalam repositori sumber)

Jika AWS CDK aplikasi Anda disimpan dalam repositori sumber, tentukan label repositori sumber tersebut. Tindakan **AWS CDK bootstrap** mensintesis aplikasi di repositori ini sebelum memulai proses bootstrap. Saat ini, satu-satunya label repositori 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
<a name="cdk.boot.inputs.artifacts"></a>

(*CDKBootstrapAction*/Inputs/**Artifacts**)

(Diperlukan jika AWS CDK aplikasi Anda 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 bootstrap** mensintesis aplikasi dalam artefak yang ditentukan ke dalam CloudFormation template sebelum memulai proses bootstrap. 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: Input **tab/Artefak** - opsional

## Outputs
<a name="cdk.boot.outputs"></a>

(*CDKBootstrapAction*/**Outputs**)

(Opsional)

Mendefinisikan data yang dihasilkan oleh tindakan selama menjalankan alur kerja.

UI yang sesuai: **Tab keluaran**

## Artifacts - output
<a name="cdk.boot.outputs.artifacts"></a>

(*CDKBootstrapAction*/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
<a name="cdk.boot.outputs.artifacts.name"></a>

(*CDKBootstrapAction*/Outputs/Artifacts/**Name**)

(Diperlukan [Artifacts - output](#cdk.boot.outputs.artifacts) jika disertakan)

Tentukan nama artefak yang akan berisi CloudFormation template yang disintesis oleh aksi **AWS CDK bootstrap** saat runtime. Nilai default-nya adalah `cdk_bootstrap_artifacts`. 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
<a name="cdk.boot.outputs.artifacts.files"></a>

(*CDKBootstrapAction*/Outputs/Artifacts/**Files**)

(Diperlukan [Artifacts - output](#cdk.boot.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
<a name="cdk.boot.environment"></a>

(*CDKBootstrapAction*/**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 lebih lanjut 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
<a name="cdk.boot.environment.name"></a>

(*CDKBootstrapAction*/Environment/**Name**)

(Diperlukan [Environment](#cdk.boot.environment) jika disertakan)

Tentukan nama lingkungan yang ada yang ingin Anda kaitkan dengan tindakan.

**UI yang sesuai: Tab konfigurasi/Lingkungan**

## Connections
<a name="cdk.boot.environment.connections"></a>

(*CDKBootstrapAction*/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
<a name="cdk.boot.environment.connections.name"></a>

(*CDKBootstrapAction*/Environment/Connections/**Name**)

(Diperlukan [Connections](#cdk.boot.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
<a name="cdk.boot.environment.connections.role"></a>

(*CDKBootstrapAction*/Environment/Connections/**Role**)

(Diperlukan [Connections](#cdk.boot.environment.connections) jika disertakan)

Tentukan nama peran IAM yang digunakan tindakan **AWS CDK bootstrap** untuk mengakses AWS dan menambahkan tumpukan bootstrap. 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 yang sesuai.

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
<a name="cdk.boot.configuration"></a>

(*CDKBootstrapAction*/**Configuration**)

(Diperlukan)

Bagian di mana Anda dapat menentukan properti konfigurasi tindakan.

UI yang sesuai: Tab **konfigurasi**

## Region
<a name="cdk.boot.region"></a>

(*CDKBootstrapAction*/Configuration/**Region**)

(Diperlukan)

Tentukan Wilayah AWS ke mana tumpukan bootstrap akan digunakan. Wilayah ini harus cocok dengan yang digunakan AWS CDK aplikasi Anda. Untuk daftar kode Wilayah, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes).

**UI yang sesuai: Tab konfigurasi/Wilayah**

## CdkCliVersion
<a name="cdk.boot.cdk.cli.version"></a>

(*CDKBootstrapAction*/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**