翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS SAM CLI バージョンの管理
<a name="manage-sam-cli-versions"></a>

 AWS Serverless Application Model コマンドラインインターフェイス (AWS SAM CLI) のバージョンを管理するには、アップグレード、ダウングレード、アンインストールを行います。オプションで、 AWS SAM CLI のナイトリービルドをダウンロードしてインストールできます。

**Topics**
+ [AWS SAM CLI のアップグレード](#manage-sam-cli-versions-upgrade)
+ [AWS SAM CLI のアンインストール](#manage-sam-cli-versions-uninstall)
+ [Homebrew を使用する  AWS SAM CLI の管理から移行する](#manage-sam-cli-versions-switch)
+ [AWS SAM CLI ナイトリービルドを管理する](#manage-sam-cli-versions-nightly-build)
+ [pip を使用した仮想環境への AWS SAM CLI のインストール](#manage-sam-cli-versions-install-virtual)
+ [Homebrew で  AWS SAM CLI を管理する](#manage-sam-cli-versions-homebrew)
+ [トラブルシューティング](#manage-sam-cli-versions-troubleshoot)

## AWS SAM CLI のアップグレード
<a name="manage-sam-cli-versions-upgrade"></a>

### Linux
<a name="manage-sam-cli-versions-upgrade-linux"></a>

Linux で AWS SAM CLI をアップグレードするには、「[AWS SAM CLIのインストール](install-sam-cli.md#install-sam-cli-instructions)」のインストール手順に従ってください。ただし、次のように install コマンドに `--update` オプションを追加します。

```
sudo ./sam-installation/install --update
```

### macOS
<a name="manage-sam-cli-versions-upgrade-macos"></a>

は、インストールに使用したのと同じ方法でアップグレード AWS SAM CLIする必要があります。パッケージインストーラを使用して をインストールおよびアップグレードすることをお勧めします AWS SAM CLI。

 パッケージインストーラを使用して AWS SAM CLI をアップグレードするには、最新のパッケージバージョンをインストールします。手順については、「[AWS SAM CLIのインストール](install-sam-cli.md#install-sam-cli-instructions)」を参照してください。

### Server
<a name="manage-sam-cli-versions-upgrade-windows"></a>

をアップグレードするには AWS SAM CLI、 の Windows インストール手順[AWS SAM CLI のインストール](install-sam-cli.md)を繰り返します。

## AWS SAM CLI のアンインストール
<a name="manage-sam-cli-versions-uninstall"></a>

### Linux
<a name="manage-sam-cli-versions-uninstall-linux"></a>

 AWS SAM CLI を Linux でアンインストールするには、以下のコマンドを実行して、シンボリックリンクとインストールディレクトリを削除する必要があります。

1. シンボリックリンクとインストールパスを見つけます。
   + **which** コマンドを使用して、シンボリックリンクを検索します。

     ```
     which sam
     ```

     出力には、 AWS SAM バイナリが配置されているパスが表示されます。次に例を示します。

     ```
      /usr/local/bin/sam
     ```
   + **ls** コマンドを使用して、シンボリックリンクがポイントするディレクトリを検索します。

     ```
     ls -l /usr/local/bin/sam
     ```

     以下の例では、インストールディレクトリが `/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. シンボリックリンクを削除します。

   ```
   sudo rm /usr/local/bin/sam
   ```

1. インストールディレクトリを削除します。

   ```
   sudo rm -rf /usr/local/aws-sam-cli
   ```

### macOS
<a name="manage-sam-cli-versions-uninstall-macos"></a>

 AWS SAM CLI をインストールしたときと同じ方法でアンインストールします。パッケージインストーラを使用して をインストールすることをお勧めします AWS SAM CLI。

パッケージインストーラーを使用して AWS SAM CLI をインストールした場合は、次の手順でアンインストールします。

**AWS SAM CLI をアンインストールするには**

1.  以下を変更および実行して、 AWS SAM CLI プログラムを削除します。

   ```
   $ sudo rm -rf /path-to/aws-sam-cli
   ```

   1.  *sudo* — ユーザーが AWS SAM CLI プログラムがインストールされた場所への書き込み権限を持っている場合、**sudo** は必須ではありません。それ以外の場合、**sudo** が必要です。

   1.  *path-to* — AWS SAM CLI プログラムをインストールした場所へのパス。デフォルトの場所は `/usr/local` です。

1.  以下を変更して実行`$PATH`して、 AWS SAM CLI を削除します。

   ```
   $ sudo rm -rf /path-to-symlink-directory/sam
   ```

   1.  *sudo* — ユーザーが `$PATH` への書き込み権限を持っている場合、**sudo** は必須ではありません。それ以外の場合、**sudo** が必要です。

   1.  *path-to-symlink-directory* — `$PATH` の環境変数。デフォルトの場所は `/usr/local/bin` です。

1.  以下を実行して AWS SAM CLI がアンインストールされていることを確認します。

   ```
   $ sam --version
   command not found: sam
   ```

### Server
<a name="manage-sam-cli-versions-uninstall-windows"></a>

Windows の設定を使用して AWS SAM CLI をアンインストールするには、これらの手順を実行してください。

1. [スタート] メニューから、[プログラムの追加と削除] を検索します。

1. **[AWS SAM Command Line Interface]** という名前の結果を選択し、**[Uninstall]** (アンインストール) を選択してアンインストーラを起動します 。

1. をアンインストールすることを確認します AWS SAM CLI。

## Homebrew を使用する  AWS SAM CLI の管理から移行する
<a name="manage-sam-cli-versions-switch"></a>

Homebrew を使用して をインストールおよびアップグレードする場合は AWS SAM CLI、サポートされている メソッドを使用する AWS ことをお勧めします。サポートされている方法に切り替えるには、以下の手順に従ってください。

**Homebrew の使用からの移行方法**

1. [Homebrew インストールされた CLI AWS SAM のアンインストール](#manage-sam-cli-versions-homebrew-uninstall) のインストラクションに従い、Homebrew 管理のバージョンをアンインストールします。

1. [AWS SAM CLI のインストール](install-sam-cli.md) のインストラクションに従い、 AWS SAM  CLI をサポートされている方法でインストールします。

## AWS SAM CLI ナイトリービルドを管理する
<a name="manage-sam-cli-versions-nightly-build"></a>

 AWS SAM CLI ナイトリービルドをダウンロードしてインストールできます。ナイトリービルドには、実稼働バージョンよりも安定性が低い可能性があるプレリリースバージョンの AWS SAM CLI コードが含まれています。インストールされると、`sam-nightly` コマンドを使用したナイトリービルドを使用できるようになります。 AWS SAM CLI の実稼働ビルドとナイトリービルドは、両バージョンを同時にインストールして使用することが可能です。

**注記**  
ナイトリービルドには、プレリリースバージョンのビルドイメージは含まれません。そのため、**--use-container** オプションを使用してサーバーレスアプリケーションを構築すると、ビルドイメージの最新の実稼働バージョンが使用されます。

### AWS SAM CLI ナイトリービルドのインストール
<a name="manage-sam-cli-versions-nightly-build-install"></a>

 AWS SAM CLI ナイトリービルドをインストールするには、以下の手順に従ってください。

#### Linux
<a name="manage-sam-cli-versions-nightly-build-install-linux"></a>

パッケージインストーラーを使用して、Linux x86\$164 プラットフォームの  AWS SAM CLI ナイトリービルドバージョンをインストールできます。

**AWS SAM CLI ナイトリービルドをインストールするには**

1. aws-sam-cli GitHub リポジトリ内の [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/) から、パッケージインストーラーをダウンロードします。

1. [AWS SAM CLI をインストールする](install-sam-cli.md)の手順に従い、ナイトリービルドパッケージをインストールします。

#### macOS
<a name="manage-sam-cli-versions-nightly-build-install-macos"></a>

ナイトリービルドパッケージインストーラーを使用して、macOS の  AWS SAM CLI ナイトリービルドバージョンをインストールできます。

**AWS SAM CLI ナイトリービルドをインストールするには**

1. aws-sam-cli GitHub リポジトリ内の [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/) から、お使いのプラットフォーム用パッケージインストーラーをダウンロードします。

1. [AWS SAM CLI をインストールする](install-sam-cli.md)の手順に従い、ナイトリービルドパッケージをインストールします。

#### Server
<a name="manage-sam-cli-versions-nightly-build-windows"></a>

ナイトリービルドバージョンの AWS SAM CLI は、こちらのダウンロードリンクから利用できます: [AWS SAM CLI ナイトリービルド](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi)。Windows でナイトリービルドをインストールするには、「[AWS SAM CLI のインストール](install-sam-cli.md)」と同じ手順を実行しますが、代わりにナイトリービルドのダウンロードリンクを使用します。

ナイトリービルドバージョンがインストールされていることを確認するには、**sam-nightly --version** コマンドを実行します。このコマンドの出力は `1.X.Y.dev<YYYYMMDDHHmm>` 形式になります。以下はその例です。

```
SAM CLI, version 1.20.0.dev202103151200
```

### Homebrew からパッケージインストーラーに移行する
<a name="manage-sam-cli-versions-nightly-build-switch"></a>

Homebrew で  AWS SAM CLI ナイトリービルドのインストールとアップグレードを行っていて、パッケージインストーラーの使用に移行する場合は、この手順に従ってください。

**Homebrew からパッケージインストーラーに移行するには**

1. Homebrew でインストールした  AWS SAM CLI ナイトリービルドをアンインストールします。

   ```
   $ brew uninstall aws-sam-cli-nightly
   ```

1. 以下を実行して AWS SAM CLI ナイトリービルドがアンインストールされていることを確認します。

   ```
   $ sam-nightly --version
   zsh: command not found: sam-nightly
   ```

1. 前のセクションの手順に従って、 AWS SAM CLI ナイトリービルドをインストールします。

## pip を使用した仮想環境への AWS SAM CLI のインストール
<a name="manage-sam-cli-versions-install-virtual"></a>

ネイティブパッケージインストーラを使用して をインストールすることをお勧めします AWS SAM CLI。pip を使用する必要がある場合は、 AWS SAM CLI を仮想環境にインストールすることをお勧めします。これにより、クリーンなインストール環境と、隔離された環境 (エラーが発生した場合) を利用できます。

**注記**  
2023 年 10 月 24 日現在、 AWS SAM CLIは のサポートを中止していますPython 3.7。詳細については[AWS SAM CLI による Python 3.7 のサポートの終了](important-notes.md#important-notes-2023-10-python)を参照してください。

**仮想環境に AWS SAM CLI をインストールするには**

1. 任意の開始ディレクトリから仮想環境を作成し、名前を付けます。

------
#### [ Linux / macOS ]

   ```
   $ mkdir project
   $ cd project
   $ python3 -m venv venv
   ```

------
#### [ Server  ]

   ```
   > mkdir project
   > cd project
   > py -3 -m venv venv
   ```

------

1. 仮想環境をアクティブ化する

------
#### [ Linux / macOS ]

   ```
   $ . venv/bin/activate
   ```

   プロンプトが変わり、仮想環境がアクティブであることが示されます。

   ```
   (venv) $ 
   ```

------
#### [ Server  ]

   ```
   > venv\Scripts\activate
   ```

   プロンプトが変わり、仮想環境がアクティブであることが示されます。

   ```
   (venv) > 
   ```

------

1. 仮想環境に AWS SAM CLI をインストールします。

   ```
   (venv) $ pip install --upgrade aws-sam-cli
   ```

1.  AWS SAM CLI が正しくインストールされたことを確認します。

   ```
   (venv) $ sam --version
   SAM CLI, version 1.94.0
   ```

1. `deactivate` コマンドを使用して、仮想環境を終了できます。新しいセッションを開始するたびに、環境を再度アクティブ化する必要があります。

## Homebrew で  AWS SAM CLI を管理する
<a name="manage-sam-cli-versions-homebrew"></a>

**注記**  
2023 年 9 月以降、 AWS は () の AWS AWS SAM CLIマネージドHomebrewインストーラーを維持しなくなります`aws/tap/aws-sam-cli`。Homebrew を引き続き使用するには、コミュニティ管理のインストーラーを使用します (`aws-sam-cli`)。2023 年 9 月以降、`aws/tap/aws-sam-cli` を参照する Homebrew は `aws-sam-cli` にリダイレクトします。  
私たちがサポートしている[インストール](install-sam-cli.md)と[アップグレード](#manage-sam-cli-versions-upgrade)の使用をおすすめします。

### Homebrew を使用した AWS SAM CLI のインストール
<a name="manage-sam-cli-versions-homebrew-install"></a>

**注記**  
これらの手順では、コミュニティマネージド AWS SAM CLIHomebrewインストーラを使用します。追加のサポートについては、*「[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)」リポジトリ*を参照してください。

**AWS SAM CLI をインストールするには**

1. 下記を実行します。

   ```
   $ brew install aws-sam-cli
   ```

1. インストールを確認します。

   ```
   $ sam --version
   ```

   が正常にインストールされると AWS SAM CLI、次のような出力が表示されます。

   ```
   SAM CLI, version 1.94.0
   ```

### Homebrew を使用した AWS SAM CLI のアップグレード
<a name="manage-sam-cli-versions-homebrew-upgrade"></a>

Homebrew を使用して AWS SAM CLI をアップグレードするには、以下のコマンドを実行します。

```
$ brew upgrade aws-sam-cli
```

### Homebrew インストールされた CLI AWS SAM のアンインストール
<a name="manage-sam-cli-versions-homebrew-uninstall"></a>

 AWS SAM CLI を Homebrew でインストールしていた場合は、次の手順に従ってアンインストールします。

**AWS SAM CLI をアンインストールするには**

1. 下記を実行します。

   ```
   $ brew uninstall aws-sam-cli
   ```

1. 以下を実行して AWS SAM CLI がアンインストールされていることを確認します。

   ```
   $ sam --version
   command not found: sam
   ```

### コミュニティ管理の Homebrew インストーラーに移行する
<a name="manage-sam-cli-versions-homebrew-switch"></a>

 AWS マネージドHomebrewインストーラ (`aws/tap/aws-sam-cli`) を使用していて、引き続き を使用する場合はHomebrew、コミュニティマネージドHomebrewインストーラ () に切り替えることをお勧めします`aws-sam-cli`。

1 つのコマンドで切り替えるには、以下を実行します。

```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```

以下の手順に従って、各コマンドを個別に実行してください。

**コミュニティ管理の Homebrew インストーラーに移行するには**

1. の AWS マネージドHomebrewバージョンをアンインストールします AWS SAM CLI。

   ```
   $ brew uninstall aws-sam-cli
   ```

1.  AWS SAM CLI がアンインストールされたことを確認します。

   ```
   $ which sam
   sam not found
   ```

1.  AWS マネージド AWS SAM CLIタップを削除します。

   ```
   $ brew untap aws/tap
   ```

   次のようなエラーが表示された場合は、`--force` オプションを選択し、もう一度試してください。

   ```
   Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
   aws-sam-cli-nightly
   ```

1.  AWS マネージドインストーラのキャッシュされたファイルを削除します。

   ```
   $ brew cleanup aws/tap
   ```

1. Homebrew およびすべてのフォーミュラを更新します:

   ```
   $ brew update
   ```

1. コミュニティマネージドバージョンの をインストールします AWS SAM CLI。

   ```
   $ brew install aws-sam-cli
   ```

1.  AWS SAM CLI のインストールに成功したことを確認します。

   ```
   $ sam --version
   SAM CLI, version 1.94.0
   ```

## トラブルシューティング
<a name="manage-sam-cli-versions-troubleshoot"></a>

のインストール時または使用時にエラーが発生した場合は AWS SAM CLI、「」を参照してください[AWS SAMCLI トラブルシューティング](sam-cli-troubleshooting.md)。