Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Instal AWS SAMCLI Instal rilis terbaru dari AWS Serverless Application Model Command Line Interface (AWS SAMCLI) pada sistem operasi yang didukung dengan mengikuti petunjuk di[Langkah 4: Instal AWS CLI](prerequisites.md#prerequisites-install-cli). Untuk informasi tentang mengelola versi yang saat ini diinstal AWS SAMCLI, termasuk cara memutakhirkan, menghapus instalasi, atau mengelola build malam hari, lihat. [Mengelola AWS SAMCLI versi](manage-sam-cli-versions.md) **Apakah ini pertama kalinya Anda menginstalAWS SAM CLI?** Lengkapi semua [prasyarat](prerequisites.md) di bagian sebelumnya sebelum bergerak maju. Hal ini mencakup: Mendaftar untuk AWS akun. Menyiapkan akses aman ke AWS. Membuat ID kunci akses dan kunci akses rahasia. Memasang AWS CLI. Mengkonfigurasi AWS kredensional. **Topics** + [Memasang AWS SAMCLI](#install-sam-cli-instructions) + [Memecahkan masalah kesalahan instalasi](#sam-cli-troubleshoot-install) + [Langkah selanjutnya](#install-sam-cli-next-steps) + [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md) ## Memasang AWS SAMCLI **catatan** Mulai September 2023, tidak AWS akan lagi mempertahankan Homebrew installer AWS terkelola untuk AWS SAMCLI ()`aws/tap/aws-sam-cli`. Jika Anda menggunakan Homebrew untuk menginstal dan mengelola AWS SAMCLI, lihat opsi berikut: Untuk terus menggunakanHomebrew, Anda dapat menggunakan penginstal yang dikelola komunitas. Untuk informasi selengkapnya, lihat [Mengelola AWS SAMCLI dengan Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew). Sebaiknya gunakan salah satu metode instalasi pihak pertama yang didokumentasikan di halaman ini. Sebelum menggunakan salah satu metode ini, lihat[Beralih dari Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-switch). Untuk detail tambahan, lihat [Versi rilis: 1.121.0](https://github.com/aws/aws-sam-cli/releases). Untuk menginstal AWS SAMCLI, ikuti instruksi untuk sistem operasi Anda. ### Linux ------ #### [ x86\_64 - command line installer ] 1. Unduh [AWS SAMCLIfile.zip](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip) ke direktori pilihan Anda. 1. **(Opsional)** Anda dapat memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Buka zip file instalasi ke direktori pilihan Anda. Berikut ini adalah contoh, menggunakan `sam-installation` subdirektori. **catatan** Gunakan ekuivalen jika sistem pengoperasian Anda tidak memiliki perintah **unzip**. ``` $ unzip aws-sam-cli-linux-x86_64.zip -d {{sam-installation}} ``` 1. Instal AWS SAMCLI dengan menjalankan `install` executable. Executable ini terletak di direktori yang digunakan pada langkah sebelumnya. Berikut ini adalah contoh, menggunakan `sam-installation` subdirektori: ``` $ sudo ./{{sam-installation}}/install ``` 1. Verifikasi instalasi. ``` $ sam --version ``` Untuk mengonfirmasi penginstalan yang berhasil, Anda akan melihat output yang menggantikan teks kurung berikut dengan versi terbaru yang tersedia: ``` SAM CLI, {{}} ``` ------ #### [ arm64 - command line installer ] 1. Unduh [AWS SAMCLIfile.zip](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip) ke direktori pilihan Anda. 1. **(Opsional)** Anda dapat memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Buka zip file instalasi ke direktori pilihan Anda. Berikut ini adalah contoh, menggunakan `sam-installation` subdirektori. **catatan** Gunakan ekuivalen jika sistem pengoperasian Anda tidak memiliki perintah **unzip**. ``` $ unzip aws-sam-cli-linux-arm64.zip -d {{sam-installation}} ``` 1. Instal AWS SAMCLI dengan menjalankan `install` executable. Executable ini terletak di direktori yang digunakan pada langkah sebelumnya. Berikut ini adalah contoh, menggunakan `sam-installation` subdirektori: ``` $ sudo ./{{sam-installation}}/install ``` 1. Verifikasi instalasi. ``` $ sam --version ``` Untuk mengonfirmasi instalasi yang berhasil, Anda akan melihat output seperti berikut ini tetapi itu menggantikan teks kurung dengan versi SAM CLI terbaru: ``` SAM CLI, {{}} ``` ------ ### macOS #### Langkah-langkah instalasi Gunakan penginstal paket untuk menginstal file. AWS SAMCLI Selain itu, installer paket memiliki dua metode instalasi yang dapat Anda pilih: **GUI** dan **Command** line. Anda dapat menginstal untuk **semua pengguna** atau hanya **pengguna Anda saat ini**. Untuk menginstal untuk semua pengguna, otorisasi superuser diperlukan. **catatan** AWS SAM CLI tidak mendukung versi macOS yang lebih lama dari macOS 13.x. Tingkatkan ke versi macOS yang didukung atau instal CLI AWS SAM dengan. Homebrew ------ #### [ GUI - All users ] **Untuk mengunduh penginstal paket dan menginstal AWS SAMCLI** **catatan** Jika sebelumnya Anda menginstal AWS SAMCLI through Homebrew ataupip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat [Menghapus instalasi AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Unduh macOS `pkg` ke direktori pilihan Anda: + **Untuk Mac yang menjalankan prosesor Intel, pilih x86\_64** [- -x86\_64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Untuk Mac yang menjalankan silikon Apple, pilih arm64 - -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **catatan** Anda memiliki opsi untuk memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Jalankan file yang Anda unduh dan ikuti petunjuk di layar untuk melanjutkan melalui langkah-langkah **Pendahuluan**, **Baca Saya**, dan **Lisensi**. 1. Untuk **Destination Select**, pilih **Instal untuk semua pengguna komputer ini**. 1. Untuk **Jenis Instalasi**, pilih di mana AWS SAMCLI akan diinstal dan tekan **Instal**. Lokasi default yang disarankan adalah`/usr/local/aws-sam-cli`. **catatan** Untuk menjalankan **sam** perintah AWS SAMCLI with, installer secara otomatis membuat symlink antara `/usr/local/bin/sam` dan salah satu `/usr/local/aws-sam-cli/sam` atau folder instalasi yang Anda pilih. 1. AWS SAMCLIAkan menginstal dan **Instalasi berhasil** pesan akan ditampilkan. Tekan **Tutup**. **Untuk memverifikasi instalasi yang berhasil** + Verifikasi bahwa symlink AWS SAMCLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ GUI - Current user ] **Untuk mengunduh dan menginstal AWS SAMCLI** **catatan** Jika sebelumnya Anda menginstal AWS SAMCLI through Homebrew ataupip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat [Menghapus instalasi AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Unduh macOS `pkg` ke direktori pilihan Anda: + **Untuk Mac yang menjalankan prosesor Intel, pilih x86\_64** [- -x86\_64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Untuk Mac yang menjalankan silikon Apple, pilih arm64 - -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **catatan** Anda memiliki opsi untuk memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Jalankan file yang Anda unduh dan ikuti petunjuk di layar untuk melanjutkan melalui langkah-langkah **Pendahuluan**, **Baca Saya**, dan **Lisensi**. 1. Untuk **Destination Select**, pilih **Install for me only**. Jika Anda tidak melihat opsi ini, lanjutkan ke langkah berikutnya. 1. Untuk **Jenis Instalasi**, lakukan hal berikut: 1. Pilih di mana yang AWS SAMCLI akan diinstal. Lokasi default adalah `/usr/local/aws-sam-cli`. Pilih lokasi yang memiliki izin tulis untuk Anda. Untuk mengubah lokasi instalasi, pilih **lokal** dan pilih lokasi Anda. Tekan **Lanjutkan** setelah selesai. 1. Jika Anda tidak mendapatkan opsi untuk memilih **Install for me hanya** pada langkah sebelumnya, pilih **Change Install Location > Install** **for me only** dan tekan **Continue**. 1. Tekan **Instal**. 1. AWS SAMCLIAkan menginstal dan **Instalasi berhasil** pesan akan ditampilkan. Tekan **Tutup**. **Untuk membuat symlink** + Untuk menjalankan **sam** perintah AWS SAMCLI with the, Anda harus secara manual membuat symlink antara AWS SAMCLI program dan program Anda. `$PATH` Buat symlink Anda dengan memodifikasi dan menjalankan perintah berikut: ``` $ {{sudo}} ln -s {{/path-to}}/aws-sam-cli/sam {{/path-to-symlink-directory}}/sam ``` + {{sudo}}— Jika pengguna Anda memiliki izin menulis`$PATH`, tidak **sudo** diperlukan. Sebaliknya, **sudo** diperlukan. + {{path-to}}— Jalur ke tempat Anda menginstal AWS SAMCLI program. Misalnya, `/Users/myUser/Desktop`. + {{path-to-symlink-directory}}- Variabel `$PATH` lingkungan Anda. Lokasi default adalah `/usr/local/bin`. **Untuk memverifikasi instalasi yang berhasil** + Verifikasi bahwa symlink AWS SAMCLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - All users ] **Untuk mengunduh dan menginstal AWS SAMCLI** **catatan** Jika sebelumnya Anda menginstal AWS SAMCLI through Homebrew ataupip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat [Menghapus instalasi AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Unduh macOS `pkg` ke direktori pilihan Anda: + **Untuk Mac yang menjalankan prosesor Intel, pilih x86\_64** [- -x86\_64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Untuk Mac yang menjalankan silikon Apple, pilih arm64 - -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **catatan** Anda memiliki opsi untuk memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Ubah dan jalankan skrip instalasi: ``` $ sudo installer -pkg {{path-to-pkg-installer}}/{{name-of-pkg-installer}} -target / installer: Package name is AWS SAM CLI installer: Upgrading at base path / installer: The upgrade was successful. ``` **catatan** Untuk memanggil **sam** perintah AWS SAMCLI with, installer secara otomatis membuat symlink antara dan. `/usr/local/bin/sam` `/usr/local/aws-sam-cli/sam` **Untuk memverifikasi instalasi yang berhasil** + Verifikasi bahwa symlink AWS SAMCLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - Current user ] **Untuk mengunduh dan menginstal AWS SAMCLI** **catatan** Jika sebelumnya Anda menginstal AWS SAMCLI through Homebrew ataupip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat [Menghapus instalasi AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Unduh macOS `pkg` ke direktori pilihan Anda: + **Untuk Mac yang menjalankan prosesor Intel, pilih x86\_64** [- -x86\_64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Untuk Mac yang menjalankan silikon Apple, pilih arm64 - -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **catatan** Anda memiliki opsi untuk memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Tentukan direktori instalasi yang Anda miliki izin menulis. Kemudian, buat `xml` file menggunakan template dan memodifikasinya untuk mencerminkan direktori instalasi Anda. Direktori harus sudah ada. Misalnya, jika Anda mengganti {{path-to-my-directory}} dengan`/Users/myUser/Desktop`, folder `aws-sam-cli` program akan diinstal di sana. ``` choiceAttribute customLocation attributeSetting {{path-to-my-directory}} choiceIdentifier default ``` 1. Simpan `xml` file dan verifikasi bahwa itu valid dengan menjalankan yang berikut: ``` $ installer -pkg {{path-to-pkg-installer}} \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML {{path-to-your-xml-file}} ``` Output harus menampilkan preferensi yang akan diterapkan pada AWS SAMCLI program. 1. Jalankan yang berikut ini untuk menginstal AWS SAMCLI: ``` $ installer -pkg {{path-to-pkg-installer}} \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML {{path-to-your-xml-file}} # Example output installer: Package name is AWS SAM CLI installer: choices changes file '{{path-to-your-xml-file}}' applied installer: Upgrading at base path {{base-path-of-xml-file}} installer: The upgrade was successful. ``` **Untuk membuat symlink** + Untuk menjalankan **sam** perintah AWS SAMCLI with the, Anda harus secara manual membuat symlink antara AWS SAMCLI program dan program Anda. `$PATH` Buat symlink Anda dengan memodifikasi dan menjalankan perintah berikut: ``` $ {{sudo}} ln -s {{/path-to}}/aws-sam-cli/sam {{/path-to-symlink-directory}}/sam ``` + {{sudo}}— Jika pengguna Anda memiliki izin menulis`$PATH`, tidak **sudo** diperlukan. Sebaliknya, **sudo** diperlukan. + {{path-to}}— Jalur ke tempat Anda menginstal AWS SAMCLI program. Misalnya, `/Users/myUser/Desktop`. + {{path-to-symlink-directory}}- Variabel `$PATH` lingkungan Anda. Lokasi default adalah `/usr/local/bin`. **Untuk memverifikasi instalasi yang berhasil** + Verifikasi bahwa symlink AWS SAMCLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ ### Windows File Penginstal Windows (MSI) merupakan file penginstal paket untuk sistem pengoperasian Windows. Ikuti langkah-langkah ini untuk menginstal AWS SAMCLI menggunakan file MSI. 1. Unduh AWS SAMCLI [64-bit](https://github.com/aws/aws-sam-cli/releases/latest/download/AWS_SAM_CLI_64_PY3.msi). 1. **(Opsional)** Anda dapat memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat [Opsional: Verifikasi integritas AWS SAMCLI penginstal](reference-sam-cli-install-verify.md). 1. Verifikasi instalasi. Setelah menyelesaikan instalasi, verifikasi dengan membuka command prompt atau PowerShell prompt baru. Anda harus dapat memanggil `sam` dari baris perintah. ``` sam --version ``` Setelah instalasi berhasil AWS SAMCLI, Anda akan melihat output seperti berikut: ``` SAM CLI, {{}} ``` 1. Aktifkan jalur panjang (hanya Windows 10 dan yang lebih baru). **penting** AWS SAMCLIMungkin berinteraksi dengan jalur file yang melebihi batasan jalur maks Windows. Ini dapat menyebabkan kesalahan saat berjalan `sam init` karena **MAX\_PATH** keterbatasan Windows 10. Untuk mengatasi masalah ini, perilaku jalur panjang yang baru harus dikonfigurasi. Untuk mengaktifkan jalur panjang, lihat [Mengaktifkan Jalur Panjang di Windows 10, Versi 1607, dan Nanti](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later) di *Dokumentasi Pengembangan Aplikasi Microsoft Windows*. 1. Instal Git. Anda juga harus menginstal Git untuk mengunduh aplikasi contoh menggunakan perintah `sam init`. Untuk instruksi, lihat [Menginstal Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). ## Memecahkan masalah kesalahan instalasi ### Linux #### Kesalahan Docker: "Tidak dapat terhubung ke daemon Docker. Apakah daemon docker berjalan pada host ini?" Di beberapa kasus, Anda mungkin perlu mem-boot ulang instans Anda agar memberikan izin kepada `ec2-user` untuk mengakses Docker daemon. Jika Anda menerima pesan kesalahan ini, coba boot ulang instans Anda. #### Kesalahan Shell: "perintah tidak ditemukan" Jika Anda menerima kesalahan ini, shell Anda tidak dapat menemukan AWS SAMCLI executable di jalur. Verifikasi lokasi direktori tempat Anda menginstal AWS SAMCLI executable, dan kemudian verifikasi bahwa direktori ada di jalur Anda. #### AWS SAMCLIerror: “/lib64/libc.so.6: versi `GLIBC\_2.14' tidak ditemukan (diperlukan oleh/.so.1)” usr/local/aws-sam-cli/dist/libz Jika Anda menerima kesalahan ini, Anda menggunakan versi Linux yang tidak didukung, dan versi glibc bawaan yang sudah kedaluwarsa. Coba salah satu dari langkah berikut: + Tingkatkan host Linux Anda ke versi 64-bit dari distribusi CentOS, Fedora, Ubuntu, atau Amazon Linux 2 terbaru. + Ikuti petunjuk untuk [Instal AWS SAMCLI](#install-sam-cli). ### macOS #### Instalasi gagal ![Gambar AWS SAMCLI penginstal yang menunjukkan pesan gagal penginstalan](http://docs.aws.amazon.com/id_id/serverless-application-model/latest/developerguide/images/sam-cli-troubleshoot-install-macos-install-failed.jpg) Jika Anda menginstal AWS SAMCLI untuk pengguna Anda dan memilih direktori instalasi yang Anda tidak memiliki izin menulis untuk, kesalahan ini dapat terjadi. Coba salah satu dari langkah berikut: 1. Pilih direktori instalasi lain yang Anda memiliki izin menulis untuk. 1. Hapus penginstal. Kemudian, unduh dan jalankan lagi. ## Langkah selanjutnya Untuk mempelajari lebih lanjut tentang AWS SAMCLI dan untuk mulai membangun aplikasi tanpa server Anda sendiri, lihat berikut ini: + [Tutorial: Menyebarkan aplikasi Hello World dengan AWS SAM](serverless-getting-started-hello-world.md)— Step-by-step instruksi untuk mengunduh, membangun, dan menyebarkan aplikasi tanpa server dasar. + [AWS SAM Lokakarya Lengkap](https://catalog.workshops.aws/complete-aws-sam/en-US) — Lokakarya yang dirancang untuk mengajari Anda banyak fitur utama yang AWS SAM menyediakan. + [AWS SAM contoh aplikasi dan pola](https://serverlessland.com/patterns?framework=AWS+SAM) - Contoh aplikasi dan pola dari penulis komunitas yang dapat Anda coba lebih lanjut.