Linux での AWS CLI バージョン 1 のインストール、更新、アンインストール - AWS Command Line Interface

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

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

AWS Command Line Interface パッケージマネージャーまたはバンドルされたインストーラを使用して、AWS CLI (pip) バージョン 1 とその依存関係をほとんどの Linux ディストリビューションにインストールできます。

awscli パッケージは、aptyum などの他のパッケージマネージャーのリポジトリで利用できますが、これらのパッケージは AWS によって生成、管理、サポートされません。このガイドに記載されている公式の AWS CLI ディストリビューションポイントからのみ AWS をインストールすることを推奨します。

前提条件

また、Python 3.7 以降をインストールする必要があります。インストール手順については、Python の Beginner Guide で「Downloading Python」ページを参照してください。

警告

Python 2.7 は、2020 年 1 月 1 日に Python Software Foundation によって非推奨になりました。AWS CLI バージョン 1.20.0 から、Python 3.6 以上が必要になります。

AWS CLI バージョン 1 を古いバージョンの Python で使用するには、AWS CLI バージョン 1 の以前のバージョンをインストールする必要があります。AWS CLI バージョン 1 の Python バージョンサポートマトリックスについては、「Python バージョンの要件」を参照してください。

バンドルされたインストーラを使用した Linux での AWS CLI バージョン 1 のインストールおよびアンインストール

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

注記

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

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

次の手順では、Linux または 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 をインストールします。

バンドルされたインストーラを使用して 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 オプションを使用してシンボリックリンクを作成すると、ユーザーの $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.27.69 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

    エラーが表示される場合は、「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. 次のいずれかの方法で、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 を使用してパッケージからファイルを抽出します。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 に作成されます。シンボリックリンクが動作するように、~/binPATH 環境変数にあることを確認してください。

    $ 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.27.69 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

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

  1. バンドルされたインストーラを使用して AWS CLI をインストールした場合は、次の手順に従ってください。バンドルされたインストーラでは、オプションのシンボリックリンク以外は、インストールディレクトリの外に何も置きません。そのため、アンインストールはこの 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 -r ~/.aws/

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

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
  3. pip を含むディレクトリが 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
  4. pip または pip3 が正しくインストールされていることを確認するには、次のコマンドを実行します。

    $ pip3 --version pip 19.2.3 from ~/.local/lib/python3.7/site-packages (python 3.7)

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

  1. pip または pip3 コマンドを使用して、AWS CLI をインストールまたは更新します。Python バージョン 3 以降を使用する場合、pip3 コマンドの使用が推奨されます。--user スイッチ pip は、AWS CLI を ~/.local/bin にインストールします。

    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.27.69 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

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

pip を使用してインストールした後は、オペレーティングシステムの aws 環境変数への PATH 実行ファイルの追加が必要になる場合があります。

pip によって AWS CLI をインストールしたフォルダを確認するには、次のコマンドを実行します。

$ which aws /home/username/.local/bin/aws

~/.local/bin/ は Linux では /home/username に対応するため、これを ~ として参照できます。

--user スイッチを省いて、ユーザーモードでインストールしなかった場合、実行可能ファイルは Python のインストール先の bin フォルダにあります。Python がインストールされた場所が不明な場合は、次のコマンドを実行します。

$ which python /usr/local/bin/python

出力は、実際の実行可能ファイルではなく symlink へのパスになる場合があります。ls -al を実行して、その参照先を確認します。

$ ls -al /usr/local/bin/python /usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6

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 ~/.aws/

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

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