**このドキュメントはバージョン 1 の AWS CLI のみを対象としています。**

AWS CLI バージョン 1 のサポート終了を発表しました。AWS CLI バージョン 2 に移行することをお勧めします。日付、その他の詳細、移行方法については、「[お知らせ](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)」を参照してください。AWS CLI のバージョン 2 に関連するドキュメントについては、[バージョン 2 用ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)を参照してください。

# Installing and updating the AWS CLI version 1 in a virtual environment
<a name="install-virtualenv"></a>

仮想環境に `pip` (AWS Command Line Interface) のバージョン 1 をインストールすることで、他の AWS CLI パッケージとのバージョンに関する要件の競合を回避できます。

**Topics**
+ [前提条件](#install-virtualenv-prereqs)
+ [仮想環境での AWS CLI バージョン 1 のインストールと更新](#install-virtualenv-install)
+ [AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング](#install-virtualenv-tshoot)

## 前提条件
<a name="install-virtualenv-prereqs"></a>
+ Python 3.8 以降。インストール手順については、Python の *Beginner Guide* で「[Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download)」ページを参照してください。

  **Python バージョンのサポートマトリックス**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cli/v1/userguide/install-virtualenv.html)
+ `pip` または `pip3` がインストールされています。

## 仮想環境での AWS CLI バージョン 1 のインストールと更新
<a name="install-virtualenv-install"></a>

1. `virtualenv` を使用して `pip` をインストールします。

   ```
   $ pip install --user virtualenv
   ```

1. 仮想環境を作成して名前を付けます。

   ```
   $ virtualenv ~/cli-ve
   ```

   または、`-p` オプションを使用してデフォルト以外のバージョンの Python を指定できます。

   ```
   $ virtualenv -p /usr/bin/python37 ~/cli-ve
   ```

1. 新しい仮想環境をアクティブ化します。

   **Linux または macOS**

   ```
   $ source ~/cli-ve/bin/activate
   ```

   **Windows**:

   ```
   $ %USERPROFILE%\cli-ve\Scripts\activate
   ```

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

   ```
   (cli-ve)~$
   ```

1. 仮想環境で AWS CLI バージョン 1 をインストールまたは更新します。

   ```
   (cli-ve)~$ pip install --upgrade awscli
   ```

1. AWS CLI バージョン 1 が正しくインストールされていることを確認します。

   ```
   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
   ```

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

## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
<a name="install-virtualenv-tshoot"></a>

AWS CLI をインストールまたはアンインストールした後に問題が発生した場合のトラブルシューティングステップについては、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。最も関連性の高いトラブルシューティングステップについては、「[コマンドが見つからないエラー](cli-chap-troubleshooting.md#tshoot-install-not-found)」、「[「`aws --version`」コマンドが、インストールしたのとは異なるバージョンを返す](cli-chap-troubleshooting.md#tshoot-install-wrong-version)」、および「[AWS CLI のアンインストール後に、「`aws --version`」コマンドがバージョンを返す](cli-chap-troubleshooting.md#tshoot-uninstall-1)」を参照してください。