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.
Gunakan antarmuka baris AWS Cloud Development Kit (AWS CDK) perintah (CLI) cdk gc
perintah untuk melakukan pengumpulan sampah pada aset yang tidak digunakan 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 AWS CloudFormation template yang 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 gc
Perintah 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://
. Misalnya,<account-id>
/<region>
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 Anda 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 AWS CLI sumber default.
Opsi
Untuk daftar opsi global yang berfungsi dengan semua CDK CLI perintah, lihatOpsi 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
— Mengeluarkan 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 ditentukan akan 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.
Ketika 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
cdk gc
perintah sebelumnya. 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 CDK CLI perintah yang masih dalam pengembangan.
Opsi ini diperlukan untuk menggunakan CDK apa pun CLI perintah yang masih dalam pengembangan dan dapat berubah.
Opsi ini dapat diberikan beberapa kali dalam satu perintah.
Untuk menggunakan
cdk 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>
... Found99
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