AWS Command Line Interface
ユーザーガイド

AWS CLI のインストール

AWS Command Line Interface (AWS CLI) をインストールする方法

前提条件

  • Python 2 バージョン 2.6.5+ または Python 3 バージョン 3.3+

  • Windows、Linux, macOS, or Unix

注記

以前のバージョンの Python は、AWS のすべてのサービスで動作しない可能性があります。AWS CLI をインストールまたは使用するときに、InsecurePlatformWarning または廃止の通知が表示された場合は、新しいバージョンに更新します。

最新の CLI のバージョン番号については、https://github.com/aws/aws-cli/blob/master/CHANGELOG.rst を参照してください。

このガイドでは、表示されるコマンドは Python v3 がインストールされ、表示される pip コマンドは pip3 バージョンが使用されていることを前提としています。

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

Linux、Windows、および MacOS 上の AWS CLI の主なディストリビューションは pip です。これは、Python パッケージとその依存関係を簡単にインストール、アップグレード、および削除するための Python パッケージマネージャーです。

AWS CLI の最新バージョンのインストール

AWS CLI 新しいサービスおよびコマンドをサポートするよう頻繁に更新されます。最新バージョンがあるかどうかを確認するには、「GitHub のリリースページ」を参照してください。

pip およびサポートされるバージョンの Python がすでにインストールされている場合は、以下のコマンドを使用して、AWS CLI をインストールできます。Python version 3+ がインストールされている場合は、pip3 コマンドの使用が推奨されます。

$ pip3 install awscli --upgrade --user

--upgrade オプションでは、すでにインストールされている要件をアップグレードするよう に指示します。pip3--user オプションでは、オペレーティングシステムによって使用されるライブラリの変更を避けるために、ユーザーディレクトリのサブディレクトリにプログラムをインストールするよう pip3 に指示します。

AWS CLI の最新バージョンへのアップグレード

AWS CLI の新しいバージョンがあるかどうか定期的に確認し、可能な場合はアップグレードすることをお勧めします。

「古い」パッケージを確認するには、pip3 list -o コマンドを使用します。

$ aws --version aws-cli/1.16.170 Python/3.7.3 Linux/4.14.123-111.109.amzn2.x86_64 botocore/1.12.160 $ pip3 list -o Package Version Latest Type ---------- -------- -------- ----- awscli 1.16.170 1.16.198 wheel botocore 1.12.160 1.12.188 wheel

前のコマンドにより、使用可能な AWS CLI の新しいバージョンがあることが表示されたため、pip3 install --upgrade を実行して最新バージョンを入手できます。

$ pip3 install --upgrade --user awscli Collecting awscli Downloading https://files.pythonhosted.org/packages/dc/70/b32e9534c32fe9331801449e1f7eacba6a1992c2e4af9c82ac9116661d3b/awscli-1.16.198-py2.py3-none-any.whl (1.7MB) |████████████████████████████████| 1.7MB 1.6MB/s Collecting botocore==1.12.188 (from awscli) Using cached https://files.pythonhosted.org/packages/10/cb/8dcfb3e035a419f228df7d3a0eea5d52b528bde7ca162f62f3096a930472/botocore-1.12.188-py2.py3-none-any.whl Requirement already satisfied, skipping upgrade: docutils>=0.10 in ./venv/lib/python3.7/site-packages (from awscli) (0.14) Requirement already satisfied, skipping upgrade: rsa<=3.5.0,>=3.1.2 in ./venv/lib/python3.7/site-packages (from awscli) (3.4.2) Requirement already satisfied, skipping upgrade: colorama<=0.3.9,>=0.2.5 in ./venv/lib/python3.7/site-packages (from awscli) (0.3.9) Requirement already satisfied, skipping upgrade: PyYAML<=5.1,>=3.10; python_version != "2.6" in ./venv/lib/python3.7/site-packages (from awscli) (3.13) Requirement already satisfied, skipping upgrade: s3transfer<0.3.0,>=0.2.0 in ./venv/lib/python3.7/site-packages (from awscli) (0.2.0) Requirement already satisfied, skipping upgrade: jmespath<1.0.0,>=0.7.1 in ./venv/lib/python3.7/site-packages (from botocore==1.12.188->awscli) (0.9.4) Requirement already satisfied, skipping upgrade: urllib3<1.26,>=1.20; python_version >= "3.4" in ./venv/lib/python3.7/site-packages (from botocore==1.12.188->awscli) (1.24.3) Requirement already satisfied, skipping upgrade: python-dateutil<3.0.0,>=2.1; python_version >= "2.7" in ./venv/lib/python3.7/site-packages (from botocore==1.12.188->awscli) (2.8.0) Requirement already satisfied, skipping upgrade: pyasn1>=0.1.3 in ./venv/lib/python3.7/site-packages (from rsa<=3.5.0,>=3.1.2->awscli) (0.4.5) Requirement already satisfied, skipping upgrade: six>=1.5 in ./venv/lib/python3.7/site-packages (from python-dateutil<3.0.0,>=2.1; python_version >= "2.7"->botocore==1.12.188->awscli) (1.12.0) Installing collected packages: botocore, awscli Found existing installation: botocore 1.12.160 Uninstalling botocore-1.12.160: Successfully uninstalled botocore-1.12.160 Found existing installation: awscli 1.16.170 Uninstalling awscli-1.16.170: Successfully uninstalled awscli-1.16.170 Successfully installed awscli-1.16.198 botocore-1.12.188

仮想環境への AWS CLI のインストール

pip3 で AWS CLI のインストールを試みたときに依存関係の問題が発生した場合は、仮想環境に AWS CLI をインストールしてツールとその依存関係を隔離します。または、通常使用しているものと異なるバージョンの Python を使用することもできます。

インストーラを使用した AWS CLI のインストール

Linux, macOS, or Unix でオフラインまたは自動インストールをするには、バンドルされたインストーラを試してください。バンドルされたインストーラには、AWS CLI、その依存関係、およびインストールを実行するシェルスクリプトが含まれます。

Windows では、MSI インストーラも使用できます。これらの方法のいずれも、初回のインストールを簡単にします。ただし、AWS CLI の新しいバージョンがリリースされた際のアップグレードはより難しくなります。

インストール後に実行する手順

パスを設定して AWS CLI を含める

AWS CLI をインストールしたら、PATH 変数への実行可能ファイルのパスの追加が必要になる場合があります。プラットフォーム固有の手順については、以下のトピックを参照してください。

aws --version を実行することで、AWS CLI が正しくインストールされたことを確認します。

$ aws --version aws-cli/1.16.116 Python/3.6.8 Linux/4.14.77-81.59-amzn2.x86_64 botocore/1.12.106

認証情報を使用した AWS CLI の設定

CLI コマンドを実行する前に、認証情報を使用して AWS CLI を設定する必要があります。

AWS CLI 設定ファイルプロファイルを定義することによって、認証情報をローカルに保存できます。認証情報はデフォルトでユーザーのホームディレクトリに保存されます。詳細については、「AWS CLI の設定」を参照してください。

注記

Amazon EC2 インスタンスで実行している場合、認証情報はインスタンスメタデータから自動的に取得できます。詳細については、「インスタンスメタデータ」を参照してください。

AWS CLI の最新バージョンへのアップグレード

AWS CLI は新しいサービスとコマンドのサポートを追加するために、定期的に更新されます。AWS CLI を最新バージョンに更新するには、インストールコマンドを再び実行します。AWS CLI の最新バージョンについては、「AWS CLI リリースノート」を参照してください。

$ pip3 install awscli --upgrade --user

AWS CLI のアンインストール

AWS CLI をアンインストールする必要がある場合は、pip uninstall を使用します。

$ pip3 uninstall awscli

Python と pip がインストールされていない場合は、使用している環境に応じた手順に従ってください。

各環境の詳細な手順