Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Instal AWS SAM CLI
Instal rilis terbaru AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) pada sistem operasi yang didukung dengan mengikuti instruksi di Langkah 1: Instal AWS CLI.
Untuk informasi tentang mengelola versi yang saat ini diinstal AWS SAM CLI, termasuk cara memutakhirkan, menghapus instalasi, atau mengelola build malam hari, lihat Mengelola AWS SAMCLI versi.
Apakah ini pertama kalinya Anda menginstal AWS SAM CLI?
Selesaikan semua prasyarat di bagian sebelumnya sebelum bergerak maju. Hal ini mencakup:
-
Mendaftar untuk AWS akun.
-
Menyiapkan akses aman ke AWS.
-
Memasang AWS CLI.
-
Mengonfigurasi AWS kredenSIAL.
Menginstal AWS SAM CLI
Mulai September 2023, AWS Tidak akan lagi mempertahankan AWS dikelola Homebrew penginstal untuk AWS SAM CLI (aws/tap/aws-sam-cli). Jika Anda menggunakan Homebrew untuk menginstal dan mengelola AWS SAM CLI, lihat opsi berikut:
-
Untuk terus menggunakan Homebrew, Anda dapat menggunakan penginstal yang dikelola komunitas. Untuk informasi selengkapnya, lihat Mengelola AWS SAMCLI dengan Homebrew.
-
Sebaiknya gunakan salah satu metode instalasi pihak pertama yang didokumentasikan di halaman ini. Sebelum menggunakan salah satu metode ini, lihat Beralih dari Homebrew.
-
Untuk detail tambahan, lihat Versi rilis: 1.121.0.
Untuk menginstal AWS SAM CLI, ikuti instruksi untuk sistem operasi Anda.
- x86_64 - command line installer
-
-
Unduh AWS SAM CLI berkas.zip ke direktori pilihan Anda.
-
(Opsional) Anda dapat memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat Opsional: Verifikasi integritas AWS SAM CLI installer.
-
Buka zip file instalasi ke direktori pilihan Anda. Berikut ini adalah contoh, menggunakan sam-installation subdirektori.
Gunakan ekuivalen jika sistem pengoperasian Anda tidak memiliki perintah unzip.
$ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
-
Instal AWS SAM CLI dengan menjalankan install dapat dieksekusi. Dapat dieksekusi ini terletak di direktori yang digunakan pada langkah sebelumnya. Berikut ini adalah contoh, menggunakan sam-installation subdirektori:
$ sudo ./sam-installation/install
-
Verifikasi instalasi.
$ sam --version
Untuk mengonfirmasi penginstalan yang berhasil, Anda akan melihat output yang menggantikan teks tanda kurung berikut dengan versi terbaru yang tersedia:
SAM CLI, <latest version>
- arm64 - command line installer
-
-
Unduh AWS SAM CLI berkas.zip ke direktori pilihan Anda.
-
(Opsional) Anda dapat memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat Opsional: Verifikasi integritas AWS SAM CLI installer.
-
Buka zip file instalasi ke direktori pilihan Anda. Berikut ini adalah contoh, menggunakan sam-installation subdirektori.
Gunakan ekuivalen jika sistem pengoperasian Anda tidak memiliki perintah unzip.
$ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
-
Instal AWS SAM CLI dengan menjalankan install dapat dieksekusi. Dapat dieksekusi ini terletak di direktori yang digunakan pada langkah sebelumnya. Berikut ini adalah contoh, menggunakan sam-installation subdirektori:
$ sudo ./sam-installation/install
-
Verifikasi instalasi.
$ sam --version
Untuk mengonfirmasi penginstalan yang berhasil, Anda harus melihat output seperti berikut tetapi yang menggantikan teks tanda kurung dengan versi SAM CLI terbaru:
SAM CLI, <latest version>
Langkah-langkah instalasi
Gunakan penginstal paket untuk menginstal AWS SAM CLI. Selain itu, penginstal paket memiliki dua metode instalasi yang dapat Anda pilih: GUI dan Baris perintah. Anda dapat menginstal untuk semua pengguna atau hanya milikmu pengguna saat ini. Untuk menginstal untuk semua pengguna, otorisasi superuser diperlukan.
AWS SAM CLI tidak mendukung versi macOS yang lebih lama dari macOS 13.x. Tingkatkan ke versi macOS yang didukung atau instal AWS SAM CLI dengan Homebrew.
- GUI - All users
-
Untuk mengunduh penginstal paket dan menginstal AWS SAM CLI
Jika sebelumnya Anda menginstal AWS SAM CLI lewat Homebrew atau pip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat Menghapus instalasi AWS SAMCLI.
-
Unduh macOS pkg ke direktori pilihan Anda:
-
Jalankan file yang Anda unduh dan ikuti instruksi di layar untuk melanjutkan melalui Pendahuluan, Baca Saya, dan Lisensi langkah.
-
Untuk Pilih Tujuan, pilih Instal untuk semua pengguna komputer ini.
-
Untuk Jenis Instalasi, pilih di mana AWS SAM CLI akan dipasang dan tekan Instal. Lokasi default yang disarankan adalah /usr/local/aws-sam-cli.
Untuk memanggil AWS SAM CLI dengan sam perintah, installer secara otomatis membuat symlink antara /usr/local/bin/sam dan juga /usr/local/aws-sam-cli/sam atau folder instalasi yang Anda pilih.
-
The AWS SAM CLI akan menginstal dan Instalasi berhasil Pesan akan ditampilkan. Tekan Tutup.
Untuk memverifikasi penginstalan yang berhasil
-
Verifikasi bahwa AWS SAM CLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- GUI - Current user
-
Untuk mengunduh dan menginstal AWS SAM CLI
Jika sebelumnya Anda menginstal AWS SAM CLI lewat Homebrew atau pip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat Menghapus instalasi AWS SAMCLI.
-
Unduh macOS pkg ke direktori pilihan Anda:
-
Jalankan file yang Anda unduh dan ikuti instruksi di layar untuk melanjutkan melalui Pendahuluan, Baca Saya, dan Lisensi langkah.
-
Untuk Pilih Tujuan, pilih Instal hanya untuk saya. Jika Anda tidak melihat opsi ini, lanjutkan ke langkah berikutnya.
-
Untuk Jenis Instalasi, lakukan hal berikut:
-
Pilih di mana AWS SAM CLI akan dipasang. Lokasi default adalah /usr/local/aws-sam-cli. Pilih lokasi tempat Anda memiliki izin menulis. Untuk mengubah lokasi instalasi, pilih setempat dan pilih lokasi Anda. Tekan Lanjutkan ketika selesai.
-
Jika Anda tidak mendapatkan opsi untuk memilih Instal hanya untuk saya pada langkah sebelumnya, pilih Ubah Lokasi Pemasangan > Instal hanya untuk saya dan tekan Lanjutkan.
-
Tekan Instal.
-
The AWS SAM CLI akan menginstal dan Instalasi berhasil Pesan akan ditampilkan. Tekan Tutup.
Untuk membuat symlink
-
Untuk memanggil AWS SAM CLI dengan sam perintah, Anda harus secara manual membuat symlink antara AWS SAM CLI Program dan 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 ke $PATH, sudo tidak diperlukan. Sebaliknya, sudo diperlukan.
-
path-to — Jalur ke tempat Anda menginstal AWS SAM CLI program. Misalnya, /Users/myUser/Desktop.
-
path-to-symlink-directory — Anda $PATH variabel lingkungan. Lokasi default adalah /usr/local/bin.
Untuk memverifikasi penginstalan yang berhasil
-
Verifikasi bahwa AWS SAM CLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - All users
-
Untuk mengunduh dan menginstal AWS SAM CLI
Jika sebelumnya Anda menginstal AWS SAM CLI lewat Homebrew atau pip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat Menghapus instalasi AWS SAMCLI.
-
Unduh macOS pkg ke direktori pilihan Anda:
-
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.
Untuk memanggil AWS SAM CLI dengan sam perintah, installer secara otomatis membuat symlink antara /usr/local/bin/sam dan /usr/local/aws-sam-cli/sam.
Untuk memverifikasi penginstalan yang berhasil
-
Verifikasi bahwa AWS SAM CLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - Current user
-
Untuk mengunduh dan menginstal AWS SAM CLI
Jika sebelumnya Anda menginstal AWS SAM CLI lewat Homebrew atau pip, Anda harus menghapusnya terlebih dahulu. Untuk petunjuk, lihat Menghapus instalasi AWS SAMCLI.
-
Unduh macOS pkg ke direktori pilihan Anda:
-
Tentukan direktori instalasi tempat Anda memiliki izin menulis. Kemudian, buat xml berkas menggunakan template dan memodifikasinya untuk mencerminkan direktori instalasi Anda. Direktori harus sudah ada.
Misalnya, jika Anda mengganti path-to-my-directory bersama /Users/myUser/Desktop, aws-sam-cli folder program akan diinstal di sana.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<array>
<dict>
<key>choiceAttribute</key>
<string>customLocation</string>
<key>attributeSetting</key>
<string>path-to-my-directory</string>
<key>choiceIdentifier</key>
<string>default</string>
</dict>
</array>
</plist>
-
Simpan xml arsipkan 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 SAM CLI program.
-
Jalankan yang berikut ini untuk menginstal AWS SAM CLI:
$ 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 memanggil AWS SAM CLI dengan sam perintah, Anda harus secara manual membuat symlink antara AWS SAM CLI Program dan 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 ke $PATH, sudo tidak diperlukan. Sebaliknya, sudo diperlukan.
-
path-to — Jalur ke tempat Anda menginstal AWS SAM CLI program. Misalnya, /Users/myUser/Desktop.
-
path-to-symlink-directory — Anda $PATH variabel lingkungan. Lokasi default adalah /usr/local/bin.
Untuk memverifikasi penginstalan yang berhasil
-
Verifikasi bahwa AWS SAM CLI telah diinstal dengan benar dan symlink Anda dikonfigurasi dengan menjalankan:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
File Penginstal Windows (MSI) merupakan file penginstal paket untuk sistem pengoperasian Windows.
Ikuti langkah-langkah ini untuk menginstal AWS SAM CLI menggunakan file MSI.
-
Unduh AWS SAM CLI 64-bit.
-
(Opsional) Anda dapat memverifikasi integritas penginstal sebelum instalasi. Untuk petunjuk, lihat Opsional: Verifikasi integritas AWS SAM CLI installer.
-
Verifikasi instalasi.
Setelah menyelesaikan instalasi, verifikasi dengan membuka command prompt baru atau PowerShell cepat. Anda harus dapat memanggil sam dari baris perintah.
sam --version
Setelah instalasi berhasil AWS SAM CLI, Anda akan melihat output seperti berikut:
SAM CLI, <latest version>
-
Aktifkan jalur panjang (hanya Windows 10 dan yang lebih baru).
The AWS SAM CLI mungkin berinteraksi dengan filepath yang melebihi batasan jalur maks Windows. Ini dapat menyebabkan kesalahan saat menjalankan sam init karena Windows 10 MAX_PATH keterbatasan. Untuk mengatasi masalah ini, perilaku jalur panjang baru harus dikonfigurasi.
Untuk mengaktifkan jalur panjang, lihat Aktifkan Jalur Panjang di Windows 10, Versi 1607, dan Lebih Baru di Dokumentasi Pengembangan Aplikasi Microsoft Windows.
-
Instal Git.
Anda juga harus menginstal Git untuk mengunduh aplikasi contoh menggunakan perintah sam init. Untuk instruksi, lihat Menginstal 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 SAM CLI dapat dieksekusi di jalur. Verifikasi lokasi direktori tempat Anda menginstal AWS SAM CLI dapat dieksekusi, dan kemudian verifikasi bahwa direktori ada di jalur Anda.
AWS SAM CLI kesalahan: “/lib64/libc.so.6: versi `GLIBC_2.14' tidak ditemukan (diperlukan oleh/usr/local/aws-sam-cli/dist/libz.so.1)”
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 SAM CLI.
macOS
Instalasi gagal
Jika Anda menginstal AWS SAM CLI untuk pengguna Anda dan memilih direktori instalasi yang Anda tidak memiliki izin penulisan, kesalahan ini dapat terjadi. Coba salah satu dari langkah berikut:
-
Pilih direktori instalasi yang berbeda yang memiliki izin penulisan.
-
Hapus penginstal. Kemudian, unduh dan jalankan lagi.
Langkah berikutnya
Untuk mempelajari lebih lanjut tentang AWS SAM CLI dan untuk mulai membangun aplikasi tanpa server Anda sendiri, lihat yang berikut ini: