cdk gc - AWS Cloud Development Kit (AWS CDK) v2
PenggunaanPendapatOpsiContoh

Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 yang lebih lama memasuki pemeliharaan pada 1 Juni 2022 dan mengakhiri dukungan pada 1 Juni 2023.

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

cdk gc

Gunakan perintah AWS Cloud Development Kit (AWS CDK) command line interface (CLIcdk gc) untuk melakukan pengumpulan sampah pada aset yang tidak terpakai yang disimpan dalam sumber daya tumpukan bootstrap Anda. Gunakan perintah ini untuk melihat, mengelola, dan menghapus aset yang tidak lagi Anda perlukan.

Untuk aset Amazon Simple Storage Service (Amazon S3), CDK CLI akan memeriksa template yang AWS CloudFormation ada di lingkungan yang sama untuk melihat apakah mereka direferensikan. Jika tidak direferensikan, mereka akan dianggap tidak terpakai dan memenuhi syarat untuk tindakan pengumpulan sampah.

Awas

cdk gcPerintah ini sedang dalam pengembangan untuk AWS CDK. Fitur saat ini dari perintah ini dianggap siap produksi dan aman digunakan. Namun, ruang lingkup perintah ini dan fitur-fiturnya dapat berubah. Oleh karena itu, Anda harus ikut serta dengan memberikan unstable=gc opsi untuk menggunakan perintah ini.

Penggunaan

$ cdk gc <arguments> <options>

Pendapat

AWS lingkungan

AWS Lingkungan target untuk melakukan tindakan pengumpulan sampah pada.

Saat menyediakan lingkungan, gunakan format berikut:aws://<account-id>/<region>. Misalnya, aws://<123456789012>/<us-east-1>.

Argumen ini dapat diberikan beberapa kali dalam satu perintah untuk melakukan tindakan pengumpulan sampah di beberapa lingkungan.

Secara default, CDK CLI akan melakukan tindakan pengumpulan sampah di semua lingkungan yang Anda referensikan di aplikasi CDK atau berikan sebagai argumen. Jika Anda tidak menyediakan lingkungan, CDK CLI akan menentukan lingkungan dari sumber default. Sumber-sumber ini mencakup lingkungan yang Anda tentukan menggunakan --profile opsi, variabel lingkungan, atau sumber AWS CLI default.

Opsi

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, lihat Opsi global.

--action <STRING>

Tindakan yang cdk gc dilakukan pada aset Anda selama pengumpulan sampah.

  • delete-tagged— Menghapus aset yang telah ditandai dengan tanggal dalam rentang hari buffer yang Anda berikan, tetapi tidak menandai aset yang tidak digunakan yang baru diidentifikasi.

  • full— Lakukan semua tindakan pengumpulan sampah. Ini termasuk menghapus aset dalam rentang hari buffer yang Anda berikan dan menandai aset yang tidak digunakan yang baru diidentifikasi.

  • print— Menghasilkan jumlah aset yang tidak digunakan pada prompt perintah tetapi tidak membuat perubahan aktual dalam lingkungan Anda AWS .

  • tag— Menandai aset yang tidak digunakan yang baru diidentifikasi, tetapi tidak menghapus aset apa pun dalam rentang hari buffer yang Anda berikan.

Nilai yang diterima:delete-tagged,full,print, tag

Nilai default: full

--bootstrap-stack-name <STRING>

Nama tumpukan bootstrap CDK di AWS lingkungan Anda. Berikan opsi ini jika Anda menyesuaikan nama tumpukan bootstrap Anda. Jika Anda menggunakan nama CDKToolkit tumpukan default, Anda tidak perlu memberikan opsi ini.

Nilai default: CDKToolkit

--confirm <BOOLEAN>

Tentukan apakah CDK CLI akan meminta konfirmasi manual dari Anda sebelum menghapus aset apa pun.

Tentukan false untuk menghapus aset secara otomatis tanpa meminta Anda untuk konfirmasi manual.

Nilai default: true

--created-buffer-days <NUMBER>

Jumlah hari aset harus ada sebelum memenuhi syarat untuk tindakan pengumpulan sampah.

Saat Anda memberikan nomor, aset yang belum ada di luar jumlah hari yang Anda tentukan disaring dari tindakan pengumpulan sampah.

Nilai default: 1

--help, -h <BOOLEAN>

Tampilkan informasi referensi perintah untuk cdk gc perintah.

--rollback-buffer-days <NUMBER>

Jumlah hari aset harus ditandai sebagai terisolasi sebelum memenuhi syarat untuk tindakan pengumpulan sampah.

Saat Anda memberikan nomor, CDK CLI akan menandai aset yang tidak digunakan dengan tanggal saat ini alih-alih menghapusnya. CDK CLI juga akan memeriksa apakah ada aset yang telah ditandai selama menjalankan perintah sebelumnya. cdk gc Aset yang diberi tag sebelumnya yang termasuk dalam rentang hari buffer yang Anda berikan akan dihapus.

Nilai default: 0

--type <STRING>

Jenis sumber daya bootstrap dalam tumpukan bootstrap Anda untuk melakukan tindakan pengumpulan sampah.

  • all— Lakukan tindakan pengumpulan sampah pada semua sumber daya yang di-bootstrap.

  • ecr— Lakukan tindakan pengumpulan sampah pada aset di repositori Amazon Elastic Container Registry (Amazon ECR) Registry ECR) dari tumpukan bootstrap Anda.

  • s3— Lakukan tindakan pengumpulan sampah pada aset di bucket Amazon S3 dari tumpukan bootstrap Anda.

Nilai yang diterima:all,ecr, s3

Nilai default: all

--unstable <STRING>

Izinkan penggunaan perintah CDK CLI yang masih dalam pengembangan.

Opsi ini diperlukan untuk menggunakan perintah CDK CLI apa pun yang masih dalam pengembangan dan dapat berubah.

Opsi ini dapat diberikan beberapa kali dalam satu perintah.

Untuk menggunakancdk gc, sediakan--unstable=gc.

Contoh

Contoh dasar

Contoh berikut meminta Anda untuk konfirmasi manual untuk melakukan tindakan pengumpulan sampah default pada aset di bucket Amazon S3 dari tumpukan bootstrap Anda:

$ cdk gc --unstable=gc --type=s3

 ⏳  Garbage Collecting environment aws://<account-id>/<region>...
Found 99 assets to delete based off of the following criteria:
- assets have been isolated for > 0 days
- assets were created > 1 days ago

Delete this batch (yes/no/delete-all)?

Contoh berikut melakukan tindakan pengumpulan sampah pada berbagai aset di bucket Amazon S3 dari tumpukan bootstrap Anda. Rentang ini mencakup aset yang sebelumnya telah ditandai oleh cdk gc selama lebih dari 30 hari dan telah dibuat 10 hari atau lebih. Perintah ini akan meminta konfirmasi manual sebelum menghapus aset apa pun:

$ cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10

Contoh berikut melakukan tindakan menghapus aset yang diberi tag sebelumnya di bucket Amazon S3 dari tumpukan bootstrap Anda yang telah tidak digunakan selama lebih dari 30 hari:

$ cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30