Panduan migrasi untuk AWS CLI versi 2 - AWS Command Line Interface
Menggunakan Alat Migrasi AWS CLI untuk Mengurangi KerusakanMemilih Antara Mode Upgrade Debug dan Alat Migrasi AWS CLI v1-ke-v2Topik tambahan di bagian ini

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

Panduan migrasi untuk AWS CLI versi 2

Bagian ini berisi instruksi untuk memperbarui AWS CLI versi 1 ke AWS CLI versi 2. AWS CLI Versi 2 dibangun di atas AWS CLI versi 1 dan mencakup fitur dan penyempurnaan berdasarkan umpan balik komunitas. AWS CLI Versi 2 adalah versi utama terbaru AWS CLI dan mendukung semua fitur terbaru. Beberapa fitur yang diperkenalkan di versi 2 tidak di-backport ke versi 1 dan Anda harus meningkatkan untuk mengakses fitur-fitur tersebut.

Untuk mencegah masalah yang tidak terduga, sebelum Anda bermigrasi ke versi 2, pelajari tentang perbedaan antar versi. AWS CLI Versi 2 mencakup fitur dan perubahan baru yang mungkin mengharuskan Anda memperbarui skrip atau perintah untuk kompatibilitas mundur.

AWS CLI versi 1 dan 2 menggunakan nama aws perintah yang sama. Jika Anda memiliki kedua versi yang diinstal, komputer Anda menggunakan yang pertama ditemukan di jalur pencarian Anda. Ini dapat mengakibatkan nama aws perintah Anda memanggil AWS CLI versi lama Anda, bahkan ketika Anda telah menginstal yang baru.

Untuk memperbarui ke AWS CLI versi 2, ikuti salah satu petunjuk di bawah ini:

Menggunakan Alat Migrasi AWS CLI untuk Mengurangi Kerusakan

Ada perubahan perilaku antara AWS CLI versi 1 dan AWS CLI versi 2 yang mungkin mengharuskan Anda memperbarui skrip atau perintah Anda. Memutakhirkan ke AWS CLI versi 2 tanpa memverifikasi bahwa skrip Anda yang ada dimigrasikan dengan aman berisiko menghadapi efek tak terduga saat menjalankan skrip dengan AWS CLI versi 2, seperti membuat perubahan yang tidak diinginkan pada sumber daya di akun Anda. AWS

Ada dua alat AWS milik yang dapat Anda gunakan untuk memandu migrasi Anda. Terlepas dari alat mana yang Anda gunakan, kami sarankan Anda referensi Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2 dalam Fitur baru dan perubahan dalam AWS CLI versi 2 panduan ini.

Upgrade Mode Debug

Upgrade mode debug adalah fitur dalam AWS CLI versi 1 yang tersedia dalam 1.44.0 versi dan lebih tinggi. Ketika fitur ini diaktifkan, setiap perintah AWS CLI yang Anda jalankan diperiksa untuk menentukan apakah kemungkinan memiliki perilaku yang berbeda di AWS CLI versi 2, dengan asumsi lingkungan eksekusi tetap sama. Jika perintah yang dijalankan akan memiliki perilaku yang berbeda di AWS CLI versi 2, peringatan akan ditampilkan di samping output perintah dengan tindakan yang disarankan yang dapat diambil untuk mempertahankan perilaku CLI versi 1 di AWS AWS CLI versi 2.

Alasan utama untuk menggunakan mode debug pemutakhiran untuk memandu migrasi Anda adalah karena ia memiliki cakupan yang tinggi untuk mendeteksi apakah perintah akan menghadapi perubahan perilaku. 14 dari 15 perubahan yang melanggar yang dijelaskan dalam Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2 dapat dideteksi dengan mode debug pemutakhiran—lihat Batasan keterbatasan fitur ini. Menggunakan mode debug upgrade untuk memutakhirkan AWS CLI versi 1 ke AWS CLI versi 2 Di sisi lain, kelemahan utama menggunakan mode debug pemutakhiran adalah bahwa outputnya hanya relevan dalam lingkungan pelaksanaannya; jika ada pengaturan konfigurasi AWS CLI yang berubah di lingkungan setelah bermigrasi ke AWS CLI versi 2, perubahan yang melanggar mungkin masih terjadi, dan Anda harus memverifikasi ulang menggunakan mode debug upgrade di lingkungan yang diperbarui.

AWS Alat Migrasi CLI v1-ke-v2

AWS CLI v1-to-v2 Migration Tool adalah alat mandiri yang dapat digunakan dengan Python 3.9 dan lebih tinggi. Alat ini adalah linter statis yang berjalan secara independen dari AWS CLI. Ini menghubungkan skrip bash yang berisi perintah AWS CLI versi 1 yang mungkin memiliki perilaku berbeda di CLI versi 2. AWS Untuk sebagian besar perintah yang terdeteksi kemungkinan memiliki perilaku yang berbeda di AWS CLI versi 2, ia dapat secara otomatis memperbarui perintah dalam skrip untuk mempertahankan perilaku CLI versi 1 di AWS AWS CLI versi 2.

Alasan utama untuk menggunakan Alat Migrasi AWS CLI v1-ke-v2 untuk memandu migrasi Anda adalah karena ia dapat secara otomatis memperbarui skrip Anda untuk mempertahankan perilaku CLI AWS versi 1 di AWS CLI versi 2, menghemat waktu dan upaya Anda dalam membuat pembaruan sendiri. Di sisi lain, kelemahan utama menggunakan alat migrasi adalah ia memiliki cakupan yang lebih rendah untuk mendeteksi apakah perintah akan menghadapi perubahan perilaku. Menjadi alat statis, itu tidak memeriksa perubahan perilaku yang ditentukan saat runtime.

Memilih Antara Mode Upgrade Debug dan Alat Migrasi AWS CLI v1-ke-v2

Tabel berikut menyoroti perbedaan utama antara mode debug upgrade dan Alat Migrasi AWS CLI v1-ke-v2, dan dapat digunakan untuk membantu memandu Anda memilih alat yang tepat untuk kasus penggunaan Anda.

Tingkatkan mode debug AWS Alat Migrasi CLI v1-ke-v2
Mendeteksi 14 dari 15 perubahan yang melanggar antara AWS CLI versi 1 dan AWS CLI versi 2. Mendeteksi 7 dari 15 perubahan yang melanggar antara AWS CLI versi 1 dan AWS CLI versi 2.
Kompatibel dengan program terminal apa pun yang dapat menjalankan AWS CLI. Hanya mendukung skrip bash linting.
Membutuhkan AWS CLI versi 1, versi 1.44.0 atau lebih tinggi. Berjalan secara independen dari AWS CLI; itu tidak memerlukan AWS CLI untuk diinstal.
Perbaikan manual harus dilakukan untuk mempertahankan perilaku AWS CLI versi 1 di AWS CLI versi 2. Secara otomatis memperbaiki sebagian besar perintah AWS CLI versi 1 yang terdeteksi kemungkinan memiliki perilaku yang berbeda di AWS CLI versi 2.
Deteksi dan perbaikan yang disarankan hanya relevan dengan lingkungan eksekusi (yaitu konfigurasi AWS CLI) tempat dieksekusi. Deteksi dan perbaikan yang disarankan tidak tergantung pada lingkungan.
Memerlukan mengeksekusi setiap perintah AWS CLI yang sedang diuji untuk perubahan perilaku. Tidak memerlukan mengeksekusi perintah AWS CLI apa pun. Hanya perlu dieksekusi sekali per skrip bash.
Memiliki tepat 5 kasus yang diketahui di mana ia akan menghasilkan deteksi positif palsu. Memiliki tepat 3 kasus yang diketahui di mana ia akan menghasilkan deteksi positif palsu.

Tabel berikut menunjukkan mana yang Memecahkan perubahan antara AWS CLI versi 1 dan AWS CLI versi 2 didukung di masing-masing dari dua alat migrasi.

Melanggar perubahan Terdeteksi dengan mode upgrade debug Terdeteksi oleh Alat AWS Migrasi CLI v1-ke-v2
Variabel lingkungan ditambahkan untuk mengatur pengkodean file teks Ya Tidak
Parameter biner dilewatkan sebagai string yang dikodekan base64 secara default Ya Ya
Peningkatan penanganan Amazon S3 dari properti file dan tag untuk salinan multipart Ya Ya
Tidak ada pengambilan otomatis http:// atau https:// URLs untuk parameter Ya Tidak
Pager digunakan untuk semua output secara default Ya Ya
Nilai keluaran stempel waktu distandarisasi ke format ISO 8601 Ya Tidak
Peningkatan penanganan CloudFormation penerapan yang tidak menghasilkan perubahan Ya Ya
Mengubah perilaku default untuk titik akhir Amazon S3 Regional untuk Wilayah us-east-1 Ya Tidak
Mengubah perilaku default untuk titik AWS STS akhir Regional Ya Tidak
ecr get-logindihapus dan diganti dengan ecr get-login-password Ya Ya
AWS CLI dukungan versi 2 untuk plugin berubah Ya Tidak
Dukungan alias tersembunyi dihapus Ya Ya
Pengaturan file api_versions konfigurasi tidak didukung Ya Tidak
AWS CLI versi 2 hanya menggunakan Signature v4 untuk mengautentikasi permintaan Amazon S3 Ya Tidak
AWS CLI versi 2 lebih konsisten dengan parameter paging Ya Ya
AWS CLI versi 2 menyediakan kode pengembalian yang lebih konsisten di semua perintah Tidak Tidak

Topik tambahan di bagian ini