Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola AWS SAMCLI versi
Kelola versi AWS Serverless Application Model Command Line Interface (AWS SAMCLI) Anda melalui upgrade, downgrade, dan uninstall. Secara opsional, Anda dapat mengunduh dan menginstal build AWS SAMCLI malam.
**Topics**
+ [
## Upgrade AWS SAMCLI
](#manage-sam-cli-versions-upgrade)
+ [
## Menghapus instalasi AWS SAMCLI
](#manage-sam-cli-versions-uninstall)
+ [
## Beralih dari menggunakan Homebrew untuk mengelola AWS SAMCLI
](#manage-sam-cli-versions-switch)
+ [
## Mengelola AWS SAMCLI pembangunan malam
](#manage-sam-cli-versions-nightly-build)
+ [
## Memasang AWS SAMCLI ke dalam lingkungan virtual menggunakan pip
](#manage-sam-cli-versions-install-virtual)
+ [
## Mengelola AWS SAMCLI dengan Homebrew
](#manage-sam-cli-versions-homebrew)
+ [
## Pemecahan masalah
](#manage-sam-cli-versions-troubleshoot)
## Upgrade AWS SAMCLI
### Linux
Untuk memutakhirkan AWS SAMCLI di Linux, ikuti petunjuk penginstalan di[Memasang AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions), tetapi tambahkan `--update` opsi ke perintah instal, sebagai berikut:
```
sudo ./sam-installation/install --update
```
### macOS
AWS SAMCLIHarus ditingkatkan melalui metode yang sama yang digunakan untuk menginstalnya. Kami menyarankan Anda menggunakan penginstal paket untuk menginstal dan meningkatkan. AWS SAMCLI
Untuk meng-upgrade AWS SAMCLI menggunakan installer paket, instal versi paket terbaru. Untuk petunjuk, lihat [Memasang AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions).
### Windows
Untuk memutakhirkan AWS SAMCLI, ulangi langkah instalasi Windows [Instal AWS SAMCLI](install-sam-cli.md) lagi.
## Menghapus instalasi AWS SAMCLI
### Linux
Untuk menghapus instalasi AWS SAMCLI di Linux, Anda harus menghapus direktori symlink dan instalasi dengan menjalankan perintah berikut:
1. Temukan symlink dan instal jalur.
+ Temukan symlink menggunakan perintah **which**:
```
which sam
```
Output menunjukkan jalur tempat AWS SAM binari berada, misalnya:
```
/usr/local/bin/sam
```
+ Temukan direktori yang diarahkan symlink untuk menggunakan perintah **ls**:
```
ls -l /usr/local/bin/sam
```
Pada contoh berikut, direktori instalasi adalah `/usr/local/aws-sam-cli`.
```
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
```
1. Hapus symlink.
```
sudo rm /usr/local/bin/sam
```
1. Hapus direktori instalasi.
```
sudo rm -rf /usr/local/aws-sam-cli
```
### macOS
Copot pemasangan AWS SAMCLI melalui metode yang sama yang digunakan untuk menginstalnya. Kami menyarankan Anda menggunakan penginstal paket untuk menginstal. AWS SAMCLI
Jika Anda menginstal AWS SAMCLI menggunakan penginstal paket, ikuti langkah-langkah ini untuk menghapus instalasi.
**Untuk menghapus instalasi AWS SAMCLI**
1. Hapus AWS SAMCLI program dengan memodifikasi dan menjalankan yang berikut:
```
$ sudo rm -rf /path-to/aws-sam-cli
```
1. *sudo*— Jika pengguna Anda memiliki izin menulis ke tempat AWS SAMCLI program diinstal, tidak **sudo** diperlukan. Sebaliknya, **sudo** diperlukan.
1. */path-to*— Jalur ke tempat Anda menginstal AWS SAMCLI program. Lokasi default adalah `/usr/local`.
1. Hapus AWS SAMCLI `$PATH` dengan memodifikasi dan menjalankan yang berikut:
```
$ sudo rm -rf /path-to-symlink-directory/sam
```
1. *sudo*— Jika pengguna Anda memiliki izin menulis`$PATH`, tidak **sudo** diperlukan. Sebaliknya, **sudo** diperlukan.
1. *path-to-symlink-directory*- Variabel `$PATH` lingkungan Anda. Lokasi default adalah `/usr/local/bin`.
1. Verifikasi bahwa telah AWS SAMCLI dihapus instalasinya dengan menjalankan yang berikut:
```
$ sam --version
command not found: sam
```
### Windows
Untuk menghapus instalasi AWS SAMCLI menggunakan Pengaturan Windows, ikuti langkah-langkah ini:
1. Dari menu Mulai, cari "Tambah atau hapus program".
1. Pilih hasil bernama **AWS SAM Command Line Interface**, lalu pilih **Uninstall** untuk meluncurkan uninstaller.
1. Konfirmasikan bahwa Anda ingin menghapus instalasi. AWS SAMCLI
## Beralih dari menggunakan Homebrew untuk mengelola AWS SAMCLI
Jika Anda menggunakan Homebrew untuk menginstal dan meningkatkan AWS SAMCLI, kami sarankan menggunakan metode yang AWS didukung. Ikuti petunjuk ini untuk beralih ke metode yang didukung.
**Untuk beralih dari menggunakan Homebrew**
1. Ikuti instruksi di [Menghapus instalasi CLI yang Homebrew diinstal AWS SAM](#manage-sam-cli-versions-homebrew-uninstall) untuk menghapus instalasi versi Homebrew terkelola.
1. Ikuti petunjuk di [Instal AWS SAMCLI](install-sam-cli.md) untuk menginstal AWS SAM CLI menggunakan metode yang didukung.
## Mengelola AWS SAMCLI pembangunan malam
Anda dapat mengunduh dan menginstal AWS SAMCLI build malam. Ini berisi versi pra-rilis AWS SAMCLI kode yang mungkin kurang stabil daripada versi produksi. Saat diinstal, Anda dapat menggunakan nightly build dengan perintah. `sam-nightly` Anda dapat menginstal dan menggunakan versi produksi dan pembuatan malam secara AWS SAMCLI bersamaan.
**catatan**
Nightly build tidak berisi versi prarilis dari image build. Karena itu, membangun aplikasi tanpa server Anda dengan **--use-container** opsi menggunakan versi produksi terbaru dari image build.
### Memasang AWS SAMCLI build malam
Untuk menginstal build AWS SAMCLI malam, ikuti petunjuk ini.
#### Linux
Anda dapat menginstal versi nightly build AWS SAMCLI pada platform Linux x86\$164 menggunakan penginstal paket.
**Untuk menginstal AWS SAMCLI build malam**
1. Unduh penginstal paket dari [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)dalam *aws-sam-cli GitHubrepositori*.
1. Ikuti langkah-langkah untuk [menginstal paket AWS SAMCLI](install-sam-cli.md) nightly build.
#### macOS
Anda dapat menginstal versi nightly build dari AWS SAMCLI onmacOS, menggunakan penginstal paket nightly build.
**Untuk menginstal AWS SAMCLI build malam**
1. Unduh penginstal paket untuk platform Anda dari [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)dalam *aws-sam-cli GitHubrepositori*.
1. Ikuti langkah-langkah untuk [menginstal paket AWS SAMCLI](install-sam-cli.md) nightly build.
#### Windows
Versi build malam tersedia dengan tautan unduhan ini: [AWS SAMCLInightly](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi) build. AWS SAMCLI Untuk menginstal nightly build di Windows, lakukan langkah yang sama seperti di[Instal AWS SAMCLI](install-sam-cli.md), tetapi gunakan tautan unduhan build malam sebagai gantinya.
Untuk memverifikasi bahwa Anda telah menginstal versi build malam, jalankan perintah. **sam-nightly --version** Output dari perintah ini ada dalam bentuk `1.X.Y.dev`, misalnya:
```
SAM CLI, version 1.20.0.dev202103151200
```
### Beralih dari Homebrew ke penginstal paket
Jika Anda menggunakan Homebrew untuk menginstal dan memutakhirkan build AWS SAMCLI malam dan ingin beralih menggunakan penginstal paket, ikuti langkah-langkah ini.
**Untuk beralih dari Homebrew ke installer paket**
1. Copot pemasangan build AWS SAMCLI malam yang Homebrew diinstal.
```
$ brew uninstall aws-sam-cli-nightly
```
1. Verifikasi bahwa AWS SAMCLI nightly build dihapus instalasinya dengan menjalankan yang berikut:
```
$ sam-nightly --version
zsh: command not found: sam-nightly
```
1. Ikuti langkah-langkah di bagian sebelumnya untuk menginstal AWS SAMCLI nightly build.
## Memasang AWS SAMCLI ke dalam lingkungan virtual menggunakan pip
Kami merekomendasikan menggunakan installer paket asli untuk menginstal file. AWS SAMCLI Jika Anda harus menggunakanpip, kami sarankan Anda menginstal AWS SAMCLI ke dalam lingkungan virtual. Ini memastikan lingkungan instalasi yang bersih dan lingkungan yang terisolasi jika terjadi kesalahan.
**catatan**
Pada 24 Oktober 2023, AWS SAM CLI sedang menghentikan dukungan untuk. Python 3.7 Untuk mempelajari selengkapnya, lihat [AWS SAMCLImenghentikan dukungan untuk Python 3.7](important-notes.md#important-notes-2023-10-python).
**Untuk menginstal AWS SAMCLI ke dalam lingkungan virtual**
1. Dari direktori awal pilihan Anda, buat lingkungan virtual dan beri nama.
------
#### [ Linux / macOS ]
```
$ mkdir project
$ cd project
$ python3 -m venv venv
```
------
#### [ Windows ]
```
> mkdir project
> cd project
> py -3 -m venv venv
```
------
1. Aktifkan lingkungan virtual
------
#### [ Linux / macOS ]
```
$ . venv/bin/activate
```
Perubahan prompt untuk menunjukkan kepada Anda bahwa lingkungan virtual Anda aktif.
```
(venv) $
```
------
#### [ Windows ]
```
> venv\Scripts\activate
```
Perubahan prompt untuk menunjukkan kepada Anda bahwa lingkungan virtual Anda aktif.
```
(venv) >
```
------
1. Instal AWS SAMCLI ke dalam lingkungan virtual Anda.
```
(venv) $ pip install --upgrade aws-sam-cli
```
1. Verifikasi bahwa AWS SAMCLI sudah diinstal dengan benar.
```
(venv) $ sam --version
SAM CLI, version 1.94.0
```
1. Anda dapat menggunakan perintah `deactivate` untuk keluar dari lingkungan virtual. Setiap kali Anda memulai sesi baru, Anda harus mengaktifkan kembali lingkungan.
## Mengelola AWS SAMCLI dengan Homebrew
**catatan**
Mulai September 2023, tidak AWS akan lagi mempertahankan Homebrew installer AWS terkelola untuk AWS SAMCLI ()`aws/tap/aws-sam-cli`. Untuk terus menggunakanHomebrew, Anda dapat menggunakan penginstal terkelola komunitas (`aws-sam-cli`). Mulai September 2023, Homebrew perintah apa pun yang `aws/tap/aws-sam-cli` akan dialihkan ke referensi. `aws-sam-cli`
Kami menyarankan Anda menggunakan metode [instalasi](install-sam-cli.md) dan [peningkatan](#manage-sam-cli-versions-upgrade) yang didukung kami.
### Instalasi AWS SAMCLI menggunakan Homebrew
**catatan**
Petunjuk ini menggunakan AWS SAMCLI Homebrew penginstal yang dikelola komunitas. Untuk dukungan lebih lanjut, lihat repositori *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)*.
**Untuk menginstal AWS SAMCLI**
1. Jalankan hal berikut:
```
$ brew install aws-sam-cli
```
1. Verifikasi instalasi:
```
$ sam --version
```
Setelah instalasi berhasil AWS SAMCLI, Anda akan melihat output seperti berikut:
```
SAM CLI, version 1.94.0
```
### Upgrade menggunakan AWS SAMCLI Homebrew
Untuk meningkatkan AWS SAMCLI penggunaanHomebrew, jalankan perintah berikut:
```
$ brew upgrade aws-sam-cli
```
### Menghapus instalasi CLI yang Homebrew diinstal AWS SAM
Jika diinstal menggunakanHomebrew, ikuti langkah-langkah ini untuk menghapus instalannya. AWS SAMCLI
**Untuk menghapus instalasi AWS SAMCLI**
1. Jalankan hal berikut:
```
$ brew uninstall aws-sam-cli
```
1. Verifikasi bahwa telah AWS SAMCLI dihapus instalasinya dengan menjalankan yang berikut:
```
$ sam --version
command not found: sam
```
### Beralih ke Homebrew penginstal terkelola komunitas
Jika Anda menggunakan Homebrew installer AWS terkelola (`aws/tap/aws-sam-cli`) dan memilih untuk terus menggunakanHomebrew, sebaiknya beralih ke Homebrew installer terkelola komunitas ()`aws-sam-cli`.
Untuk beralih dalam satu perintah, jalankan yang berikut ini:
```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```
Ikuti petunjuk ini untuk menjalankan setiap perintah satu per satu.
**Untuk beralih ke Homebrew penginstal terkelola komunitas**
1. Copot pemasangan Homebrew versi AWS terkelola dari AWS SAMCLI:
```
$ brew uninstall aws-sam-cli
```
1. Verifikasi bahwa AWS SAMCLI telah dihapus instalasinya:
```
$ which sam
sam not found
```
1. Hapus AWS SAMCLI ketukan AWS terkelola:
```
$ brew untap aws/tap
```
Jika Anda menerima kesalahan seperti berikut ini, tambahkan `--force` opsi dan coba lagi.
```
Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
aws-sam-cli-nightly
```
1. Hapus file cache untuk installer AWS terkelola:
```
$ brew cleanup aws/tap
```
1. Perbarui Homebrew dan semua rumus:
```
$ brew update
```
1. Instal versi terkelola komunitas dari AWS SAMCLI:
```
$ brew install aws-sam-cli
```
1. Verifikasi AWS SAMCLI bahwa berhasil diinstal:
```
$ sam --version
SAM CLI, version 1.94.0
```
## Pemecahan masalah
Jika Anda menemukan kesalahan saat menginstal atau menggunakan AWS SAMCLI, lihat[AWS SAMCLIpemecahan masalah](sam-cli-troubleshooting.md).