Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan AWS CLI
Bab ini memberikan langkah-langkah untuk memulai dengan versi 2 dari AWS Command Line Interface (AWS CLI) dan menyediakan tautan ke instruksi yang relevan.
1. **[Lengkapi semua prasyarat](getting-started-prereqs.md)** - Untuk mengakses AWS layanan dengan AWS CLI, Anda memerlukan minimal kredenal dan IAM. Akun AWS Untuk meningkatkan keamanan AWS akun Anda, kami sarankan Anda tidak menggunakan kredensi akun root Anda. Anda harus membuat pengguna dengan hak istimewa paling sedikit untuk memberikan kredensi akses ke tugas yang akan Anda jalankan. AWS
1. Instal atau dapatkan akses ke AWS CLI menggunakan salah satu metode berikut:
+ **(Direkomendasikan)**[Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md).
+ [Menginstal rilis sebelumnya dari AWS CLI versi 2](getting-started-version.md). Menginstal versi tertentu terutama digunakan jika tim Anda menyelaraskan alat mereka ke versi tertentu.
+ [Membangun dan memasang AWS CLI dari sumber](getting-started-source-install.md). Membangun AWS CLI from GitHub source adalah metode yang lebih mendalam yang terutama digunakan oleh pelanggan yang bekerja pada platform yang tidak kami dukung secara langsung dengan installer pra-bangun kami.
+ [Menjalankan gambar Amazon ECR Public atau Docker resmi untuk AWS CLI](getting-started-docker.md).
+ Akses AWS CLI versi 2 di AWS konsol dari browser Anda menggunakan AWS CloudShell. Untuk informasi selengkapnya, silakan lihat [Panduan Pengguna AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/).
1. [Setelah Anda memiliki akses ke AWS CLI, konfigurasikan AWS CLI dengan kredenal IAM Anda untuk penggunaan pertama kali](getting-started-quickstart.md).
**Mengatasi masalah penginstal atau mengkonfigurasi kesalahan**
Jika Anda mengalami masalah setelah menginstal, mencopot pemasangan, atau mengonfigurasi AWS CLI, lihat [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md) langkah-langkah pemecahan masalah.
**Topics**
+ [Prasyarat untuk menggunakan versi 2 AWS CLI](getting-started-prereqs.md)
+ [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md)
+ [Menginstal rilis sebelumnya dari AWS CLI versi 2](getting-started-version.md)
+ [Membangun dan memasang AWS CLI dari sumber](getting-started-source-install.md)
+ [Menjalankan gambar Amazon ECR Public atau Docker resmi untuk AWS CLI](getting-started-docker.md)
+ [Menyiapkan AWS CLI](getting-started-quickstart.md)
# Prasyarat untuk menggunakan versi 2 AWS CLI
Untuk mengakses AWS layanan dengan AWS CLI, Anda memerlukan kredensi Akun AWS dengan IAM atau IAM Identity Center. Saat menjalankan AWS CLI perintah, AWS CLI kebutuhan untuk memiliki akses ke AWS kredensional tersebut. Untuk meningkatkan keamanan AWS akun Anda, kami sarankan Anda hanya menggunakan kredensi berumur pendek saat menggunakan pengguna root atau IAM. Anda harus membuat pengguna dengan hak istimewa paling sedikit untuk memberikan kredensi akses ke tugas yang akan Anda jalankan. AWS Untuk informasi tentang praktik terbaik, lihat [Praktik terbaik keamanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) di Panduan Pengguna IAM.
**Topics**
+ [Buat akun administratif IAM atau IAM Identity Center](#getting-started-prereqs-iam)
+ [Langkah selanjutnya](#getting-started-prereqs-next)
## Buat akun administratif IAM atau IAM Identity Center
Sebelum Anda dapat mengkonfigurasi AWS CLI, Anda perlu membuat akun IAM atau IAM Identity Center.
**Opsi pembuatan akun**
| Pilih cara untuk mengelola kredensional Anda | Untuk | Cara membuat akun | Cara mengkonfigurasi akses terprogram ke akun |
| --- | --- | --- | --- |
| AWS Kredensi Konsol Manajemen | Gunakan kredensi jangka pendek yang sesuai dengan pengguna root yang dibuat selama pengaturan akun awal, pengguna IAM, atau identitas gabungan dari penyedia identitas Anda. | Buka [https://portal.aws.amazon.com/billing/pendaftaran](https://portal.aws.amazon.com/billing/signup) dan ikuti instruksi online. | Tidak ada langkah tambahan yang diperlukan. Untuk masuk ke AWS akun AWS CLI dengan Anda, lihat [Login untuk pengembangan AWS lokal menggunakan kredensi konsol](cli-configure-sign-in.md) |
| Pusat Identitas IAM | Gunakan kredensi jangka pendek untuk mengakses AWS layanan. | Mengikuti petunjuk di Memulai di Panduan Pengguna Pusat AWS Identitas IAM. | Konfigurasikan akses terprogram dengan Mengonfigurasi yang akan digunakan dalam Panduan Pengguna Pusat AWS Identitas IAM. |
| AWS Identity and Access Management(Tidak direkomendasikan) | Gunakan kredensi jangka panjang untuk mengakses AWS layanan. | Mengikuti petunjuk di Buat akses darurat di Panduan Pengguna IAM. | Konfigurasikan akses terprogram dengan Mengelola kunci akses untuk pengguna di Panduan Pengguna IAM. |
## Langkah selanjutnya
Setelah membuat kredensi Akun AWS dan IAM, untuk menggunakan AWS CLI Anda dapat melakukan salah satu hal berikut:
+ [Instal rilis terbaru](getting-started-install.md) AWS CLI versi 2 di komputer Anda.
+ [Instal rilis AWS CLI versi 2 sebelumnya](getting-started-version.md) di komputer Anda.
+ Akses AWS CLI versi 2 dari komputer Anda [menggunakan gambar Docker](getting-started-docker.md).
+ Akses AWS CLI versi 2 di AWS konsol dari browser Anda menggunakan AWS CloudShell. Untuk informasi selengkapnya, lihat [AWS CloudShell Panduan Pengguna](https://docs.aws.amazon.com/cloudshell/latest/userguide/).
# Menginstal atau memperbarui ke versi terbaru dari AWS CLI
Topik ini menjelaskan cara menginstal atau memperbarui rilis terbaru dari AWS Command Line Interface (AWS CLI) pada sistem operasi yang didukung. Untuk informasi tentang rilis terbaru AWS CLI, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. GitHub
Untuk menginstal rilis sebelumnya AWS CLI, lihat[Menginstal rilis sebelumnya dari AWS CLI versi 2](getting-started-version.md). Untuk petunjuk uninstall, lihat[Menghapus instalan AWS CLI versi 2](uninstall.md).
**penting**
AWS CLI versi 1 dan 2 menggunakan nama `aws` perintah yang sama. Jika sebelumnya Anda menginstal AWS CLI versi 1, lihat[Panduan migrasi untuk AWS CLI versi 2](cliv2-migration.md).
**Topics**
+ [AWS CLI menginstal dan memperbarui instruksi](#getting-started-install-instructions)
+ [Memecahkan masalah kesalahan AWS CLI pemasangan dan uninstall](#install-tshoot)
+ [Langkah selanjutnya](#install-next-steps)
## AWS CLI menginstal dan memperbarui instruksi
Untuk instruksi instalasi, perluas bagian untuk sistem operasi Anda.
### Linux
#### Instal dan perbarui persyaratan
+ Anda harus dapat mengekstrak atau “unzip” paket yang diunduh. Gunakan ekuivalen jika sistem pengoperasian Anda tidak memiliki perintah `unzip`.
+ AWS CLI Kegunaannya`glibc`,`groff`, dan`less`. Ini disertakan secara default di sebagian besar distribusi utama Linux.
+ Kami mendukung versi 64-bit dari distribusi terbaru CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2, Amazon Linux 2023, dan Linux ARM. AWS CLI
+ Karena AWS tidak memelihara repositori pihak ketiga selain`snap`, kami tidak dapat menjamin bahwa repositori tersebut berisi versi terbaru dari. AWS CLI
#### Instal atau perbarui AWS CLI
**Awas**
Jika ini adalah pertama kalinya Anda memperbarui di Amazon Linux, untuk menginstal versi terbaru dari AWS CLI, Anda harus menghapus `yum` versi pra-instal menggunakan perintah berikut:
```
$ sudo yum remove awscli
```
Setelah `yum` instalasi dihapus, ikuti petunjuk instalasi Linux di bawah ini. AWS CLI
Anda dapat menginstal AWS CLI dengan menggunakan salah satu metode berikut:
+ **Penginstal baris perintah** adalah opsi yang baik untuk kontrol versi, karena Anda dapat menentukan versi yang akan diinstal. Opsi ini tidak diperbarui secara otomatis dan Anda harus mengunduh penginstal baru setiap kali Anda memperbarui untuk menimpa versi sebelumnya.
+ **`snap`Paket yang didukung secara resmi** adalah pilihan yang baik untuk selalu memiliki versi terbaru dari paket AWS CLI as snap secara otomatis menyegarkan. Tidak ada dukungan bawaan untuk memilih versi minor AWS CLI dan oleh karena itu bukan metode penginstalan yang optimal jika tim Anda perlu menyematkan versi.
------
#### [ Command line installer - Linux x86 (64-bit) ]
Untuk memperbarui instalasi Anda saat ini AWS CLI, unduh penginstal baru setiap kali Anda memperbarui untuk menimpa versi sebelumnya. Ikuti langkah-langkah ini dari baris perintah untuk menginstal AWS CLI di Linux.
Berikut ini adalah langkah-langkah instalasi cepat dalam satu grup salin dan tempel yang menyediakan instalasi dasar. Untuk petunjuk yang dipandu, lihat langkah-langkah berikut.
**catatan**
**(Opsional)** Perintah berikut memblokir unduhan dan menginstal AWS CLI tanpa terlebih dahulu memverifikasi integritas unduhan Anda. Untuk memverifikasi integritas unduhan Anda, gunakan petunjuk langkah demi langkah di bawah ini.
**Untuk menginstal** AWS CLI, jalankan perintah berikut.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
**Untuk memperbarui instalasi Anda saat ini** AWS CLI, tambahkan symlink yang ada dan informasi installer untuk membuat `install` perintah menggunakan`--bin-dir`,`--install-dir`, dan parameter. `--update` Blok perintah berikut menggunakan contoh symlink */usr/local/bin* dan contoh lokasi penginstal */usr/local/aws-cli* untuk menginstal AWS CLI secara lokal untuk pengguna saat ini.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
**Langkah-langkah instalasi terpandu**
1. Unduh file instalasi dengan salah satu cara berikut:
+ **Gunakan `curl` perintah** - `-o` Opsi menentukan nama file yang paket download ditulis. Opsi pada perintah contoh berikut menulis file yang diunduh ke direktori saat ini dengan nama lokal`awscliv2.zip`.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
```
+ **Mengunduh dari URL** — Untuk mengunduh penginstal dengan browser Anda, gunakan URL berikut: [https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip)
1. **(Opsional) Memverifikasi integritas file zip yang Anda unduh**
Jika Anda memilih untuk mengunduh paket AWS CLI penginstal secara manual pada langkah-langkah `.zip` di atas, Anda dapat menggunakan langkah-langkah berikut untuk memverifikasi tanda tangan dengan menggunakan alat ini. `GnuPG`
`.zip`File paket AWS CLI installer ditandatangani secara kriptografis menggunakan tanda tangan PGP. Jika ada kerusakan atau perubahan file, verifikasi ini gagal dan Anda tidak boleh melanjutkan dengan instalasi.
1. Unduh dan instal `gpg` perintah menggunakan manajer paket Anda. Untuk informasi selengkapnya`GnuPG`, lihat situs web [GnuPG](https://www.gnupg.org/).
1. Untuk membuat file kunci publik, buat file teks dan tempel dalam teks berikut.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
Sebagai referensi, berikut ini adalah rincian kunci publik.
```
Key ID: A6310ACC4672475C
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. Impor kunci AWS CLI publik dengan perintah berikut, ganti *public-key-file-name* dengan nama file kunci publik yang Anda buat.
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. Unduh file AWS CLI tanda tangan untuk paket yang Anda unduh. Ini memiliki jalur dan nama yang sama dengan `.zip` file yang sesuai dengannya, tetapi memiliki ekstensi`.sig`. Dalam contoh berikut, kami menyimpannya ke direktori saat ini sebagai file bernama`awscliv2.sig`.
**Untuk versi terbaru AWS CLI,** gunakan blok perintah berikut:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
1. Verifikasi tanda tangan, meneruskan nama yang diunduh `.sig` dan `.zip` file sebagai parameter ke `gpg` perintah.
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
Outputnya akan terlihat serupa dengan yang berikut ini:
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**penting**
Peringatan dalam output diharapkan dan tidak menunjukkan masalah. Itu terjadi karena tidak ada rantai kepercayaan antara kunci PGP pribadi Anda (jika Anda memilikinya) dan kunci AWS CLI PGP. Untuk informasi selengkapnya, lihat [Web kepercayaan](https://en.wikipedia.org/wiki/Web_of_trust).
1. Buka zip penginstal. Jika distribusi Linux Anda tidak memiliki `unzip` perintah bawaan, gunakan yang setara dengan unzip. Contoh perintah berikut membuka ritsleting paket dan membuat direktori bernama `aws` di bawah direktori saat ini.
```
$ unzip awscliv2.zip
```
**catatan**
Saat memperbarui dari versi sebelumnya, `unzip` perintah meminta untuk menimpa file yang ada. Untuk melewati petunjuk ini, seperti dengan otomatisasi skrip, gunakan bendera `-u` pembaruan untuk`unzip`. Bendera ini secara otomatis memperbarui file yang ada dan membuat yang baru sesuai kebutuhan.
```
$ unzip -u awscliv2.zip
```
1. Jalankan program instal. Perintah instalasi menggunakan file bernama `install` dalam direktori yang baru di-unzip`aws`. Secara default, semua file diinstal`/usr/local/aws-cli`, dan tautan simbolis dibuat di. `/usr/local/bin` Perintah termasuk `sudo` untuk memberikan izin menulis ke direktori tersebut.
```
$ sudo ./aws/install
```
Anda dapat menginstal tanpa `sudo` jika Anda menentukan direktori yang sudah Anda miliki izin menulis. Gunakan instruksi berikut untuk `install` perintah untuk menentukan lokasi instalasi:
+ Pastikan jalur yang Anda berikan ke `-b` parameter `-i` dan tidak berisi nama volume atau nama direktori yang berisi karakter spasi atau karakter spasi putih lainnya. Jika ada ruang, instalasi gagal.
+ `--install-dir`atau `-i` — Opsi ini menentukan direktori untuk menyalin semua file ke.
Nilai default-nya adalah `/usr/local/aws-cli`.
+ `--bin-dir`atau `-b` — Opsi ini menentukan bahwa `aws` program utama dalam direktori install secara simbolis terkait dengan file `aws` di jalur yang ditentukan. Anda harus memiliki izin menulis ke direktori yang ditentukan. Membuat symlink ke direktori yang sudah ada di jalur Anda menghilangkan kebutuhan untuk menambahkan direktori install ke `$PATH` variabel pengguna.
Nilai default-nya adalah `/usr/local/bin`.
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**catatan**
Untuk memperbarui instalasi Anda saat ini AWS CLI, tambahkan symlink yang ada dan informasi installer untuk membuat `install` perintah dengan parameter. `--update`
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
Untuk menemukan direktori symlink dan instalasi yang ada, gunakan langkah-langkah berikut:
Gunakan `which` perintah untuk menemukan symlink Anda. Ini memberi Anda jalur untuk digunakan dengan `--bin-dir` parameter.
```
$ which aws
/usr/local/bin/aws
```
Gunakan `ls` perintah untuk menemukan direktori yang ditunjuk symlink Anda. Ini memberi Anda jalur untuk digunakan dengan `--install-dir` parameter.
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. Konfirmasikan instalasi dengan perintah berikut.
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
#### [ Command line - Linux ARM ]
Untuk memperbarui instalasi Anda saat ini AWS CLI, unduh penginstal baru setiap kali Anda memperbarui untuk menimpa versi sebelumnya. Ikuti langkah-langkah ini dari baris perintah untuk menginstal AWS CLI di Linux.
Berikut ini adalah langkah-langkah instalasi cepat dalam satu grup salin dan tempel yang menyediakan instalasi dasar. Untuk petunjuk yang dipandu, lihat langkah-langkah berikut.
**catatan**
**(Opsional)** Perintah berikut memblokir unduhan dan menginstal AWS CLI tanpa terlebih dahulu memverifikasi integritas unduhan Anda. Untuk memverifikasi integritas unduhan Anda, gunakan petunjuk langkah demi langkah di bawah ini.
**Untuk menginstal** AWS CLI, jalankan perintah berikut.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
**Untuk memperbarui instalasi Anda saat ini** AWS CLI, tambahkan symlink yang ada dan informasi installer untuk membuat `install` perintah menggunakan`--bin-dir`,`--install-dir`, dan parameter. `--update` Blok perintah berikut menggunakan contoh symlink */usr/local/bin* dan contoh lokasi installer dari. */usr/local/aws-cli*
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
**Langkah-langkah instalasi terpandu**
1. Unduh file instalasi dengan salah satu cara berikut:
+ **Gunakan `curl` perintah** - `-o` Opsi menentukan nama file yang paket download ditulis. Opsi pada perintah contoh berikut menulis file yang diunduh ke direktori saat ini dengan nama lokal`awscliv2.zip`.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
```
+ **Mengunduh dari URL** — Untuk mengunduh penginstal dengan browser Anda, gunakan URL berikut: [https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip)
1. **(Opsional) Memverifikasi integritas file zip yang Anda unduh**
Jika Anda memilih untuk mengunduh paket AWS CLI penginstal secara manual pada langkah-langkah `.zip` di atas, Anda dapat menggunakan langkah-langkah berikut untuk memverifikasi tanda tangan dengan menggunakan alat ini. `GnuPG`
`.zip`File paket AWS CLI installer ditandatangani secara kriptografis menggunakan tanda tangan PGP. Jika ada kerusakan atau perubahan file, verifikasi ini gagal dan Anda tidak boleh melanjutkan dengan instalasi.
1. Unduh dan instal `gpg` perintah menggunakan manajer paket Anda. Untuk informasi selengkapnya`GnuPG`, lihat situs web [GnuPG](https://www.gnupg.org/).
1. Untuk membuat file kunci publik, buat file teks dan tempel dalam teks berikut.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
Sebagai referensi, berikut ini adalah rincian kunci publik.
```
Key ID: A6310ACC4672475C
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. Impor kunci AWS CLI publik dengan perintah berikut, ganti *public-key-file-name* dengan nama file kunci publik yang Anda buat.
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. Unduh file AWS CLI tanda tangan untuk paket yang Anda unduh. Ini memiliki jalur dan nama yang sama dengan `.zip` file yang sesuai dengannya, tetapi memiliki ekstensi`.sig`. Dalam contoh berikut, kami menyimpannya ke direktori saat ini sebagai file bernama`awscliv2.sig`.
**Untuk versi terbaru AWS CLI,** gunakan blok perintah berikut:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
1. Verifikasi tanda tangan, meneruskan nama yang diunduh `.sig` dan `.zip` file sebagai parameter ke `gpg` perintah.
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
Outputnya akan terlihat serupa dengan yang berikut ini:
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**penting**
Peringatan dalam output diharapkan dan tidak menunjukkan masalah. Itu terjadi karena tidak ada rantai kepercayaan antara kunci PGP pribadi Anda (jika Anda memilikinya) dan kunci AWS CLI PGP. Untuk informasi selengkapnya, lihat [Web kepercayaan](https://en.wikipedia.org/wiki/Web_of_trust).
1. Buka zip penginstal. Jika distribusi Linux Anda tidak memiliki `unzip` perintah bawaan, gunakan yang setara dengan unzip. Contoh perintah berikut membuka ritsleting paket dan membuat direktori bernama `aws` di bawah direktori saat ini.
```
$ unzip awscliv2.zip
```
**catatan**
Saat memperbarui dari versi sebelumnya, `unzip` perintah meminta untuk menimpa file yang ada. Untuk melewati petunjuk ini, seperti dengan otomatisasi skrip, gunakan bendera `-u` pembaruan untuk`unzip`. Bendera ini secara otomatis memperbarui file yang ada dan membuat yang baru sesuai kebutuhan.
```
$ unzip -u awscliv2.zip
```
1. Jalankan program instal. Perintah instalasi menggunakan file bernama `install` dalam direktori yang baru di-unzip`aws`. Secara default, semua file diinstal`/usr/local/aws-cli`, dan tautan simbolis dibuat di. `/usr/local/bin` Perintah termasuk `sudo` untuk memberikan izin menulis ke direktori tersebut.
```
$ sudo ./aws/install
```
Anda dapat menginstal tanpa `sudo` jika Anda menentukan direktori yang sudah Anda miliki izin menulis. Gunakan instruksi berikut untuk `install` perintah untuk menentukan lokasi instalasi:
+ Pastikan jalur yang Anda berikan ke `-b` parameter `-i` dan tidak berisi nama volume atau nama direktori yang berisi karakter spasi atau karakter spasi putih lainnya. Jika ada ruang, instalasi gagal.
+ `--install-dir`atau `-i` — Opsi ini menentukan direktori untuk menyalin semua file ke.
Nilai default-nya adalah `/usr/local/aws-cli`.
+ `--bin-dir`atau `-b` — Opsi ini menentukan bahwa `aws` program utama dalam direktori install secara simbolis terkait dengan file `aws` di jalur yang ditentukan. Anda harus memiliki izin menulis ke direktori yang ditentukan. Membuat symlink ke direktori yang sudah ada di jalur Anda menghilangkan kebutuhan untuk menambahkan direktori install ke `$PATH` variabel pengguna.
Nilai default-nya adalah `/usr/local/bin`.
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**catatan**
Untuk memperbarui instalasi Anda saat ini AWS CLI, tambahkan symlink yang ada dan informasi installer untuk membuat `install` perintah dengan parameter. `--update`
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
Untuk menemukan direktori symlink dan instalasi yang ada, gunakan langkah-langkah berikut:
Gunakan `which` perintah untuk menemukan symlink Anda. Ini memberi Anda jalur untuk digunakan dengan `--bin-dir` parameter.
```
$ which aws
/usr/local/bin/aws
```
Gunakan `ls` perintah untuk menemukan direktori yang ditunjuk symlink Anda. Ini memberi Anda jalur untuk digunakan dengan `--install-dir` parameter.
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. Konfirmasikan instalasi dengan perintah berikut.
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
#### [ Snap package ]
Kami menyediakan versi resmi yang AWS didukung dari AWS CLI on`snap`. Jika Anda ingin selalu AWS CLI menginstal versi terbaru dari sistem Anda, paket snap menyediakan ini untuk Anda karena pembaruan otomatis. Tidak ada dukungan bawaan untuk memilih versi minor AWS CLI dan oleh karena itu ini bukan metode instalasi yang optimal jika tim Anda perlu menyematkan versi. Jika Anda ingin menginstal versi minor tertentu AWS CLI, kami sarankan Anda menggunakan penginstal baris perintah.
1. Jika platform Linux Anda belum `snap` diinstal, instal `snap` di platform Anda.
1. Untuk informasi tentang penginstalan`snap`, lihat [Menginstal daemon di dokumentasi](https://snapcraft.io/docs/installing-snapd) *Snap*.
1. Anda mungkin perlu me-restart sistem Anda sehingga `PATH` variabel Anda diperbarui dengan benar. Jika Anda mengalami masalah instalasi, ikuti langkah-langkah di [Perbaiki masalah umum](https://snapcraft.io/docs/fix-common-issues) dalam *dokumentasi Snap*.
1. Untuk memverifikasi `snap` bahwa diinstal dengan benar, jalankan perintah berikut.
```
$ snap version
```
1. Jalankan `snap install` perintah berikut untuk file AWS CLI.
```
$ snap install aws-cli --classic
```
Bergantung pada izin Anda, Anda mungkin `sudo` perlu menambahkan perintah.
```
$ sudo snap install aws-cli --classic
```
**catatan**
Untuk melihat repositori snap untuk AWS CLI, termasuk `snap` instruksi tambahan, lihat [https://snapcraft.io/aws-cli](https://snapcraft.io/aws-cli)halaman di situs web *Canonical* Snapcraft.
1. Verifikasi bahwa AWS CLI diinstal dengan benar.
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
Jika Anda mendapatkan kesalahan, lihat[Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md).
------
### macOS
#### Instal dan perbarui persyaratan
+ Kami mendukung versi AWS CLI macOS 11 dan yang lebih baru. Untuk informasi selengkapnya, lihat [pembaruan kebijakan dukungan macOS untuk AWS CLI v2 di Blog](https://aws.amazon.com/blogs/developer/macos-support-policy-updates-for-the-aws-cli-v2/) *Alat AWS Pengembang*.
+ Karena AWS tidak memelihara repositori pihak ketiga, kami tidak dapat menjamin bahwa repositori tersebut berisi versi terbaru dari. AWS CLI
**Matriks dukungan versi macOS**
| AWS CLI versi | Versi macOS yang didukung |
| --- | --- |
| 2.21.0 - saat ini | 11\$1 |
| 2.17.0 —2.20.0 | 10.15\$1 |
| 2.0.0 — 2.16.12 | 10.14 dan di bawah |
#### Instal atau perbarui AWS CLI
Jika Anda memperbarui ke versi terbaru, gunakan metode instalasi yang sama dengan yang Anda gunakan dalam versi Anda saat ini. Anda dapat menginstal AWS CLI di macOS dengan cara berikut.
------
#### [ GUI installer ]
Langkah-langkah berikut menunjukkan cara menginstal versi terbaru AWS CLI dengan menggunakan antarmuka pengguna macOS standar dan browser Anda.
1. Di browser Anda, unduh file macOS`pkg`: [https://awscli.amazonaws.com/AWSCLIV2.pkg](https://awscli.amazonaws.com/AWSCLIV2.pkg)
1. Jalankan file yang Anda unduh dan ikuti petunjuk di layar. Anda dapat memilih untuk menginstal dengan cara berikut: AWS CLI
+ **Untuk semua pengguna di komputer (membutuhkan`sudo`)**
+ Anda dapat menginstal ke folder apa pun, atau memilih folder default yang direkomendasikan`/usr/local/aws-cli`.
+ Pemasang secara otomatis membuat symlink di tautan `/usr/local/bin/aws` tersebut ke program utama di folder instalasi yang Anda pilih.
+ **Hanya untuk pengguna saat ini (tidak memerlukan`sudo`)**
+ Anda dapat menginstal ke folder mana pun yang Anda memiliki izin menulis.
+ Karena izin pengguna standar, setelah penginstal selesai, Anda harus secara manual membuat file symlink di Anda `$PATH` yang menunjuk ke `aws` dan `aws_completer` program dengan menggunakan perintah berikut pada prompt perintah. Lokasi default untuk symlink adalah`/usr/local/bin/`:
```
$ ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
Jika Anda tidak memiliki izin menulis ke folder, Anda mungkin perlu menggunakannya `sudo` dalam perintah Anda. Contoh berikut menggunakan `sudo` dengan lokasi default untuk symlink di`/usr/local/bin/`:
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
**catatan**
Anda dapat melihat log debug untuk instalasi dengan menekan **Cmd\$1L** di mana saja di installer. Ini membuka panel log yang memungkinkan Anda memfilter dan menyimpan log. File log juga disimpan secara otomatis`/var/log/install.log`.
1. Untuk memverifikasi bahwa shell dapat menemukan dan menjalankan `aws` perintah di Anda`$PATH`, gunakan perintah berikut.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
#### [ Command line installer - All users ]
Jika Anda memiliki `sudo` izin, Anda dapat menginstal AWS CLI untuk semua pengguna di komputer. Kami menyediakan langkah-langkah dalam satu grup yang mudah disalin dan ditempel. Lihat deskripsi setiap baris dalam langkah-langkah berikut.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
**Petunjuk instalasi terpandu**
1. Unduh file menggunakan `curl` perintah. `-o`Opsi ini menentukan nama file yang paket yang diunduh ditulis. Dalam contoh ini, file ditulis ke `AWSCLIV2.pkg` dalam folder saat ini.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
1. Jalankan `installer` program macOS standar, tentukan `.pkg` file yang diunduh sebagai sumbernya. Gunakan `-pkg` parameter untuk menentukan nama paket yang akan diinstal, dan `-target /` parameter untuk drive mana untuk menginstal paket. File diinstal ke`/usr/local/aws-cli`, dan symlink secara otomatis dibuat di`/usr/local/bin`. Anda harus menyertakan `sudo` perintah untuk memberikan izin menulis ke folder tersebut.
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
Setelah instalasi selesai, log debug ditulis ke`/var/log/install.log`.
1. Untuk memverifikasi bahwa shell dapat menemukan dan menjalankan `aws` perintah di Anda`$PATH`, gunakan perintah berikut.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
#### [ Command line - Current user ]
1. Untuk menentukan folder mana AWS CLI yang diinstal, Anda harus membuat file XMLdengan nama file apa pun. File ini adalah file berformat XML yang terlihat seperti contoh berikut. Biarkan semua nilai seperti yang ditunjukkan, kecuali Anda harus mengganti jalur */Users/myusername* di baris 9 dengan jalur ke folder yang ingin Anda AWS CLI instal. *Folder harus sudah ada, atau perintah gagal.* Contoh XHTML berikut, bernama*choices.xml*, menentukan installer untuk menginstal dalam folder`/Users/myusername`, AWS CLI di mana ia membuat folder bernama. `aws-cli`
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. Unduh `pkg` penginstal menggunakan `curl` perintah. `-o`Opsi ini menentukan nama file yang paket yang diunduh ditulis. Dalam contoh ini, file ditulis ke `AWSCLIV2.pkg` dalam folder saat ini.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
1. Jalankan `installer` program macOS standar dengan opsi berikut:
+ Tentukan nama paket yang akan diinstal dengan menggunakan `-pkg` parameter.
+ Tentukan penginstalan ke *pengguna saat ini hanya* dengan mengatur `-target` parameter ke`CurrentUserHomeDirectory`.
+ Tentukan jalur (relatif terhadap folder saat ini) dan nama file XHTML yang Anda buat di `-applyChoiceChangesXML` parameter.
Contoh berikut menginstal AWS CLI dalam folder`/Users/myusername/aws-cli`.
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. Karena izin pengguna standar biasanya tidak mengizinkan penulisan ke folder di folder Anda`$PATH`, penginstal dalam mode ini tidak mencoba menambahkan symlink ke dan program. `aws` `aws_completer` Agar dapat berjalan dengan benar, Anda harus membuat symlink secara manual setelah penginstal selesai. AWS CLI Jika Anda `$PATH` menyertakan folder yang dapat Anda tulis dan Anda menentukan folder sebagai jalur target, Anda dapat menjalankan perintah berikut tanpa`sudo`. Jika Anda tidak memiliki folder yang dapat ditulis di Anda`$PATH`, Anda harus menggunakan izin `sudo` untuk menulis ke folder target yang ditentukan. Lokasi default untuk symlink adalah`/usr/local/bin/`. Ganti `folder/installed` dengan jalur ke AWS CLI instalasi Anda.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
Setelah instalasi selesai, log debug ditulis ke`/var/log/install.log`.
1. Untuk memverifikasi bahwa shell dapat menemukan dan menjalankan `aws` perintah di Anda`$PATH`, gunakan perintah berikut.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
### Windows
#### Instal dan perbarui persyaratan
+ Kami mendukung versi AWS CLI Windows 64-bit yang didukung Microsoft.
+ Hak admin untuk menginstal perangkat lunak
#### Instal atau perbarui AWS CLI
Untuk memperbarui instalasi Anda saat ini AWS CLI di Windows, unduh penginstal baru setiap kali Anda memperbarui untuk menimpa versi sebelumnya. AWS CLI diperbarui secara berkala. Untuk melihat kapan versi terbaru dirilis, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) aktif. *GitHub*
1. Unduh dan jalankan penginstal AWS CLI MSI untuk Windows (64-bit):
[https://awscli.amazonaws.com/AWSCLIV2.msi](https://awscli.amazonaws.com/AWSCLIV2.msi)
Atau, Anda dapat menjalankan `msiexec` perintah untuk menjalankan installer MSI.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
```
Untuk berbagai parameter yang dapat digunakan`msiexec`, lihat [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) di situs web *Microsoft* Docs. Misalnya, Anda dapat menggunakan `/qn` bendera untuk instalasi diam.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn
```
1. Untuk mengkonfirmasi instalasi, buka menu **Start**, cari `cmd` untuk membuka jendela command prompt, dan pada command prompt gunakan `aws --version` perintah.
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Jika Windows tidak dapat menemukan program, Anda mungkin perlu menutup dan membuka kembali jendela prompt perintah untuk menyegarkan jalur, atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
## Memecahkan masalah kesalahan AWS CLI pemasangan dan uninstall
Jika Anda menemukan masalah setelah menginstal atau menghapus instalasi AWS CLI, lihat [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md) untuk langkah-langkah pemecahan masalah. Untuk langkah pemecahan masalah yang paling relevan, lihat, [Perintah tidak ditemukan kesalahan](cli-chap-troubleshooting.md#tshoot-install-not-found)[Perintah `aws --version` "" mengembalikan versi yang berbeda dari yang Anda instal](cli-chap-troubleshooting.md#tshoot-install-wrong-version), dan. [Perintah `aws --version` "" mengembalikan versi setelah mencopot pemasangan AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)
## Langkah selanjutnya
Setelah Anda berhasil menginstal AWS CLI, Anda dapat menghapus file installer yang diunduh dengan aman. Setelah menyelesaikan langkah-langkah [Prasyarat untuk menggunakan versi 2 AWS CLI](getting-started-prereqs.md) dan menginstal AWS CLI, Anda harus melakukan[Menyiapkan AWS CLI](getting-started-quickstart.md).
# Menginstal rilis sebelumnya dari AWS CLI versi 2
Topik ini menjelaskan cara menginstal rilis sebelumnya dari AWS Command Line Interface versi 2 (AWS CLI) pada sistem operasi yang didukung. Untuk informasi tentang rilis AWS CLI versi 2, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) aktif. GitHub
AWS CLI instruksi instalasi versi 2:
## Linux
### Persyaratan instalasi
+ Anda tahu rilis AWS CLI versi 2 mana yang ingin Anda instal. Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
+ Anda harus dapat mengekstrak atau “unzip” paket yang diunduh. Gunakan ekuivalen jika sistem pengoperasian Anda tidak memiliki perintah `unzip`.
+ AWS CLI Versi 2 menggunakan`glibc`,`groff`, dan`less`. Ini disertakan secara default di sebagian besar distribusi utama Linux.
+ Kami mendukung AWS CLI versi 2 pada versi 64-bit dari distribusi terbaru CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2 dan Linux ARM.
+ Karena AWS tidak memelihara repositori pihak ketiga, kami tidak dapat menjamin bahwa repositori tersebut berisi versi terbaru. AWS CLI
### Petunjuk pemasangan
Ikuti langkah-langkah ini dari baris perintah untuk menginstal AWS CLI di Linux.
Kami menyediakan langkah-langkah dalam satu grup yang mudah disalin dan ditempel berdasarkan apakah Anda menggunakan Linux 64-bit atau Linux ARM. Lihat deskripsi setiap baris dalam langkah-langkah berikut.
------
#### [ Linux x86 (64-bit) ]
**catatan**
**(Opsional)** Perintah berikut memblokir unduhan dan menginstal AWS CLI tanpa terlebih dahulu memverifikasi integritas unduhan Anda. Untuk memverifikasi integritas unduhan Anda, gunakan petunjuk langkah demi langkah di bawah ini.
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
**Untuk menginstal** AWS CLI, jalankan perintah berikut.
Untuk menentukan versi, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-x86_64-2.0.30.zip` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
**Untuk memperbarui instalasi Anda saat ini** AWS CLI, tambahkan symlink yang ada dan informasi installer untuk membuat `install` perintah menggunakan`--bin-dir`,`--install-dir`, dan parameter. `--update` Blok perintah berikut menggunakan contoh symlink */usr/local/bin* dan contoh lokasi installer dari. */usr/local/aws-cli*
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
#### [ Linux ARM ]
**catatan**
**(Opsional)** Perintah berikut memblokir unduhan dan menginstal AWS CLI tanpa terlebih dahulu memverifikasi integritas unduhan Anda. Untuk memverifikasi integritas unduhan Anda, gunakan petunjuk langkah demi langkah di bawah ini.
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
**Untuk menginstal** AWS CLI, jalankan perintah berikut.
Untuk menentukan versi, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-aarch64-2.0.30.zip` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
**Untuk memperbarui instalasi Anda saat ini** AWS CLI, tambahkan symlink yang ada dan informasi installer untuk membuat `install` perintah menggunakan`--bin-dir`,`--install-dir`, dan parameter. `--update` Blok perintah berikut menggunakan contoh symlink */usr/local/bin* dan contoh lokasi installer dari. */usr/local/aws-cli*
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
1. Unduh file instalasi dengan salah satu cara berikut:
------
#### [ Linux x86 (64-bit) ]
+ **Gunakan `curl` perintah** - `-o` Opsi menentukan nama file yang paket download ditulis. Opsi pada perintah contoh berikut menulis file yang diunduh ke direktori saat ini dengan nama lokal`awscliv2.zip`.
Untuk menentukan versi, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-x86_64-2.0.30.zip` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
```
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
+ **Download dari URL** —
Di browser Anda, unduh versi spesifik Anda AWS CLI dengan menambahkan tanda hubung dan nomor versi ke nama file.
```
https://awscli.amazonaws.com/awscli-exe-linux-x86_64-version.number.zip
```
Untuk contoh ini nama file untuk versi *2.0.30* adalah awscli-exe-linux-x 86\$164-2.0.30.zip menghasilkan tautan berikut: [https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip)
------
#### [ Linux ARM ]
+ **Gunakan `curl` perintah** - `-o` Opsi menentukan nama file yang paket download ditulis. Opsi pada perintah contoh berikut menulis file yang diunduh ke direktori saat ini dengan nama lokal`awscliv2.zip`.
Untuk menentukan versi, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-aarch64-2.0.30.zip` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
+ **Download dari URL** —
Di browser Anda, unduh versi spesifik Anda AWS CLI dengan menambahkan tanda hubung dan nomor versi ke nama file.
```
https://awscli.amazonaws.com/awscli-exe-linux-aarch64-version.number.zip
```
Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-aarch64-2.0.30.zip` menghasilkan tautan berikut: [https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip)
------
1. **(Opsional) Memverifikasi integritas file zip yang Anda unduh**
Jika Anda memilih untuk mengunduh paket AWS CLI penginstal secara manual pada langkah-langkah `.zip` di atas, Anda dapat menggunakan langkah-langkah berikut untuk memverifikasi tanda tangan dengan menggunakan alat ini. `GnuPG`
`.zip`File paket AWS CLI installer ditandatangani secara kriptografis menggunakan tanda tangan PGP. Jika ada kerusakan atau perubahan file, verifikasi ini gagal dan Anda tidak boleh melanjutkan dengan instalasi.
1. Unduh dan instal `gpg` perintah menggunakan manajer paket Anda. Untuk informasi selengkapnya`GnuPG`, lihat situs web [GnuPG](https://www.gnupg.org/).
1. Untuk membuat file kunci publik, buat file teks dan tempel dalam teks berikut.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
Sebagai referensi, berikut ini adalah rincian kunci publik.
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. Impor kunci AWS CLI publik dengan perintah berikut, ganti *public-key-file-name* dengan nama file kunci publik yang Anda buat.
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. Unduh file AWS CLI tanda tangan untuk paket yang Anda unduh. Ini memiliki jalur dan nama yang sama dengan `.zip` file yang sesuai dengannya, tetapi memiliki ekstensi`.sig`. Dalam contoh berikut, kami menyimpannya ke direktori saat ini sebagai file bernama`awscliv2.sig`.
------
#### [ Linux x86 (64-bit) ]
**Untuk versi terbaru AWS CLI,** gunakan blok perintah berikut:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
**Untuk versi tertentu dari AWS CLI,** tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-x86_64-2.0.30.zip.sig` menghasilkan perintah berikut:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
------
#### [ Linux ARM ]
**Untuk versi terbaru AWS CLI,** gunakan blok perintah berikut:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
**Untuk versi tertentu dari AWS CLI,** tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `awscli-exe-linux-aarch64-2.0.30.zip.sig` menghasilkan perintah berikut:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) di. *GitHub*
------
1. Verifikasi tanda tangan, meneruskan nama yang diunduh `.sig` dan `.zip` file sebagai parameter ke `gpg` perintah.
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
Outputnya akan terlihat serupa dengan yang berikut ini:
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**penting**
Peringatan dalam output diharapkan dan tidak menunjukkan masalah. Itu terjadi karena tidak ada rantai kepercayaan antara kunci PGP pribadi Anda (jika Anda memilikinya) dan kunci AWS CLI PGP. Untuk informasi selengkapnya, lihat [Web kepercayaan](https://en.wikipedia.org/wiki/Web_of_trust).
1. Buka zip penginstal. Jika distribusi Linux Anda tidak memiliki `unzip` perintah bawaan, gunakan yang setara dengan unzip. Contoh perintah berikut membuka ritsleting paket dan membuat direktori bernama `aws` di bawah direktori saat ini.
```
$ unzip awscliv2.zip
```
1. Jalankan program instal. Perintah instalasi menggunakan file bernama `install` dalam direktori yang baru di-unzip`aws`. Secara default, semua file diinstal`/usr/local/aws-cli`, dan tautan simbolis dibuat di. `/usr/local/bin` Perintah termasuk `sudo` untuk memberikan izin menulis ke direktori tersebut.
```
$ sudo ./aws/install
```
Anda dapat menginstal tanpa `sudo` jika Anda menentukan direktori yang sudah Anda miliki izin menulis. Gunakan instruksi berikut untuk `install` perintah untuk menentukan lokasi instalasi:
+ Pastikan jalur yang Anda berikan ke `-b` parameter `-i` dan tidak berisi nama volume atau nama direktori yang berisi karakter spasi atau karakter spasi putih lainnya. Jika ada ruang, instalasi gagal.
+ `--install-dir`atau `-i` — Opsi ini menentukan direktori untuk menyalin semua file ke.
Nilai default-nya adalah `/usr/local/aws-cli`.
+ `--bin-dir`atau `-b` — Opsi ini menentukan bahwa `aws` program utama dalam direktori install secara simbolis terkait dengan file `aws` di jalur yang ditentukan. Anda harus memiliki izin menulis ke direktori yang ditentukan. Membuat symlink ke direktori yang sudah ada di jalur Anda menghilangkan kebutuhan untuk menambahkan direktori install ke `$PATH` variabel pengguna.
Nilai default-nya adalah `/usr/local/bin`.
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**catatan**
Untuk memperbarui instalasi AWS CLI versi 2 Anda saat ini ke versi yang lebih baru, tambahkan symlink dan informasi penginstal yang ada untuk membuat `install` perintah dengan parameter. `--update`
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
Untuk menemukan direktori symlink dan instalasi yang ada, gunakan langkah-langkah berikut:
Gunakan `which` perintah untuk menemukan symlink Anda. Ini memberi Anda jalur untuk digunakan dengan `--bin-dir` parameter.
```
$ which aws
/usr/local/bin/aws
```
Gunakan `ls` perintah untuk menemukan direktori yang ditunjuk symlink Anda. Ini memberi Anda jalur untuk digunakan dengan `--install-dir` parameter.
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. Konfirmasikan instalasi dengan perintah berikut.
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
## macOS
### Persyaratan instalasi
+ Anda tahu rilis AWS CLI versi 2 mana yang ingin Anda instal. Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) di. *GitHub*
+ Kami mendukung AWS CLI versi 2 pada versi macOS 64-bit yang didukung Apple.
+ Karena AWS tidak memelihara repositori pihak ketiga, kami tidak dapat menjamin bahwa repositori tersebut berisi versi terbaru. AWS CLI
### Petunjuk pemasangan
Anda dapat menginstal AWS CLI versi 2 di macOS dengan cara berikut.
------
#### [ GUI installer ]
Langkah-langkah berikut menunjukkan cara menginstal atau memperbarui ke versi terbaru AWS CLI versi 2 dengan menggunakan antarmuka pengguna macOS standar dan browser Anda. Jika Anda memperbarui ke versi terbaru, gunakan metode instalasi yang sama dengan yang Anda gunakan untuk versi Anda saat ini.
1. Di browser Anda, unduh versi spesifik Anda AWS CLI dengan menambahkan tanda hubung dan nomor versi ke nama file.
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.pkg
```
Untuk contoh ini, nama file untuk versi *2.0.30* akan `AWSCLIV2-2.0.30.pkg` menghasilkan tautan berikut:. [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg)
1. Jalankan file yang Anda unduh dan ikuti petunjuk di layar. Anda dapat memilih untuk menginstal AWS CLI versi 2 dengan cara berikut:
+ **Untuk semua pengguna di komputer (membutuhkan`sudo`)**
+ Anda dapat menginstal ke folder apa pun, atau memilih folder default yang direkomendasikan`/usr/local/aws-cli`.
+ Pemasang secara otomatis membuat symlink di tautan `/usr/local/bin/aws` tersebut ke program utama di folder instalasi yang Anda pilih.
+ **Hanya untuk pengguna saat ini (tidak memerlukan`sudo`)**
+ Anda dapat menginstal ke folder mana pun yang Anda memiliki izin menulis.
+ Karena izin pengguna standar, setelah penginstal selesai, Anda harus secara manual membuat file symlink di Anda `$PATH` yang menunjuk ke `aws` dan `aws_completer` program dengan menggunakan perintah berikut pada prompt perintah. Jika Anda `$PATH` menyertakan folder yang dapat Anda tulis, Anda dapat menjalankan perintah berikut tanpa `sudo` jika Anda menentukan folder itu sebagai jalur target. Jika Anda tidak memiliki folder yang dapat ditulis di dalam Anda`$PATH`, Anda harus menggunakan `sudo` perintah untuk mendapatkan izin untuk menulis ke folder target yang ditentukan. Lokasi default untuk symlink adalah`/usr/local/bin/`.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
**catatan**
Anda dapat melihat log debug untuk instalasi dengan menekan **Cmd\$1L** di mana saja di installer. Ini membuka panel log yang memungkinkan Anda memfilter dan menyimpan log. File log juga disimpan secara otomatis ke`/var/log/install.log`.
1. Untuk memverifikasi bahwa shell dapat menemukan dan menjalankan `aws` perintah di Anda`$PATH`, gunakan perintah berikut.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
#### [ Command line installer - All users ]
Jika Anda memiliki `sudo` izin, Anda dapat menginstal AWS CLI versi 2 untuk semua pengguna di komputer. Kami menyediakan langkah-langkah dalam satu grup yang mudah disalin dan ditempel. Lihat deskripsi setiap baris dalam langkah-langkah berikut.
Untuk versi tertentu dari AWS CLI, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `AWSCLIV2-2.0.30.pkg` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
1. Unduh file menggunakan `curl` perintah. `-o`Opsi menentukan nama file yang paket download ditulis. Dalam contoh ini, file ditulis ke `AWSCLIV2.pkg` dalam folder saat ini.
Untuk versi tertentu dari AWS CLI, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `AWSCLIV2-2.0.30.pkg` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
1. Jalankan `installer` program macOS standar, tentukan `.pkg` file yang diunduh sebagai sumbernya. Gunakan `-pkg` parameter untuk menentukan nama paket yang akan diinstal, dan `-target /` parameter untuk drive mana untuk menginstal paket. File diinstal ke`/usr/local/aws-cli`, dan symlink secara otomatis dibuat di`/usr/local/bin`. Anda harus menyertakan `sudo` perintah untuk memberikan izin menulis ke folder tersebut.
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
Setelah instalasi selesai, log debug ditulis ke`/var/log/install.log`.
1. Untuk memverifikasi bahwa shell dapat menemukan dan menjalankan `aws` perintah di Anda`$PATH`, gunakan perintah berikut.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
#### [ Command line - Current user ]
1. Untuk menentukan folder mana AWS CLI yang diinstal, Anda harus membuat file XHTML. File ini adalah file berformat XML yang terlihat seperti contoh berikut. Biarkan semua nilai seperti yang ditunjukkan, kecuali Anda harus mengganti jalur */Users/myusername* di baris 9 dengan jalur ke folder yang Anda inginkan AWS CLI versi 2 diinstal. *Folder harus sudah ada, atau perintah gagal.* Contoh XHTML ini menentukan bahwa installer menginstal dalam folder`/Users/myusername`, AWS CLI di mana ia membuat folder bernama. `aws-cli`
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. Unduh `pkg` penginstal menggunakan `curl` perintah. `-o`Opsi menentukan nama file yang paket download ditulis. Dalam contoh ini, file ditulis ke `AWSCLIV2.pkg` dalam folder saat ini.
Untuk versi spesifik AWS CLI, tambahkan tanda hubung dan nomor versi ke nama file. Untuk contoh ini nama file untuk versi *2.0.30* akan `AWSCLIV2-2.0.30.pkg` menghasilkan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
1. Jalankan `installer` program macOS standar dengan opsi berikut:
+ Tentukan nama paket yang akan diinstal dengan menggunakan `-pkg` parameter.
+ Tentukan pemasangan ke *pengguna saat ini hanya* dengan mengatur `-target` parameter ke`CurrentUserHomeDirectory`.
+ Tentukan jalur (relatif terhadap folder saat ini) dan nama file XHTML yang Anda buat di `-applyChoiceChangesXML` parameter.
Contoh berikut menginstal AWS CLI dalam folder`/Users/myusername/aws-cli`.
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. Karena izin pengguna standar biasanya tidak mengizinkan penulisan ke folder di folder Anda`$PATH`, penginstal dalam mode ini tidak mencoba menambahkan symlink ke dan program. `aws` `aws_completer` Agar dapat berjalan dengan benar, Anda harus membuat symlink secara manual setelah penginstal selesai. AWS CLI Jika Anda `$PATH` menyertakan folder yang dapat Anda tulis dan Anda menentukan folder sebagai jalur target, Anda dapat menjalankan perintah berikut tanpa`sudo`. Jika Anda tidak memiliki folder yang dapat ditulis di Anda`$PATH`, Anda harus menggunakan izin `sudo` untuk menulis ke folder target yang ditentukan. Lokasi default untuk symlink adalah`/usr/local/bin/`.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
Setelah instalasi selesai, log debug ditulis ke`/var/log/install.log`.
1. Untuk memverifikasi bahwa shell dapat menemukan dan menjalankan `aws` perintah di Anda`$PATH`, gunakan perintah berikut.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Jika `aws` perintah tidak dapat ditemukan, Anda mungkin perlu me-restart terminal Anda atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
------
## Windows
### Persyaratan instalasi
+ Anda tahu rilis AWS CLI versi 2 mana yang ingin Anda instal. Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
+ Kami mendukung versi AWS CLI Windows 64-bit yang didukung Microsoft.
+ Hak admin untuk menginstal perangkat lunak
### Petunjuk pemasangan
Untuk memperbarui instalasi AWS CLI versi 2 Anda saat ini di Windows, unduh penginstal baru setiap kali Anda memperbarui untuk menimpa versi sebelumnya. AWS CLI diperbarui secara berkala. Untuk melihat kapan versi terbaru dirilis, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) aktif. *GitHub*
1. Unduh dan jalankan penginstal AWS CLI MSI untuk Windows (64-bit) dengan salah satu cara berikut:
+ **Mengunduh dan menjalankan penginstal MSI:** Untuk membuat tautan unduhan Anda untuk versi tertentu AWS CLI, tambahkan tanda hubung dan nomor versi ke nama file.
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
Untuk contoh ini nama file untuk versi *2.0.30* akan `AWSCLIV2-2.0.30.msi` menghasilkan tautan berikut:. [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi)
+ **Menggunakan perintah msiexec:** Atau, Anda dapat menggunakan penginstal MSI dengan menambahkan tautan ke perintah. `msiexec` Untuk versi tertentu dari AWS CLI, tambahkan tanda hubung dan nomor versi ke nama file.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
Untuk contoh ini nama file untuk versi *2.0.30* akan `AWSCLIV2-2.0.30.msi` menghasilkan tautan berikut. [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi)
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi
```
Untuk berbagai parameter yang dapat digunakan`msiexec`, lihat [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) di situs web *Microsoft* Docs.
Untuk daftar versi, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. *GitHub*
1. Untuk mengkonfirmasi instalasi, buka menu **Start**, cari `cmd` untuk membuka jendela command prompt, dan pada command prompt gunakan `aws --version` perintah.
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Jika Windows tidak dapat menemukan program, Anda mungkin perlu menutup dan membuka kembali jendela prompt perintah untuk menyegarkan jalur, atau mengikuti pemecahan masalah di. [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md)
## Memecahkan masalah kesalahan AWS CLI pemasangan dan uninstall
Jika Anda menemukan masalah setelah menginstal atau menghapus instalasi AWS CLI, lihat [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md) untuk langkah-langkah pemecahan masalah. Untuk langkah pemecahan masalah yang paling relevan, lihat, [Perintah tidak ditemukan kesalahan](cli-chap-troubleshooting.md#tshoot-install-not-found)[Perintah `aws --version` "" mengembalikan versi yang berbeda dari yang Anda instal](cli-chap-troubleshooting.md#tshoot-install-wrong-version), dan. [Perintah `aws --version` "" mengembalikan versi setelah mencopot pemasangan AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)
## Langkah selanjutnya
Setelah menyelesaikan langkah-langkah [Prasyarat untuk menggunakan versi 2 AWS CLI](getting-started-prereqs.md) dan menginstal AWS CLI, Anda harus melakukan[Menyiapkan AWS CLI](getting-started-quickstart.md).
# Membangun dan memasang AWS CLI dari sumber
Topik ini menjelaskan cara menginstal atau memperbarui dari sumber ke rilis terbaru AWS Command Line Interface (AWS CLI) pada sistem operasi yang didukung.
Untuk informasi tentang rilis terbaru AWS CLI, lihat [Changelog AWS CLI versi 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) di. GitHub
**penting**
AWS CLI versi 1 dan 2 menggunakan nama `aws` perintah yang sama. Jika sebelumnya Anda menginstal AWS CLI versi 1, lihat[Panduan migrasi untuk AWS CLI versi 2](cliv2-migration.md).
**Topics**
+ [Mengapa membangun dari sumber?](#source-getting-started-install-why)
+ [Langkah cepat](#source-getting-started-install-quicksteps)
+ [Langkah 1: Siapkan semua persyaratan](#source-getting-started-install-reqs)
+ [Langkah 2: Mengkonfigurasi instalasi AWS CLI sumber](#source-getting-started-install-config)
+ [Langkah 3: Membangun AWS CLI](#source-getting-started-install-build)
+ [Langkah 4: Memasang AWS CLI](#source-getting-started-install-instructions)
+ [Langkah 5: Memverifikasi AWS CLI instalasi](#source-getting-started-install-verify)
+ [Contoh alur kerja](#source-getting-started-install-workflows)
+ [Memecahkan masalah kesalahan AWS CLI penginstalan dan uninstall](#source-install-tshoot)
+ [Langkah selanjutnya](#source-install-next-steps)
## Mengapa membangun dari sumber?
AWS CLI Ini [tersedia sebagai installer pra-bangun](getting-started-install.md) untuk sebagian besar platform dan lingkungan serta gambar Docker.
Umumnya, installer ini menyediakan cakupan untuk sebagian besar kasus penggunaan. Petunjuk untuk menginstal dari sumber adalah untuk membantu kasus penggunaan yang tidak dicakup oleh penginstal kami. Beberapa kasus penggunaan ini meliputi yang berikut:
+ Pemasang pra-bangun tidak mendukung lingkungan Anda. Misalnya, ARM 32-bit tidak didukung oleh installer pra-bangun.
+ Pemasang pra-bangun memiliki dependensi yang tidak dimiliki lingkungan Anda. Misalnya, Alpine Linux menggunakan [https://musl.libc.org/](https://musl.libc.org/), tetapi installer saat ini memerlukan `glibc` menyebabkan installer pre-built tidak segera berfungsi.
+ Pemasang pra-bangun memerlukan sumber daya yang membatasi akses lingkungan Anda. Misalnya, sistem keamanan yang diperkeras mungkin tidak memberikan izin ke memori bersama. Ini diperlukan untuk `aws` installer beku.
+ Pemasang pra-bangun sering kali merupakan pemblokir untuk pengelola di manajer paket, karena kontrol penuh atas proses pembangunan untuk kode dan paket lebih disukai. Membangun dari sumber memungkinkan pengelola distribusi proses yang lebih efisien untuk menjaga pembaruan. AWS CLI Mengaktifkan pengelola memberi pelanggan lebih banyak up-to-date versi AWS CLI saat menginstal dari manajer paket pihak ke-3 seperti`brew`,, `yum` dan. `apt`
+ Pelanggan yang menambal AWS CLI fungsionalitas memerlukan membangun dan menginstal AWS CLI from source. Ini sangat penting bagi anggota komunitas yang ingin menguji perubahan yang telah mereka buat pada sumber sebelum memberikan kontribusi perubahan ke AWS CLI GitHub repositori.
## Langkah cepat
**catatan**
Semua contoh kode diasumsikan berjalan dari root direktori sumber.
Untuk membangun dan menginstal AWS CLI from source, ikuti langkah-langkah di bagian ini. Ini AWS CLI memanfaatkan [GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html) untuk menginstal dari sumber. Dalam kasus yang paling sederhana, AWS CLI dapat diinstal dari sumber dengan menjalankan perintah contoh default dari root AWS CLI GitHub repositori.
1. [Siapkan semua persyaratan untuk lingkungan Anda.](#source-getting-started-install-reqs) Ini termasuk dapat menjalankan file yang dihasilkan [GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html) dan Python 3.8 atau yang lebih baru diinstal.
1. Di terminal Anda, arahkan ke tingkat atas folder AWS CLI sumber dan jalankan `./configure` perintah. Perintah ini memeriksa sistem untuk semua dependensi yang diperlukan dan menghasilkan `Makefile` untuk membangun dan menginstal AWS CLI berdasarkan konfigurasi yang terdeteksi dan ditentukan.
------
#### [ Linux and macOS ]
Contoh `./configure` perintah berikut menetapkan konfigurasi build untuk AWS CLI menggunakan pengaturan default.
```
$ ./configure
```
------
#### [ Windows PowerShell ]
Sebelum menjalankan perintah apa pun yang memanggil MSYS2, Anda harus mempertahankan direktori kerja Anda saat ini:
```
PS C:\> $env:CHERE_INVOKING = 'yes'
```
Kemudian gunakan contoh `./configure` perintah berikut untuk mengatur konfigurasi build untuk AWS CLI menggunakan jalur lokal Anda ke executable Python Anda, menginstal ke C:\$1Program Files\$1AWSCLI, dan men-download semua dependensi.
```
PS C:\> C:\msys64\usr\bin\bash -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
```
------
Untuk detail, opsi konfigurasi yang tersedia, dan informasi pengaturan default, lihat [Langkah 2: Mengkonfigurasi instalasi AWS CLI sumber](#source-getting-started-install-config) bagian.
1. Jalankan perintah `make`. Perintah ini membangun AWS CLI sesuai dengan pengaturan konfigurasi Anda.
Contoh `make` perintah berikut dibangun dengan opsi default menggunakan `./configure` pengaturan yang ada.
------
#### [ Linux and macOS ]
```
$ make
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "make"
```
------
Untuk detail dan opsi build yang tersedia, lihat [Langkah 3: Membangun AWS CLI](#source-getting-started-install-build) bagian.
1. Jalankan perintah `make install`. Perintah ini menginstal bawaan Anda AWS CLI ke lokasi yang dikonfigurasi di sistem Anda.
Contoh `make install` perintah berikut menginstal bawaan Anda AWS CLI dan membuat symlink di lokasi yang dikonfigurasi menggunakan pengaturan perintah default.
------
#### [ Linux and macOS ]
```
$ make install
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "make install"
```
Setelah menginstal, tambahkan jalur ke AWS CLI menggunakan yang berikut ini:
```
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
```
------
Untuk detail dan opsi pemasangan yang tersedia, lihat [Langkah 4: Memasang AWS CLI](#source-getting-started-install-instructions) bagian.
1. Konfirmasikan AWS CLI berhasil diinstal menggunakan perintah berikut:
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Untuk langkah-langkah pemecahan masalah untuk kesalahan penginstalan lihat bagian. [Memecahkan masalah kesalahan AWS CLI penginstalan dan uninstall](#source-install-tshoot)
## Langkah 1: Siapkan semua persyaratan
Untuk membangun AWS CLI from source, Anda perlu yang berikut ini diselesaikan sebelumnya:
**catatan**
Semua contoh kode diasumsikan berjalan dari root direktori sumber.
1. Unduh AWS CLI sumbernya dengan mem-forking AWS CLI GitHub repositori atau mengunduh tarball sumber. Instruksi adalah salah satu dari yang berikut:
+ Garpu dan kloning [AWS CLI repositori](https://github.com/aws/aws-cli) dari. *GitHub* Untuk informasi selengkapnya, lihat [Mem-fork repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo) di *GitHub Docs*.
+ Unduh tarball sumber terbaru di [https://awscli.amazonaws.com/awscli.tar.gz](https://awscli.amazonaws.com/awscli.tar.gz) ekstrak konten menggunakan perintah berikut:
```
$ curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscli.tar.gz"
$ tar -xzf awscli.tar.gz
```
**catatan**
Untuk mengunduh versi tertentu, gunakan format tautan berikut: [https://awscli.amazonaws.com*versionnumber*/awscli-](https://awscli.amazonaws.com/awscli.tar.gz) .tar.gz
[Misalnya, untuk versi 2.10.0 tautannya adalah sebagai berikut: https://awscli.amazonaws.com /awscli- .tar.gz *2.10.0*](https://awscli.amazonaws.com/awscli.tar.gz)
Versi sumber tersedia dimulai dengan versi **2.10.0** dari versi. AWS CLI
**(Opsional) Memverifikasi integritas file zip yang Anda unduh dengan menyelesaikan langkah-langkah berikut:**
1. Anda dapat menggunakan langkah-langkah berikut untuk memverifikasi tanda tangan dengan menggunakan alat ini. `GnuPG`
`.zip`File paket AWS CLI installer ditandatangani secara kriptografis menggunakan tanda tangan PGP. Jika ada kerusakan atau perubahan file, verifikasi ini gagal dan Anda tidak boleh melanjutkan dengan instalasi.
1. Unduh dan instal `gpg` perintah menggunakan manajer paket Anda. Untuk informasi selengkapnya`GnuPG`, lihat situs web [GnuPG](https://www.gnupg.org/).
1. Untuk membuat file kunci publik, buat file teks dan tempel dalam teks berikut.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
Sebagai referensi, berikut ini adalah rincian kunci publik.
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. Impor kunci AWS CLI publik dengan perintah berikut, ganti *public-key-file-name* dengan nama file kunci publik yang Anda buat.
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. Unduh file AWS CLI tanda tangan untuk paket yang Anda unduh di [https://awscli.amazonaws.com/awscli.tar.gz.sig](https://awscli.amazonaws.com/awscli.tar.gz.sig). Ini memiliki jalur dan nama yang sama dengan file tarball yang sesuai dengannya, tetapi memiliki ekstensi`.sig`. Simpan di jalur yang sama dengan file tarball. Atau gunakan blok perintah berikut:
```
$ curl awscliv2.sig https://awscli.amazonaws.com/ -o awscli.tar.gz.sig
```
1. Verifikasi tanda tangan, meneruskan nama yang diunduh `.sig` dan `.zip` file sebagai parameter ke `gpg` perintah.
```
$ gpg --verify awscliv2.sig awscli.tar.gz
```
Outputnya akan terlihat serupa dengan yang berikut ini:
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**penting**
Peringatan dalam output diharapkan dan tidak menunjukkan masalah. Itu terjadi karena tidak ada rantai kepercayaan antara kunci PGP pribadi Anda (jika Anda memilikinya) dan kunci AWS CLI PGP. Untuk informasi selengkapnya, lihat [Web kepercayaan](https://wikipedia.org/wiki/Web_of_trust).
1. Anda memiliki lingkungan yang dapat menjalankan file [GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html) yang dihasilkan seperti dan. `configure` `Makefile` File-file ini secara luas portabel di seluruh platform POSIX.
------
#### [ Linux and macOS ]
Jika Autotools belum diinstal di lingkungan Anda atau Anda perlu memperbaruinya, ikuti petunjuk instalasi yang ditemukan di [Bagaimana cara menginstal Autotools (sebagai](https://www.gnu.org/software/automake/faq/autotools-faq.html#How-do-I-install-the-Autotools-_0028as-user_0029_003f) pengguna)? atau [Instalasi Dasar](https://www.gnu.org/savannah-checkouts/gnu/automake/manual/automake.html#Basic-Installation) dalam *dokumentasi GNU*.
------
#### [ Windows PowerShell ]
**Awas**
Kami menyarankan jika Anda berada di lingkungan Windows, Anda menggunakan installer pra-dibangun. Untuk petunjuk pemasangan pada installer yang sudah dibuat sebelumnya, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md)
Karena Windows tidak dilengkapi dengan shell yang sesuai dengan POSIX, Anda perlu menginstal perangkat lunak tambahan untuk menginstal dari AWS CLI sumber. [MSYS2](https://www.msys2.org/)menyediakan kumpulan alat dan pustaka untuk membantu membangun dan menginstal perangkat lunak Windows, terutama untuk skrip berbasis POSIX yang digunakan Autotools.
1. Instal MSYS2. Untuk informasi tentang menginstal dan menggunakan MSYS2, lihat [petunjuk pemasangan dan penggunaan](https://www.msys2.org/) di *MSYS2 Dokumentasi*.
1. Buka MSYS2 terminal dan instal autotools menggunakan perintah berikut.
```
$ pacman -S autotools
```
**catatan**
Saat menggunakan konfigurasi, bangun, dan instal contoh kode dalam panduan ini untuk Windows, jalur MSYS2 penginstalan default `C:\msys64\usr\bin\bash` diasumsikan. Saat memanggil MSYS2 bagian dalam PowerShell Anda akan menggunakan format berikut, dengan perintah bash dalam tanda kutip:
```
PS C:\> C:\msys64\usr\bin\bash -lc "command example"
```
Contoh perintah berikut memanggil `./configure` perintah.
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
```
------
1. Sebuah interpreter Python 3.8 atau yang lebih baru diinstal. Versi Python minimum yang diperlukan mengikuti garis waktu yang sama dengan kebijakan [dukungan Python](https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) resmi untuk dan Alat. AWS SDKs Penerjemah hanya didukung 6 bulan setelah end-of-support tanggalnya.
1. **(Opsional)** Instal semua dependensi pustaka Python build dan runtime dari file. AWS CLI`./configure`Perintah memberi tahu Anda jika Anda kehilangan dependensi dan cara menginstalnya.
Anda dapat secara otomatis menginstal dan menggunakan dependensi ini melalui konfigurasi, lihat [Mengunduh dependensi](#source-getting-started-install-config-dependencies) untuk informasi lebih lanjut.
## Langkah 2: Mengkonfigurasi instalasi AWS CLI sumber
Konfigurasi untuk membangun dan menginstal AWS CLI ditentukan menggunakan `configure` skrip. Untuk dokumentasi semua opsi konfigurasi, jalankan `configure` skrip dengan `--help` opsi:
------
#### [ Linux and macOS ]
```
$ ./configure --help
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure --help"
```
------
**Topics**
+ [Instal lokasi](#source-getting-started-install-config-location)
+ [Penerjemah Python](#source-getting-started-install-config-interpreter)
+ [Mengunduh dependensi](#source-getting-started-install-config-dependencies)
+ [Tipe Instal](#source-getting-started-install-config-type)
### Instal lokasi
Instalasi sumber AWS CLI menggunakan dua direktori yang dapat dikonfigurasi untuk menginstal: AWS CLI
+ `libdir`- Direktori induk tempat AWS CLI akan diinstal. Jalan menuju AWS CLI instalasi adalah`/aws-cli`. `libdir`Nilai default untuk Linux dan macOS adalah `/usr/local/lib` membuat direktori instalasi default `/usr/local/lib/aws-cli`
+ `bindir`- Direktori tempat AWS CLI executable diinstal. Lokasi default adalah `/usr/local/bin`.
`configure`Opsi berikut mengontrol direktori yang digunakan:
+ `--prefix`- Menetapkan awalan direktori untuk digunakan untuk instalasi. Nilai default untuk Linux dan macOS adalah. `/usr/local`
+ `--libdir`- Mengatur `libdir` untuk digunakan untuk menginstal AWS CLI. Nilai default-nya adalah `/lib`. Jika `--prefix` keduanya `--libdir` dan tidak ditentukan, default untuk Linux dan macOS adalah. `/usr/local/lib/`
+ `--bindir`- Menetapkan `bindir` untuk digunakan untuk menginstal AWS CLI `aws` dan `aws_completer` executable. Nilai default-nya adalah `/bin`. Jika `--prefix` keduanya `bindir` dan tidak ditentukan, default untuk Linux dan macOS adalah. `/usr/local/bin/`
------
#### [ Linux and macOS ]
Contoh perintah berikut menggunakan `--prefix` opsi untuk melakukan instalasi pengguna lokal dari AWS CLI. Perintah ini menginstal AWS CLI in `$HOME/.local/lib/aws-cli` dan executable di: `$HOME/.local/bin`
```
$ ./configure --prefix=$HOME/.local
```
Contoh perintah berikut menggunakan `--libdir` opsi untuk menginstal AWS CLI sebagai aplikasi add-on di `/opt` direktori. Perintah ini menginstal AWS CLI at `/opt/aws-cli` dan executable di lokasi default mereka. `/usr/local/bin`
```
$ ./configure --libdir=/opt
```
------
#### [ Windows PowerShell ]
Contoh perintah berikut menggunakan `--prefix` opsi untuk melakukan instalasi pengguna lokal dari AWS CLI. Perintah ini menginstal AWS CLI in `$HOME/.local/lib/aws-cli` dan executable di: `$HOME/.local/bin`
```
$ C:\msys64\usr\bin\bash -lc "./configure --prefix='C:\Program Files\AWSCLI'"
```
Contoh perintah berikut menggunakan `--libdir` opsi untuk menginstal AWS CLI sebagai aplikasi add-on di `/opt` direktori. Perintah ini menginstal AWS CLI at`C:\Program Files\AWSCLI\opt\aws-cli`.
------
### Penerjemah Python
**catatan**
Sangat disarankan untuk menentukan interpreter Python saat menginstal untuk Windows.
`./configure`Skrip secara otomatis memilih penerjemah Python 3.8 atau yang lebih baru yang diinstal untuk digunakan dalam membangun dan menjalankan AWS CLI menggunakan makro Autoconf. [https://www.gnu.org/software/automake/manual/html_node/Python.html](https://www.gnu.org/software/automake/manual/html_node/Python.html)
Penerjemah Python yang akan digunakan dapat diatur secara eksplisit menggunakan variabel `PYTHON` lingkungan saat menjalankan skrip: `configure`
------
#### [ Linux and macOS ]
```
$ PYTHON=/path/to/python ./configure
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "PYTHON='C:\path\to\python' ./configure"
```
------
### Mengunduh dependensi
Secara default, semua dependensi build dan runtime diperlukan AWS CLI sudah diinstal pada sistem. Ini termasuk dependensi pustaka Python. Semua dependensi diperiksa saat `configure` skrip dijalankan, dan jika sistem kehilangan dependensi Python, skrip akan hilang. `configure`
Contoh kode berikut error saat sistem Anda kehilangan dependensi:
------
#### [ Linux and macOS ]
```
$ ./configure
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
File "", line 198, in _run_module_as_main
File "", line 88, in _run_code
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in
main()
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
parsed_args.func(parsed_args)
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
validate_env(parsed_args.artifact)
File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:
awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)
We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.
If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'
configure: error: "Python dependencies not met."
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
File "", line 198, in _run_module_as_main
File "", line 88, in _run_code
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in
main()
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
parsed_args.func(parsed_args)
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
validate_env(parsed_args.artifact)
File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:
awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)
We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.
If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'
configure: error: "Python dependencies not met."
```
------
Untuk menginstal dependensi Python yang diperlukan secara otomatis, gunakan opsi. `--with-download-deps` Saat menggunakan flag ini, proses build melakukan hal berikut:
+ Melewati pemeriksaan dependensi pustaka Python.
+ Mengonfigurasi pengaturan untuk mengunduh semua dependensi Python yang diperlukan dan hanya **menggunakan** dependensi yang diunduh untuk membangun selama pembuatan. AWS CLI `make`
Contoh perintah konfigurasi berikut menggunakan `--with-download-deps` opsi untuk mengunduh dan menggunakan dependensi Python:
------
#### [ Linux and macOS ]
```
$ ./configure --with-download-deps
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure --with-download-deps"
```
------
### Tipe Instal
Proses instalasi sumber mendukung jenis instalasi berikut:
+ `system-sandbox`- **(Default)** Menciptakan lingkungan virtual Python yang terisolasi, menginstal AWS CLI ke dalam lingkungan virtual, dan symlink ke dan dapat `aws_completer` dieksekusi di `aws` lingkungan virtual. Instalasi ini AWS CLI bergantung langsung pada penerjemah Python yang dipilih untuk runtime-nya.
Ini adalah mekanisme instalasi ringan untuk menginstal sistem dan mengikuti praktik Python terbaik dengan melakukan sandboxing instalasi di lingkungan virtual. AWS CLI Instalasi ini ditujukan untuk pelanggan yang ingin menginstal AWS CLI from source dengan cara yang paling mudah dengan instalasi yang digabungkan dengan instalasi Python Anda.
+ `portable-exe`- Membekukan AWS CLI ke dalam executable mandiri yang dapat didistribusikan ke lingkungan arsitektur serupa. Ini adalah proses yang sama yang digunakan untuk menghasilkan executable pra-built resmi dari. AWS CLI`portable-exe`Pembekuan dalam salinan penerjemah Python yang dipilih dalam langkah `configure` yang akan digunakan untuk runtime. AWS CLI Hal ini memungkinkan untuk dipindahkan ke mesin lain yang mungkin tidak memiliki penerjemah Python.
Jenis build ini berguna karena Anda dapat memastikan AWS CLI instalasi Anda tidak digabungkan ke versi Python yang diinstal lingkungan dan Anda dapat mendistribusikan build ke sistem lain yang mungkin belum menginstal Python. Ini memungkinkan Anda untuk mengontrol dependensi dan keamanan pada AWS CLI executable yang Anda gunakan.
Untuk mengkonfigurasi jenis instalasi, gunakan `--with-install-type` opsi dan tentukan nilai `portable-exe` atau`system-sandbox`.
Contoh `./configure` perintah berikut menentukan nilai: `portable-exe`
------
#### [ Linux and macOS ]
```
$ ./configure --with-install-type=portable-exe
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure --with-install-type=portable-exe"
```
------
## Langkah 3: Membangun AWS CLI
Gunakan `make` perintah untuk membangun AWS CLI menggunakan pengaturan konfigurasi Anda:
------
#### [ Linux and macOS ]
```
$ make
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "make"
```
------
**catatan**
Lingkungan virtual dibuat di direktori build menggunakan modul Python [https://docs.python.org/3/library/venv.html](https://docs.python.org/3/library/venv.html). Lingkungan virtual di-bootstrap dengan [versi pip yang dijual di pustaka standar Python](https://docs.python.org/3/library/ensurepip.html).
Menyalin dependensi pustaka Python. Bergantung pada apakah `--with-download-deps` bendera ditentukan dalam `configure` perintah, langkah ini melakukan salah satu hal berikut:
Yang `--with-download-deps` **ditentukan**. Dependensi Python diinstal pip. Ini termasuk`wheel`,`setuptools`, dan semua dependensi AWS CLI runtime. Jika Anda sedang membangun`portable-exe`, `pyinstaller` diinstal. Persyaratan ini semua ditentukan dalam file kunci yang dihasilkan dari [https://github.com/jazzband/pip-tools](https://github.com/jazzband/pip-tools).
`--with-download-deps`**Tidak** ditentukan. Pustaka Python dari paket situs penerjemah Python ditambah skrip apa pun (misalnya`pyinstaller`) disalin ke lingkungan virtual yang digunakan untuk build.
Berjalan `pip install` langsung di AWS CLI basis kode untuk melakukan pembuatan dan pemasangan offline di pohon AWS CLI ke dalam lingkungan virtual build. [Instalasi ini menggunakan bendera pip [-- no-build-isolation ](https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-no-build-isolation), [--use-feature=, - in-tree-build ](https://pip.pypa.io/en/stable/cli/pip_install/#local-project-installs) -, dan. no-cache-dir [https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-no-index](https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-no-index)](https://pip.pypa.io/en/stable/cli/pip_install/#caching)
**(Opsional)** Jika `--install-type` diatur ke `portable-exe` dalam `configure` perintah, membangun executable mandiri menggunakan. [https://www.pyinstaller.org/](https://www.pyinstaller.org/)
## Langkah 4: Memasang AWS CLI
`make install`Perintah menginstal bawaan Anda AWS CLI ke lokasi yang dikonfigurasi pada sistem.
------
#### [ Linux and macOS ]
Contoh perintah berikut menginstal AWS CLI menggunakan konfigurasi dan pengaturan build Anda:
```
$ make install
```
------
#### [ Windows PowerShell ]
Contoh perintah berikut menginstal AWS CLI menggunakan konfigurasi dan pengaturan build Anda, lalu menambahkan variabel lingkungan dengan jalur untuk: AWS CLI
```
PS C:\> C:\msys64\usr\bin\bash -lc " make install "
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
```
------
`make install`Aturan mendukung [https://www.gnu.org/software/make/manual/html_node/DESTDIR.html#DESTDIR](https://www.gnu.org/software/make/manual/html_node/DESTDIR.html#DESTDIR)variabel. Ketika ditentukan, variabel ini mengawali jalur yang ditentukan ke jalur instalasi yang sudah dikonfigurasi saat menginstal. AWS CLI Secara default, tidak ada nilai yang ditetapkan untuk variabel ini.
------
#### [ Linux and macOS ]
Contoh kode berikut menggunakan `--prefix=/usr/local` bendera untuk mengkonfigurasi lokasi penginstalan, dan kemudian mengubah tujuan yang digunakan `DESTDIR=/tmp/stage` untuk perintah. `make install` Perintah-perintah ini menghasilkan AWS CLI yang diinstal di `/tmp/stage/usr/local/lib/aws-cli` dan executable yang terletak di. `/tmp/stage/usr/local/bin`
```
$ ./configure --prefix=/usr/local
$ make
$ make DESTDIR=/tmp/stage install
```
------
#### [ Windows PowerShell ]
Contoh kode berikut menggunakan `--prefix=\awscli` bendera untuk mengkonfigurasi lokasi penginstalan, dan kemudian mengubah tujuan yang digunakan `DESTDIR=C:\Program Files` untuk perintah. `make install` Perintah-perintah ini menghasilkan AWS CLI yang diinstal di`C:\Program Files\awscli`.
```
$ ./configure --prefix=\awscli
$ make
$ make DESTDIR='C:\Program Files' install
```
------
**catatan**
Memindahkan salah satu dari berikut ini ke direktori penginstalan yang dikonfigurasi:
Jika jenis instalasinya`system-sandbox`, pindahkan lingkungan virtual bawaan Anda.
Jika tipe penginstalan adalah a`portable-exe`, pindahkan executable mandiri bawaan Anda.
Membuat symlink untuk kedua `aws` dan `aws_completer` executable di direktori bin dikonfigurasi Anda.
## Langkah 5: Memverifikasi AWS CLI instalasi
Konfirmasikan AWS CLI berhasil diinstal dengan menggunakan perintah berikut:
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Jika `aws` perintah tidak dikenali, Anda mungkin perlu me-restart terminal Anda agar symlink baru dapat diperbarui. Jika Anda menemukan masalah tambahan setelah menginstal atau menghapus instalasi AWS CLI, lihat [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md) langkah-langkah pemecahan masalah umum
## Contoh alur kerja
Bagian ini memberikan beberapa contoh alur kerja dasar untuk menginstal dari sumber.
### Instalasi dasar Linux dan macOS
Contoh berikut adalah alur kerja instalasi dasar di AWS CLI mana diinstal di lokasi default. `/usr/local/lib/aws-cli`
```
$ cd path/to/cli/respository/
$ ./configure
$ make
$ make install
```
### Instalasi Windows otomatis
**catatan**
Anda harus menjalankan PowerShell sebagai Administrator untuk menggunakan alur kerja ini.
MSYS2 dapat digunakan secara otomatis dalam pengaturan CI, lihat [Menggunakan MSYS2 di CI di MSYS2 ](https://www.msys2.org/docs/ci/) *Dokumentasi*.
------
#### [ Downloaded Tarball ]
Unduh `awscli.tar.gz` file, ekstrak, dan instal file AWS CLI. Saat menggunakan perintah berikut, ganti jalur berikut:
+ `C:\msys64\usr\bin\bash`dengan lokasi MSYS2 jalan Anda.
+ `.\awscli-2.x.x\`dengan nama `awscli.tar.gz` folder yang diekstraksi.
+ `PYTHON='C:\path\to\python.exe'`dengan jalur Python lokal Anda.
Contoh kode berikut mengotomatiskan membangun dan menginstal AWS CLI from PowerShell using MSYS2, dan menentukan instalasi lokal Python mana yang akan digunakan:
```
PS C:\> curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscliv2.zip" # Download the awscli.tar.gz file in the current working directory
PS C:\> tar -xvzf .\awscli.tar.gz # Extract awscli.tar.gz file
PS C:\> cd .\awscli-2.x.x\ # Navigate to the root of the extracted files
PS C:\> $env:CHERE_INVOKING = 'yes' # Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
PS C:\> C:\msys64\usr\bin\bash -lc "make"
PS C:\> C:\msys64\usr\bin\bash -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 source-sandbox/AMD64
```
------
#### [ GitHub Repository ]
Unduh `awscli.tar.gz` file, ekstrak, dan instal file AWS CLI. Saat menggunakan perintah berikut, ganti jalur berikut:
+ `C:\msys64\usr\bin\bash`dengan lokasi MSYS2 jalan Anda.
+ `C:path\to\cli\repository\`dengan jalur ke [AWS CLI repositori](https://github.com/aws/aws-cli) kloning Anda dari. *GitHub* *Untuk informasi selengkapnya, lihat [Mem-fork repo di Docs](https://docs.github.com/en/get-started/quickstart/fork-a-repo) GitHub *
+ `PYTHON='C:\path\to\python.exe'`dengan jalur Python lokal Anda.
Contoh kode berikut mengotomatiskan membangun dan menginstal AWS CLI from PowerShell using MSYS2, dan menentukan instalasi lokal Python mana yang akan digunakan:
```
PS C:\> cd C:path\to\cli\repository\
PS C:\> $env:CHERE_INVOKING = 'yes' # Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
PS C:\> C:\msys64\usr\bin\bash -lc "make"
PS C:\> C:\msys64\usr\bin\bash -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
```
------
### Wadah Alpine Linux
Di bawah ini adalah contoh Dockerfile yang dapat digunakan untuk mendapatkan instalasi kerja AWS CLI dalam wadah Alpine Linux sebagai [alternatif binari pra-bangun untuk](https://github.com/aws/aws-cli/issues/4685) Alpine. Saat menggunakan contoh ini, ganti *AWSCLI\$1VERSION* dengan nomor AWS CLI versi yang Anda inginkan:
```
1. FROM python:3.8-alpine AS builder
2.
3. ENV AWSCLI_VERSION=2.10.1
4.
5. RUN apk add --no-cache \
6. curl \
7. make \
8. cmake \
9. gcc \
10. g++ \
11. libc-dev \
12. libffi-dev \
13. openssl-dev \
14. && curl https://awscli.amazonaws.com/awscli-${AWSCLI_VERSION}.tar.gz | tar -xz \
15. && cd awscli-${AWSCLI_VERSION} \
16. && ./configure --prefix=/opt/aws-cli/ --with-download-deps \
17. && make \
18. && make install
19.
20. FROM python:3.8-alpine
21.
22. RUN apk --no-cache add groff
23.
24. COPY --from=builder /opt/aws-cli/ /opt/aws-cli/
25.
26. ENTRYPOINT ["/opt/aws-cli/bin/aws"]
```
Gambar ini dibuat dan AWS CLI dipanggil dari wadah yang mirip dengan yang dibangun di Amazon Linux 2:
```
$ docker build --tag awscli-alpine .
$ docker run --rm -it awscli-alpine --version
aws-cli/2.2.1 Python/3.8.11 Linux/5.10.25-linuxkit source-sandbox/x86_64.alpine.3 prompt/off
```
Ukuran akhir gambar ini lebih kecil dari ukuran gambar AWS CLI Docker resmi. Untuk informasi tentang gambar Docker resmi, lihat[Menjalankan gambar Amazon ECR Public atau Docker resmi untuk AWS CLI](getting-started-docker.md).
## Memecahkan masalah kesalahan AWS CLI penginstalan dan uninstall
Untuk langkah pemecahan masalah kesalahan penginstalan, lihat [Memecahkan masalah kesalahan untuk AWS CLI](cli-chap-troubleshooting.md) langkah-langkah pemecahan masalah umum. Untuk langkah pemecahan masalah yang paling relevan, lihat, [Perintah tidak ditemukan kesalahan](cli-chap-troubleshooting.md#tshoot-install-not-found)[Perintah `aws --version` "" mengembalikan versi yang berbeda dari yang Anda instal](cli-chap-troubleshooting.md#tshoot-install-wrong-version), dan. [Perintah `aws --version` "" mengembalikan versi setelah mencopot pemasangan AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)
Untuk masalah apa pun yang tidak tercakup dalam panduan pemecahan masalah, cari masalah dengan `source-distribution` label di [AWS CLI Repositori](https://github.com/aws/aws-cli/labels/source-distribution) aktif. *GitHub* Jika tidak ada masalah yang menutupi kesalahan Anda, [buat masalah baru](https://github.com/aws/aws-cli/issues/new?assignees=&labels=source-distribution%2Cneeds-triage&template=source-distribution.yml&title=%28short+issue+description%29) untuk menerima bantuan dari AWS CLI pengelola.
## Langkah selanjutnya
Setelah menginstal AWS CLI, Anda harus melakukan[Menyiapkan AWS CLI](getting-started-quickstart.md).
# Menjalankan gambar Amazon ECR Public atau Docker resmi untuk AWS CLI
Topik ini menjelaskan cara menjalankan, mengontrol versi, dan mengonfigurasi AWS CLI versi 2 di Docker menggunakan image resmi Amazon Elastic Container Registry Public (Amazon ECR Public) atau Docker Hub. Untuk informasi selengkapnya tentang cara menggunakan Docker, lihat [dokumentasi Docker.](https://docs.docker.com/)
Gambar resmi menyediakan isolasi, portabilitas, dan keamanan yang AWS secara langsung mendukung dan memelihara. Ini memungkinkan Anda untuk menggunakan AWS CLI versi 2 di lingkungan berbasis wadah tanpa harus mengelola instalasi sendiri.
**Topics**
+ [Prasyarat](#cliv2-docker-prereq)
+ [Memutuskan antara Amazon ECR Public dan Docker Hub](#cliv2-docker-versus)
+ [Jalankan gambar AWS CLI versi resmi 2](#cliv2-docker-install)
+ [Catatan tentang antarmuka dan kompatibilitas mundur dari gambar resmi](#cliv2-docker-install-notes)
+ [Gunakan versi dan tag tertentu](#cliv2-docker-upgrade)
+ [Perbarui ke gambar resmi terbaru](#cliv2-docker-update)
+ [Bagikan file host, kredensi, variabel lingkungan, dan konfigurasi](#cliv2-docker-share-files)
+ [Mempersingkat perintah docker run](#cliv2-docker-aliases)
## Prasyarat
Anda harus menginstal Docker. Untuk petunjuk penginstalan, lihat [situs web Docker](https://docs.docker.com/install/).
Untuk memverifikasi instalasi Docker Anda, jalankan perintah berikut dan konfirmasikan ada output.
```
$ docker --version
Docker version 19.03.1
```
## Memutuskan antara Amazon ECR Public dan Docker Hub
Sebaiknya gunakan Amazon ECR Public melalui Docker Hub untuk AWS CLI gambar. Docker Hub memiliki pembatasan tarif yang lebih ketat untuk konsumen publik yang dapat menyebabkan masalah pelambatan. Selain itu, Amazon ECR Public mereplikasi gambar di lebih dari satu wilayah untuk memberikan ketersediaan yang kuat dan menangani masalah pemadaman wilayah.
Untuk informasi selengkapnya tentang pembatasan laju Docker Hub, lihat [Memahami Pembatasan Tingkat Hub Docker di situs web](https://www.docker.com/increase-rate-limits/) *Docker*.
## Jalankan gambar AWS CLI versi resmi 2
Pertama kali Anda menggunakan `docker run` perintah, gambar terbaru diunduh ke komputer Anda. Setiap penggunaan `docker run` perintah selanjutnya berjalan dari salinan lokal Anda.
Untuk menjalankan gambar Docker AWS CLI versi 2, gunakan `docker run` perintah.
------
#### [ Amazon ECR Public ]
AWS CLI [Versi resmi 2 Amazon ECR Public image di-host di Amazon ECR Public di repositori. `aws-cli/aws-cli`](https://gallery.ecr.aws/aws-cli/aws-cli)
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli command
```
------
#### [ Docker Hub ]
Gambar Docker AWS CLI versi 2 resmi di-host di Docker Hub di repositori. `amazon/aws-cli`
```
$ docker run --rm -it amazon/aws-cli command
```
------
Ini adalah bagaimana perintah berfungsi:
+ `docker run --rm -it repository/name`— Setara dengan yang dapat `aws` dieksekusi. Setiap kali Anda menjalankan perintah ini, Docker memutar wadah gambar yang Anda unduh, dan menjalankan perintah Anda`aws`. Secara default, gambar menggunakan versi terbaru dari AWS CLI versi 2.
Misalnya, untuk memanggil `aws --version` perintah di Docker, Anda menjalankan yang berikut ini.
------
#### [ Amazon ECR Public ]
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli --version
aws-cli/2.27.41 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
```
------
#### [ Docker Hub ]
```
$ docker run --rm -it amazon/aws-cli --version
aws-cli/2.27.41 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
```
------
+ `--rm`- Menentukan untuk membersihkan wadah setelah perintah keluar.
+ `-it`- Menentukan untuk membuka pseudo-TTY dengan. `stdin` Ini memungkinkan Anda untuk memberikan masukan ke AWS CLI versi 2 saat berjalan dalam wadah, misalnya, dengan menggunakan `aws help` perintah `aws configure` and. Saat memilih apakah akan dihilangkan`-it`, pertimbangkan hal berikut:
+ Jika Anda menjalankan skrip, tidak `-it` diperlukan.
+ Jika Anda mengalami kesalahan dengan skrip Anda, menghilangkan `-it` panggilan Docker Anda mungkin memperbaiki masalah.
+ Jika Anda mencoba menyalurkan output, `-it` dapat menyebabkan kesalahan dan menghilangkan `-it` panggilan Docker Anda dapat menyelesaikan masalah ini. Jika Anda ingin menyimpan `-it` flag, tetapi masih ingin menyalurkan output, menonaktifkan [pager sisi klien](cli-usage-pagination.md#cli-usage-pagination-clientside) yang AWS CLI digunakan secara default akan menyelesaikan masalah.
Untuk informasi selengkapnya tentang `docker run` perintah, lihat [panduan referensi Docker](https://docs.docker.com/engine/reference/run/).
## Catatan tentang antarmuka dan kompatibilitas mundur dari gambar resmi
+ Satu-satunya alat yang didukung pada gambar adalah AWS CLI. Hanya `aws` executable yang harus langsung dijalankan. Misalnya, meskipun `less` dan `groff` secara eksplisit diinstal pada gambar, mereka tidak boleh dieksekusi langsung di luar AWS CLI perintah.
+ Direktori `/aws` kerja dikendalikan pengguna. Gambar tidak akan menulis ke direktori ini, kecuali diinstruksikan oleh pengguna dalam menjalankan AWS CLI perintah.
+ Tidak ada jaminan kompatibilitas mundur dalam mengandalkan tag terbaru. Untuk menjamin kompatibilitas mundur, Anda harus menyematkan ke `` tag tertentu karena tag tersebut tidak dapat diubah; mereka hanya akan didorong satu kali.
## Gunakan versi dan tag tertentu
Gambar resmi AWS CLI versi 2 memiliki beberapa versi yang dapat Anda gunakan, dimulai dengan versi`2.0.6`. Untuk menjalankan versi tertentu dari AWS CLI versi 2, tambahkan tag yang sesuai ke `docker run` perintah Anda. Pertama kali Anda menggunakan `docker run` perintah dengan tag, gambar terbaru untuk tag itu diunduh ke komputer Anda. Setiap penggunaan `docker run` perintah berikutnya dengan tag tersebut berjalan dari salinan lokal Anda.
Anda dapat menggunakan dua jenis tag:
+ `latest`— Mendefinisikan versi terbaru dari AWS CLI versi 2 untuk gambar. Kami menyarankan Anda menggunakan `latest` tag ketika Anda menginginkan versi terbaru dari AWS CLI versi 2. Namun, tidak ada jaminan kompatibilitas mundur saat mengandalkan tag ini. `latest`Tag digunakan secara default dalam `docker run` perintah. Untuk menggunakan tag secara eksplisit, tambahkan `latest` tag ke nama gambar kontainer.
------
#### [ Amazon ECR Public ]
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli:latest command
```
------
#### [ Docker Hub ]
```
$ docker run --rm -it amazon/aws-cli:latest command
```
------
+ ``— Mendefinisikan versi tertentu dari AWS CLI versi 2 untuk gambar. Jika Anda berencana untuk menggunakan gambar resmi dalam produksi, kami sarankan Anda menggunakan versi tertentu dari AWS CLI versi 2 untuk memastikan kompatibilitas mundur. Misalnya, untuk menjalankan versi`2.0.6`, tambahkan versi ke nama gambar kontainer.
------
#### [ Amazon ECR Public ]
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli:2.0.6 command
```
------
#### [ Docker Hub ]
```
$ docker run --rm -it amazon/aws-cli:2.0.6 command
```
------
## Perbarui ke gambar resmi terbaru
Karena gambar terbaru diunduh ke komputer Anda hanya saat pertama kali Anda menggunakan `docker run` perintah, Anda perlu menarik gambar yang diperbarui secara manual. Untuk memperbarui secara manual ke versi terbaru, kami sarankan Anda menarik gambar yang `latest` ditandai. Menarik gambar mengunduh versi terbaru ke komputer Anda.
------
#### [ Amazon ECR Public ]
```
$ docker pull public.ecr.aws/aws-cli/aws-cli:latest
```
------
#### [ Docker Hub ]
```
$ docker pull amazon/aws-cli:latest
```
------
## Bagikan file host, kredensi, variabel lingkungan, dan konfigurasi
Karena AWS CLI versi 2 dijalankan dalam wadah, secara default CLI tidak dapat mengakses sistem file host, yang mencakup konfigurasi dan kredensil. Untuk membagikan sistem file host, kredensial, dan konfigurasi ke wadah, pasang `~/.aws` direktori sistem host ke wadah di `/root/.aws` dengan `-v` tanda ke perintah. `docker run` Ini memungkinkan AWS CLI versi 2 yang berjalan di wadah untuk menemukan informasi file host.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli command
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli command
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli command
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli command
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws amazon/aws-cli command
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws amazon/aws-cli command
```
------
Untuk informasi selengkapnya tentang `-v` flag dan pemasangan, lihat [panduan referensi Docker](https://docs.docker.com/storage/volumes/).
**catatan**
Untuk informasi tentang `config` dan `credentials` file, lihat[Konfigurasi dan pengaturan file kredensi di AWS CLI](cli-configure-files.md).
### Contoh 1: Memberikan kredensi dan konfigurasi
Dalam contoh ini, kami menyediakan kredensi dan konfigurasi host saat menjalankan `s3 ls` perintah untuk mencantumkan bucket Anda di Amazon Simple Storage Service (Amazon S3). Contoh di bawah ini menggunakan lokasi default untuk AWS CLI kredensi dan file konfigurasi, untuk menggunakan lokasi yang berbeda, ubah jalur file.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws amazon/aws-cli s3 ls
```
------
Anda dapat memanggil variabel lingkungan sistem tertentu menggunakan `-e` bendera. Untuk menggunakan variabel lingkungan, panggil dengan nama.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
```
------
### Contoh 2: Mengunduh file Amazon S3 ke sistem host Anda
Untuk beberapa perintah AWS CLI versi 2, Anda dapat membaca file dari sistem host di wadah atau menulis file dari wadah ke sistem host.
Dalam contoh ini, kita men-download `S3` objek `s3://aws-cli-docker-demo/hello` ke sistem file lokal Anda dengan memasang direktori kerja saat ini ke `/aws` direktori container. Dengan mengunduh `hello` objek ke `/aws` direktori kontainer, file disimpan ke direktori kerja sistem host saat ini juga.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
```
------
Untuk mengonfirmasi file yang diunduh ada di sistem file lokal, jalankan yang berikut ini.
**Linux dan macOS**
```
$ cat hello
Hello from Docker!
```
**Windows PowerShell**
```
$ type hello
Hello from Docker!
```
### Contoh 3: Menggunakan variabel AWS\$1PROFILE lingkungan Anda
Anda dapat memanggil variabel lingkungan sistem tertentu menggunakan `-e` bendera. Panggil setiap variabel lingkungan yang ingin Anda gunakan. Dalam contoh ini, kami menyediakan kredensi host, konfigurasi, dan variabel *AWS\$1PROFILE* lingkungan saat menjalankan `s3 ls` perintah untuk mencantumkan bucket Anda di Amazon Simple Storage Service (Amazon S3).
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Prompt Perintah Windows**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
```
------
## Mempersingkat perintah docker run
Untuk mempersingkat `docker run` perintah, kami sarankan Anda menggunakan kemampuan sistem operasi Anda untuk membuat [https://www.linux.com/topic/desktop/understanding-linux-links/](https://www.linux.com/topic/desktop/understanding-linux-links/)(symlink) atau [https://www.linux.com/topic/desktop/aliases-diy-shell-commands/](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/)di Linux dan macOS, atau di Windows. [https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey) Untuk mengatur `aws` alias, Anda dapat menjalankan salah satu perintah berikut.
+ Untuk akses dasar ke `aws` perintah, jalankan yang berikut ini.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ alias aws='docker run --rm -it public.ecr.aws/aws-cli/aws-cli'
```
**Prompt Perintah Windows**
```
C:\> doskey aws=docker run --rm -it public.ecr.aws/aws-cli/aws-cli $*
```
**Windows PowerShell**
```
C:\> Function AWSCLI {docker run --rm -it public.ecr.aws/aws-cli/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ alias aws='docker run --rm -it amazon/aws-cli'
```
**Prompt Perintah Windows**
```
C:\> doskey aws=docker run --rm -it amazon/aws-cli $*
```
**Windows PowerShell**
```
C:\> Function AWSCLI {docker run --rm -it amazon/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
+ Untuk akses ke sistem file host dan pengaturan konfigurasi saat menggunakan `aws` perintah, jalankan yang berikut ini.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws public.ecr.aws/aws-cli/aws-cli'
```
**Prompt Perintah Windows**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws public.ecr.aws/aws-cli/aws-cli $*
```
**Windows PowerShell**
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli'
```
**Prompt Perintah Windows**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli $*
```
**Windows PowerShell**
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
+ Untuk menetapkan versi tertentu untuk digunakan dalam `aws` alias Anda, tambahkan tag versi Anda.
------
#### [ Amazon ECR Public ]
**Linux dan macOS**
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws public.ecr.aws/aws-cli/aws-cli:2.0.6'
```
**Prompt Perintah Windows**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws public.ecr.aws/aws-cli/aws-cli:2.0.6 $*
```
**Windows PowerShell**
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli:2.0.6 $args}
Set-Alias -Name aws -Value AWSCLI
```
------
#### [ Docker Hub ]
**Linux dan macOS**
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli:2.0.6'
```
**Prompt Perintah Windows**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli:2.0.6 $*
```
**Windows PowerShell**
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli:2.0.6 $args}
Set-Alias -Name aws -Value AWSCLI
```
------
Setelah mengatur alias Anda, Anda dapat menjalankan AWS CLI versi 2 dari dalam wadah seolah-olah itu diinstal pada sistem host Anda.
```
$ aws --version
aws-cli/2.27.41 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
```
# Menyiapkan AWS CLI
Topik ini menjelaskan cara mengonfigurasi setelan dasar yang digunakan AWS Command Line Interface (AWS CLI) untuk berinteraksi dengan cepat AWS. Ini termasuk kredenal keamanan Anda, format output default, dan Wilayah default AWS .
**Topics**
+ [Kumpulkan informasi kredensi Anda untuk akses terprogram](#getting-started-prereqs-keys)
+ [Menyiapkan konfigurasi dan kredensional baru](#getting-started-quickstart-new)
+ [Menggunakan file konfigurasi dan kredensial yang ada](#getting-started-quickstart-existing)
## Kumpulkan informasi kredensi Anda untuk akses terprogram
Anda akan memerlukan akses terprogram jika Anda ingin berinteraksi dengan AWS luar. Konsol Manajemen AWS Untuk instruksi otentikasi dan kredensi, pilih salah satu opsi berikut:
****
| Jenis autentikasi | Tujuan | Petunjuk |
| --- | --- | --- |
| AWS Kredensial Konsol Manajemen | **(Disarankan)** Gunakan kredenal jangka pendek dengan masuk ke AWS CLI dengan kredenal konsol Anda. Disarankan jika Anda menggunakan root, pengguna IAM, atau federasi dengan IAM untuk akses akun AWS | [Login untuk pengembangan AWS lokal menggunakan kredensi konsol](cli-configure-sign-in.md) |
| Kredensi jangka pendek pengguna IAM Identity Center tenaga kerja | Gunakan kredensi jangka pendek untuk pengguna tenaga kerja IAM Identity Center.Praktik keamanan terbaik adalah AWS Organizations dengan menggunakan IAM Identity Center. Ini menggabungkan kredensi jangka pendek dengan direktori pengguna, seperti direktori Pusat Identitas IAM bawaan atau Direktori Aktif. | [Mengkonfigurasi autentikasi Pusat Identitas IAM dengan AWS CLI](cli-configure-sso.md) |
| Kredensi jangka pendek pengguna IAM | Gunakan kredensi jangka pendek pengguna IAM, yang lebih aman daripada kredensi jangka panjang. Jika kredensi Anda dikompromikan, ada waktu terbatas mereka dapat digunakan sebelum kedaluwarsa. | [Mengautentikasi dengan kredensi jangka pendek untuk AWS CLI](cli-authentication-short-term.md) |
| Pengguna IAM atau IAM Identity Center pada instans Amazon EC2. | Gunakan metadata instans Amazon EC2 untuk menanyakan kredenal sementara menggunakan peran yang ditetapkan ke instans Amazon EC2. | [Menggunakan metadata instans Amazon EC2 sebagai kredensional di AWS CLI](cli-configure-metadata.md) |
| Asumsikan peran untuk izin | Pasangkan metode kredensi lain dan ambil peran untuk akses sementara ke pengguna Layanan AWS Anda mungkin tidak dapat mengaksesnya. | [Menggunakan peran IAM dalam AWS CLI](cli-configure-role.md) |
| Kredensi jangka panjang pengguna IAM | (Tidak disarankan) Gunakan kredenal jangka panjang, yang tidak memiliki kedaluwarsa. | [Mengautentikasi menggunakan kredensi pengguna IAM untuk AWS CLI](cli-authentication-user.md) |
| Penyimpanan eksternal pengguna tenaga kerja IAM atau IAM Identity Center | (Tidak disarankan) Pasangkan metode kredensi lain tetapi simpan nilai kredensi di lokasi di luar. AWS CLI Metode ini hanya seaman lokasi eksternal kredensialnya disimpan. | [Sumber kredensyal dengan proses eksternal di AWS CLI](cli-configure-sourcing-external.md) |
## Menyiapkan konfigurasi dan kredensional baru
AWS CLI Menyimpan konfigurasi dan informasi kredensi Anda dalam *profil* (kumpulan pengaturan) di `credentials` dan `config` file.
**Topics**
+ [Mengkonfigurasi menggunakan perintah AWS CLI](#getting-started-quickstart-new-command)
+ [Mengedit kredensi dan file konfigurasi secara manual](#getting-started-quickstart-new-file)
Contoh berikut menggunakan nilai sampel untuk masing-masing metode otentikasi. Ganti nilai sampel dengan nilai Anda sendiri.
### Mengkonfigurasi menggunakan perintah AWS CLI
Untuk penggunaan umum, `aws configure sso` perintah `aws configure` atau di terminal pilihan Anda adalah cara tercepat untuk mengatur AWS CLI instalasi Anda. Berdasarkan metode kredensi yang Anda inginkan, AWS CLI meminta Anda untuk informasi yang relevan. Secara default, informasi dalam profil ini digunakan saat Anda menjalankan AWS CLI perintah yang tidak secara eksplisit menentukan profil yang akan digunakan.
Untuk informasi lebih lanjut tentang `config` file `credentials` dan, lihat[Konfigurasi dan pengaturan file kredensi di AWS CLI](cli-configure-files.md).
------
#### [ Console sessions as short-term credentials ]
Contoh ini memungkinkan Anda menggunakan kredenal konsol yang ada dengan perintah. `aws login` Metode masuk ini dapat digunakan dengan kredensi root yang dibuat selama pengaturan akun awal, pengguna IAM, atau identitas gabungan dari penyedia identitas Anda. Untuk informasi selengkapnya, lihat [Login untuk pengembangan AWS lokal menggunakan kredenal konsol](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sign-in.html).
```
$ aws login
No AWS region has been configured. The AWS region is the geographic location of your AWS resources.
If you've used AWS before and already have resources in your account, tell us which region they were
created in. If you haven't created resources in your account before, you can pick the region closest to you:
https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html. You are able to change
the region in the CLI at any time with the command `aws configure set region NEW_REGION`.
AWS Region [us-east-1]: us-east-1
Attempting to open the login page for `us-east-1` in your default browser. If the browser does not open,
use the following URL to complete your login:
https://us-east-1.signin.aws.amazon.com/v1/authorize
If you cannot connect to this URL, make sure that you have specified a valid region.
Waiting for login...
Logged in with role `arn:aws:sts::012345678910:user/iam-user`, and configured profile
`default` to use `us-east-1`. This session will expire on October 14, 2025 at 2:04 PST. After this time, you
can renew your session with `aws login`.
```
------
#### [ IAM Identity Center (SSO) ]
Contoh ini untuk AWS IAM Identity Center menggunakan `aws configure sso` wizard. Untuk informasi selengkapnya, lihat [Mengkonfigurasi autentikasi Pusat Identitas IAM dengan AWS CLI](cli-configure-sso.md).
```
$ aws configure sso
SSO session name (Recommended): my-sso
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]:us-east-1
Attempting to automatically open the SSO authorization page in your default browser.
There are 2 AWS accounts available to you.
> DeveloperAccount, developer-account-admin@example.com (111122223333)
ProductionAccount, production-account-admin@example.com (444455556666)
Using the account ID 111122223333
There are 2 roles available to you.
> ReadOnly
FullAccess
Using the role name "ReadOnly"
CLI default client Region [None]: us-west-2
CLI default output format [None]: json
CLI profile name [123456789011_ReadOnly]: user1
```
------
#### [ IAM Identity Center (Legacy SSO) ]
Contoh ini untuk metode lama AWS IAM Identity Center menggunakan `aws configure sso` wizard. Untuk menggunakan SSO lama, biarkan nama sesi kosong. Untuk informasi selengkapnya, lihat [Mengkonfigurasi autentikasi Pusat Identitas IAM dengan AWS CLI](cli-configure-sso.md).
```
$ aws configure sso
SSO session name (Recommended):
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]:us-east-1
SSO authorization page has automatically been opened in your default browser.
Follow the instructions in the browser to complete this authorization request.
There are 2 AWS accounts available to you.
> DeveloperAccount, developer-account-admin@example.com (111122223333)
ProductionAccount, production-account-admin@example.com (444455556666)
Using the account ID 111122223333
There are 2 roles available to you.
> ReadOnly
FullAccess
Using the role name "ReadOnly"
CLI default client Region [None]: us-west-2
CLI default output format [None]: json
CLI profile name [123456789011_ReadOnly]: user1
```
------
#### [ Short-term credentials ]
Contoh ini untuk kredensi jangka pendek dari. AWS Identity and Access Management Wisaya konfigurasi aws digunakan untuk mengatur nilai awal dan kemudian `aws configure set` perintah menetapkan nilai terakhir yang diperlukan. Untuk informasi selengkapnya, lihat [Mengautentikasi dengan kredensi jangka pendek untuk AWS CLI](cli-authentication-short-term.md).
```
$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json
$ aws configure set aws_session_token fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
------
#### [ IAM role ]
Contoh ini untuk mengasumsikan peran IAM. Profil yang menggunakan peran IAM menarik kredensional dari profil lain, lalu menerapkan izin peran IAM. Dalam contoh berikut, `default` adalah profil sumber untuk kredensional dan `user1` meminjam kredenal yang sama kemudian mengasumsikan peran baru. Tidak ada wizard untuk proses ini, oleh karena itu setiap nilai diatur menggunakan `aws configure set` perintah. Untuk informasi selengkapnya, lihat [Menggunakan peran IAM dalam AWS CLI](cli-configure-role.md).
```
$ aws configure set role_arn arn:aws:iam::123456789012:role/defaultrole
$ aws configure set source_profile default
$ aws configure set role_session_name session_user1
$ aws configure set region us-west-2
$ aws configure set output json
```
------
#### [ Amazon EC2 instance metadata credentials ]
Contoh ini untuk kredensi yang diperoleh dari metadata instans Amazon EC2 hosting. Tidak ada wizard untuk proses ini, oleh karena itu setiap nilai diatur menggunakan `aws configure set` perintah. Untuk informasi selengkapnya, lihat [Menggunakan metadata instans Amazon EC2 sebagai kredensional di AWS CLI](cli-configure-metadata.md).
```
$ aws configure set role_arn arn:aws:iam::123456789012:role/defaultrole
$ aws configure set credential_source Ec2InstanceMetadata
$ aws configure set region us-west-2
$ aws configure set output json
```
------
#### [ Long-term credentials ]
**Awas**
Untuk menghindari risiko keamanan, jangan gunakan pengguna IAM untuk otentikasi saat mengembangkan perangkat lunak yang dibuat khusus atau bekerja dengan data nyata. Sebaliknya, gunakan federasi dengan penyedia identitas seperti [AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html).
Contoh ini untuk kredensi jangka panjang dari. AWS Identity and Access Management Untuk informasi selengkapnya, lihat [Mengautentikasi menggunakan kredensi pengguna IAM untuk AWS CLI](cli-authentication-user.md).
```
$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json
```
------
Untuk informasi lebih rinci tentang otentikasi dan metode kredensi lihat. [Otentikasi dan akses kredensional untuk AWS CLI](cli-chap-authentication.md)
### Mengedit kredensi dan file konfigurasi secara manual
Saat menyalin dan menempelkan informasi, kami sarankan untuk mengedit `credentials` file `config` dan secara manual. Berdasarkan metode kredensi yang Anda inginkan, file diatur dengan cara yang berbeda.
File disimpan di direktori home Anda di bawah `.aws` folder. Di mana Anda menemukan lokasi direktori home Anda bervariasi berdasarkan sistem operasi, tetapi disebut menggunakan variabel lingkungan `%UserProfile%` di Windows dan `$HOME` atau `~` (tilde) dalam sistem berbasis Unix. Untuk informasi selengkapnya tentang tempat pengaturan ini disimpan, lihat[Di mana pengaturan konfigurasi disimpan?](cli-configure-files.md#cli-configure-files-where).
Contoh berikut menunjukkan `default` profil dan profil bernama `user1` dan menggunakan nilai sampel. Ganti nilai sampel dengan nilai Anda sendiri. Untuk informasi lebih lanjut tentang `config` file `credentials` dan, lihat[Konfigurasi dan pengaturan file kredensi di AWS CLI](cli-configure-files.md).
------
#### [ IAM Identity Center (SSO) ]
Contoh ini untuk AWS IAM Identity Center. Untuk informasi selengkapnya, lihat [Mengkonfigurasi autentikasi Pusat Identitas IAM dengan AWS CLI](cli-configure-sso.md).
**File kredensial**
`credentials`File tidak digunakan untuk metode otentikasi ini.
**Berkas Config**
```
[default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = readOnly
region = us-west-2
output = text
[profile user1]
sso_session = my-sso
sso_account_id = 444455556666
sso_role_name = readOnly
region = us-east-1
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_registration_scopes = sso:account:access
```
------
#### [ IAM Identity Center (Legacy SSO) ]
Contoh ini untuk metode warisan. AWS IAM Identity Center Untuk informasi selengkapnya, lihat [Mengkonfigurasi autentikasi Pusat Identitas IAM dengan AWS CLI](cli-configure-sso.md).
**File kredensial**
`credentials`File tidak digunakan untuk metode otentikasi ini.
**Berkas Config**
```
[default]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-east-1
sso_account_id = 111122223333
sso_role_name = readOnly
region = us-west-2
output = text
[profile user1]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-east-1
sso_account_id = 444455556666
sso_role_name = readOnly
region = us-east-1
output = json
```
------
#### [ Short-term credentials ]
Contoh ini untuk kredensi jangka pendek dari. AWS Identity and Access Management Untuk informasi selengkapnya, lihat [Mengautentikasi dengan kredensi jangka pendek untuk AWS CLI](cli-authentication-short-term.md).
**File kredensial**
```
[default]
aws_access_key_id=ASIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
[user1]
aws_access_key_id=ASIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
**Berkas Config**
```
[default]
region=us-west-2
output=json
[profile user1]
region=us-east-1
output=text
```
------
#### [ IAM role ]
Contoh ini untuk mengasumsikan peran IAM. Profil yang menggunakan peran IAM menarik kredensional dari profil lain, lalu menerapkan izin peran IAM. Dalam contoh berikut, `default` adalah profil sumber untuk kredensional dan `user1` meminjam kredenal yang sama kemudian mengasumsikan peran baru. Untuk informasi selengkapnya, lihat [Menggunakan peran IAM dalam AWS CLI](cli-configure-role.md).
**File kredensial**
`credentials`File tergantung pada otentikasi apa yang digunakan profil sumber Anda. Untuk contoh berikut, profil sumber menggunakan kredensi jangka pendek.
```
[default]
aws_access_key_id=ASIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
**Berkas Config**
```
[default]
region=us-west-2
output=json
[profile user1]
role_arn=arn:aws:iam::777788889999:role/user1role
source_profile=default
role_session_name=session_user1
region=us-east-1
output=text
```
------
#### [ Amazon EC2 instance metadata credentials ]
Contoh ini untuk kredensi yang diperoleh dari metadata instans Amazon EC2 hosting. Untuk informasi selengkapnya, lihat [Menggunakan metadata instans Amazon EC2 sebagai kredensional di AWS CLI](cli-configure-metadata.md).
**File kredensial**
`credentials`File tidak digunakan untuk metode otentikasi ini.
**Berkas Config**
```
[default]
role_arn=arn:aws:iam::123456789012:role/defaultrole
credential_source=Ec2InstanceMetadata
region=us-west-2
output=json
[profile user1]
role_arn=arn:aws:iam::777788889999:role/user1role
credential_source=Ec2InstanceMetadata
region=us-east-1
output=text
```
------
#### [ Long-term credentials ]
**Awas**
Untuk menghindari risiko keamanan, jangan gunakan pengguna IAM untuk otentikasi saat mengembangkan perangkat lunak yang dibuat khusus atau bekerja dengan data nyata. Sebaliknya, gunakan federasi dengan penyedia identitas seperti [AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html).
Contoh ini untuk kredensi jangka panjang dari. AWS Identity and Access Management Untuk informasi selengkapnya, lihat [Mengautentikasi menggunakan kredensi pengguna IAM untuk AWS CLI](cli-authentication-user.md).
**File kredensial**
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
[user1]
aws_access_key_id=AKIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
```
**Berkas Config**
```
[default]
region=us-west-2
output=json
[profile user1]
region=us-east-1
output=text
```
------
Untuk informasi lebih rinci tentang otentikasi dan metode kredensi lihat. [Otentikasi dan akses kredensional untuk AWS CLI](cli-chap-authentication.md)
## Menggunakan file konfigurasi dan kredensial yang ada
Jika Anda memiliki file konfigurasi dan kredensial yang ada, ini dapat digunakan untuk file. AWS CLI
Untuk menggunakan `credentials` file `config` dan, pindahkan ke folder bernama `.aws` di direktori home Anda. Di mana Anda menemukan lokasi direktori home Anda bervariasi berdasarkan sistem operasi, tetapi disebut menggunakan variabel lingkungan `%UserProfile%` di Windows dan `$HOME` atau `~` (tilde) dalam sistem berbasis Unix.
Anda dapat menentukan lokasi non-default untuk `credentials` file `config` dan dengan mengatur variabel `AWS_CONFIG_FILE` dan `AWS_SHARED_CREDENTIALS_FILE` lingkungan ke jalur lokal lain. Lihat [Mengkonfigurasi variabel lingkungan untuk AWS CLI](cli-configure-envvars.md) untuk detail.
Untuk informasi lebih rinci tentang konfigurasi dan file kredensional, lihat. [Konfigurasi dan pengaturan file kredensi di AWS CLI](cli-configure-files.md)