macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール - AWS Command Line Interface
前提条件バンドルされたインストーラを使用したインストールとアンインストールpip を使用したインストールと更新AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング

このドキュメントはバージョン 1 の AWS CLI のみを対象としています。AWS CLI のバージョン 2 に関連するドキュメントについては、バージョン 2 用ユーザーガイドを参照してください。

macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール

AWS Command Line Interface (AWS CLI) バージョン 1 とその依存関係を macOS にインストールするには、バンドルされたインストーラまたは pip を使用します。

前提条件

macOS に AWS CLI バージョン 1 をインストールする前に、Python 3.8 以降がインストールされていることを確認してください。インストール手順については、Python の Beginner Guide で「Downloading Python」ページを参照してください。

Python バージョンのサポートマトリックス

AWS CLI バージョン サポートされている Python のバージョン
1.39.0～最新 Python 3.9 以上
1.32.0～1.38.38 Python 3.8 以上
1.27.0 – 1.31.x Python 3.7 以上
1.20.0 – 1.26.x Python 3.6 以上
1.19.0 – 1.19.x Python 2.7 以上、Python 3.6 以上
1.17 — 1.18.x Python 2.7 以上、Python 3.4 以上
1.0 — 1.16.x Python 2.6 以上、Python 3.3 以上

バンドルされたインストーラを使用した macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール

Linux または macOS では、バンドルされたインストーラを使用して AWS Command Line Interface (AWS CLI) のバージョン 1 をインストールできます。バンドルされたインストーラにはすべての依存関係が含まれており、オフラインで使用できます。

バンドルされたインストーラでは、スペースを含むパスへのインストールはサポートされていません。

sudo を使用したバンドルされたインストーラでの AWS CLI バージョン 1 のインストール

次の手順では、macOS の任意のビルドに、コマンドラインから AWS CLI バージョン 1 をインストールできます。

以下は、単一のコマンドセットとしてカットアンドペーストして実行できるコマンドのインストールの概要を示しています。

AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が awscli-bundle-1.16.312.zip になるため、コマンドは以下のようになります。

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
バンドルされたインストーラを使用して AWS CLI バージョン 1 をインストールする

  1. 次のいずれかの方法で、AWS CLI バージョン 1 のバンドルされたインストーラをダウンロードします。

    • curl コマンドを使用してダウンロードします。

      AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が awscli-bundle-1.16.312.zip になるため、コマンドは以下のようになります。

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"

    • 直接リンクを使用してダウンロードします。

      最新バージョンの AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が awscli-bundle-1.16.312.zip になるため、URL が https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip になります

  2. パッケージからファイルを抽出 (解凍) します。unzip がない場合は、macOS ディストリビューションに組み込まれたパッケージマネージャーを使用してインストールします。

    $ unzip awscli-bundle.zip

  3. インストールプログラムを実行します。インストーラは AWS CLI を /usr/local/aws にインストールし、シンボリックリンク aws を /usr/local/bin フォルダに作成します。-b オプションを使用してシンボリックリンクを作成すると、ユーザーの $PATH 変数にインストールフォルダを指定する必要がなくなります。これにより、すべてのユーザーが任意のディレクトリから AWS CLI を入力して aws を呼び出せるようになります。

    $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

    デフォルトでは、インストールスクリプトはシステムのデフォルトバージョンの Python で実行されます。別のバージョンの Python がインストールされており、それを使用して AWS CLI をインストールする場合は、次のように Python の実行可能ファイルへの絶対パスを指定してそのバージョンでインストールスクリプトを実行します。

    $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

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

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

    エラーが表示される場合は、「AWS CLI のエラーのトラブルシューティング」を参照してください。

sudo を使用しないバンドルされたインストーラでの AWS CLI バージョン 1 のインストール

sudo を使用するアクセス許可がない場合、または現在のユーザー向けに AWS CLI のみをインストールする場合は、前述のコマンドの修正バージョンを使用できます。最初の 2 つのコマンドは同じです。

AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws

AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が awscli-bundle-1.16.312.zip になるため、コマンドは以下のようになります。

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
現在のユーザーのために AWS CLI バージョン 1 をインストールする

  1. 次の方法の 1 つを使用して、AWS CLI バージョン 1 のバンドルされたインストーラをダウンロードします。

    • curl コマンドを使用してダウンロードします。

      AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が awscli-bundle-1.16.312.zip になるため、コマンドは以下のようになります。

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"

    • 直接リンクを使用してダウンロードします。

      最新バージョンの AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が awscli-bundle-1.16.312.zip になるため、URL が https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip になります

  2. パッケージからファイルを抽出します。unzip がない場合は、Linux ディストリビューションに組み込まれたパッケージマネージャーを使用してインストールします。

    $ unzip awscli-bundle.zip

  3. インストールプログラムを実行します。インストーラは AWS CLI を /usr/local/aws にインストールし、シンボリックリンク aws を /usr/local/bin ディレクトリに作成します。このコマンドは -b パラメータを使用して、インストーラが aws シンボリックリンクファイルを配置するディレクトリを指定します。指定したディレクトリへの書き込み権限が必要です。

    $ ./awscli-bundle/install -b ~/bin/aws

    これにより、AWS CLI がデフォルトの場所 (~/.local/lib/aws) にインストールされ、シンボリックリンクが ~/bin/aws に作成されます。シンボリックリンクが動作するように、~/bin が $PATH 環境変数にあることを確認してください。

    $ echo $PATH | grep ~/bin     // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH     // Add ~/bin to $PATH if necessary

  4. AWS CLI バージョン 1 がインストールされているフォルダが $PATH 変数の一部であることを確認します。

    1. ユーザーフォルダーでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、echo $SHELL を実行します。

      $ ls -a ~
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads

      • Bash - .bash_profile、.profile、または .bash_login

      • Zsh - .zshrc

      • Tcsh - .tcshrc、.cshrc、または .login

    2. 次の例のように、プロファイルスクリプトの末尾にエクスポートコマンドを追加します。

      export PATH=~/.local/bin:$PATH

      このコマンドでは、パス (この例では ~/.local/bin) が、既存の PATH 変数の前に挿入されます。

    3. 変更が有効になるように、プロファイルを現在のセッションに再ロードします。

      $ source ~/.bash_profile

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

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

    エラーが表示される場合は、「AWS CLI のエラーのトラブルシューティング」を参照してください。

AWS CLI バージョン 1 のバンドルされたインストーラのアンインストール

  1. バンドルされたインストーラは、オプションのシンボリックリンク以外のすべてをインストールディレクトリの内部に配置します。したがって、アンインストールするには、これら 2 つの項目を削除するだけです。

    $ sudo rm -rf /usr/local/aws
$ sudo rm /usr/local/bin/aws

  2. (オプション) .aws フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。

    警告

    これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。

    .aws フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは ~/.aws/ にあります。このディレクトリへの書き込みアクセス許可がユーザーにある場合は、sudo を使用する必要はありません。

    $ sudo rm ~/.aws/

pip を使用した AWS CLI バージョン 1 のインストール、更新、アンインストール

pip を直接使用して AWS CLI をインストールできます。

pip をインストールします。

pip がインストールされていない場合は、Python Packaging Authority が提供するスクリプトを使用してインストールできます。pip --version を実行して、Linux のバージョンにすでに Python と pip が含まれているかどうか確認します。Python version 3 以降がインストールされている場合は、pip3 コマンドの使用が推奨されます。

  1. curl コマンドを使用してインストールスクリプトをダウンロードします。以下のコマンドでは、-O (大文字の O) パラメータを使用して、ダウンロードしたファイルが、リモートホストでの同じ名前で、現在のフォルダに保存されるように指定します。

    $ curl -O https://bootstrap.pypa.io/get-pip.py

  2. python または python3 コマンドでスクリプトを実行して、pip の最新バージョンとその他の必要なサポートパッケージをダウンロードしてインストールします。--user スイッチを含めると、スクリプトは pip をパス ~/.local/bin にインストールします。

    $ python3 get-pip.py --user

pip を使用した AWS CLI のインストールと更新

  1. pip または pip3 コマンドを使用して、AWS CLI をインストールします。Python バージョン 3 以降を使用する場合、pip3 コマンドの使用が推奨されます。

    AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

    $ pip3 install awscli --upgrade --user

    AWS CLI の特定バージョンの場合は、ファイル名に 2 つの等号 「=」とバージョン番号を追加します。この例では、バージョン 1.16.312 のファイル名が ==1.16.312 になるため、コマンドは以下のようになります。

    $ pip3 install awscli==1.16.312 --upgrade --user
    注記

    端末に適切な引用符ルールを使用してください。= 文字を使用するには、一重引用符または二重引用符を使用して、適切にエスケープする必要があります。次の例では、一重引用符を使用してエスケープしています。

    $ pip3 install 'awscli==1.16.312' --upgrade --user

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

    $ aws --version
aws-cli/1.40.41 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6

    プログラムが見つからない場合は、そのプログラムをコマンドラインパスに追加します。

macOS コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加

pip を使用してインストールした後は、オペレーティングシステムの PATH 環境変数への aws プログラムの追加が必要になる場合があります。プログラムの場所は、Python のインストール先によって異なります。

例 AWS CLI のインストール場所 - Python 3.6 および pip のある macOS (ユーザーモード)
~/Library/Python/3.7/bin

前の例のバージョン用に使用する Python のバージョンで置き換えます。

Python のインストール先がわからない場合は、which python を実行します。

$ which python
/usr/local/bin/python

出力は、実際のプログラムではなくシンボリックリンクへのパスになる場合があります。ls -al を実行して、その参照先を確認します。

$ ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python3.7

pip は、Python プログラムが含まれている同じフォルダに、アプリケーションをインストールします。このフォルダを PATH 変数に追加します。

PATH 変数を変更するには

  1. ユーザーディレクトリでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、echo $SHELL を実行します。

    $ ls -a ~
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads

    • Bash - .bash_profile、.profile、.bash_login

    • Zsh – .zshrc

    • Tcsh - .tcshrc、.cshrc、.login

  2. プロファイルスクリプトにエクスポートコマンドを追加します。

    export PATH=~/.local/bin:$PATH

    このコマンドは、現在の ~/.local/bin 変数にパス (この例では PATH) を追加します。

  3. 現在のセッションに更新されたプロファイルをロードします。

    $ source ~/.bash_profile

pip を使用して AWS CLI をアンインストールする

  1. pip を使用して AWS CLI バージョン 1 をインストールした場合は、pip を使用してアンインストールする必要もあります。

    $ pip uninstall awscli

    Python 2 または 3 バージョンを使用している場合は、pip2 または pip3 コマンドを使用する必要がある場合があります。aws --version コマンドを使用して、インストールした AWS CLI バージョン 1 に関連付けられている Python バージョンを確認します。

    $ pip3 uninstall awscli

    すべてのファイルを削除するには、コマンドプロンプトウィンドウまたはコンピュータの再起動が必要になる場合があります。

  2. (オプション) .aws フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。

    警告

    これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。

    .aws フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは ~/.aws/ にあります。このディレクトリへの書き込みアクセス許可がユーザーにある場合は、sudo を使用する必要はありません。

    $ sudo rm -rf ~/.aws/

AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング

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