# AWS CLI の開始方法
この章では、AWS Command Line Interface (AWS CLI) のバージョン 2 の使用を開始する手順と、関連する手順へのリンクを示します。
1. **[すべての前提条件を満たす](getting-started-prereqs.md)** - AWS CLI で AWS サービスにアクセスするには、少なくとも AWS アカウント および IAM 認証情報が必要です。AWS アカウントのセキュリティを強化するため、ルートアカウントの認証情報を使用しないことをお勧めします。AWS で実行するタスクへのアクセス認証情報を提供するには、最小特権を持つユーザーを作成する必要があります。
1. 次のいずれかの方法を使用して、AWS CLI をインストールするか、アクセス許可を取得します。
+ **(推奨)** [AWS CLI の最新バージョンのインストールまたは更新](getting-started-install.md)。
+ [過去にリリースされた AWS CLI バージョン 2 をインストールする](getting-started-version.md)。特定バージョンのインストールは、チームで特定バージョンのツールが必要な場合に行います。
+ [ソースからの AWS CLI のビルドとインストール](getting-started-source-install.md)。GitHub ソースからの AWS CLI の構築は、構築済みのインストーラで直接サポートされていないプラットフォームで作業するお客様が主に使用する、より詳細な方法です。
+ [AWS CLI に対して公式の Amazon ECR Public イメージまたは Docker イメージを実行する](getting-started-docker.md).
+ AWS CloudShell を使用して、お使いのブラウザから AWS コンソールの AWS CLI バージョン 2 にアクセスする。詳細については[AWS CloudShell ユーザーガイド](https://docs.aws.amazon.com/cloudshell/latest/userguide/)を参照してください。
1. [AWS CLI にアクセスできるようになったら、初回使用に必要な IAM 認証情報で AWS CLI を設定します。](getting-started-quickstart.md)
**インストーラまたは設定エラーのトラブルシューティング**
AWS CLI のインストール、アンインストール、または設定を行った後に問題が発生した場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
**Topics**
+ [
# AWS CLI バージョン 2 を使用するための前提条件
](getting-started-prereqs.md)
+ [
# AWS CLI の最新バージョンのインストールまたは更新
](getting-started-install.md)
+ [
# 過去にリリースされた AWS CLI バージョン 2 をインストールする
](getting-started-version.md)
+ [
# ソースからの AWS CLI のビルドとインストール
](getting-started-source-install.md)
+ [
# AWS CLI に対して公式の Amazon ECR Public イメージまたは Docker イメージを実行する
](getting-started-docker.md)
+ [
# のセットアップAWS CLI
](getting-started-quickstart.md)
# AWS CLI バージョン 2 を使用するための前提条件
AWS CLI を使用して AWS のサービスにアクセスするには、AWS アカウントおよび IAM 認証情報または IAM Identity Centerの認証情報が必要です。AWS CLIコマンドを実行する場合、AWS CLI ではそれらの AWS 認証情報にアクセスする必要があります。AWS アカウントのセキュリティを強化するために、ルートユーザーまたは IAM ユーザーを使用するときは、有効期間の短い認証情報のみを使用することを推奨します。AWS で実行するタスクへのアクセス認証情報を提供するには、最小特権を持つユーザーを作成する必要があります。ベストプラクティスの詳細については、「IAM ユーザーガイド」の「[セキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)」を参照してください。
**Topics**
+ [
## IAM または IAM Identity Center 管理アカウントを作成する
](#getting-started-prereqs-iam)
+ [
## 次のステップ
](#getting-started-prereqs-next)
## IAM または IAM Identity Center 管理アカウントを作成する
AWS CLI を設定する前に、IAM または IAM アイデンティティセンターのアカウントを作成する必要があります。
**アカウント作成オプション**
| 認証情報を管理する方法を選択する | まで | アカウントを作成する方法 | アカウントへのプログラムによるアクセスを設定する方法 |
| --- | --- | --- | --- |
| AWS マネジメントコンソールの認証情報 | 最初のアカウント設定時に作成されたルートユーザー、IAM ユーザー、または ID プロバイダーからのフェデレーティッド ID に対応する短期の認証情報を使用します。 | [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開き、オンラインの指示に従います。 | 追加のステップは必要ありません。AWS アカウントで AWS CLI にサインインするには、「[コンソール認証情報を使用して AWS ローカル開発にログインする](cli-configure-sign-in.md)」を参照してください。 |
| IAM アイデンティティセンター | 短期の認証情報を使用して AWS にアクセスします。 | 手順については、「AWS IAM Identity Center ユーザーガイド」の「開始方法」を参照してください。 | 「AWS IAM Identity Center ユーザーガイド」で使用するように設定して、プログラムによるアクセスを設定します。 |
| AWS Identity and Access Management(非推奨) | 長期の認証情報を使用して AWS サービスにアクセスします。 | 「IAM ユーザーガイド」の「緊急アクセス用を作成する」の手順に従います。 | 「IAM ユーザーガイド」の「ユーザーのアクセスキーを管理する」の手順に従って、プログラムによるアクセスを設定します。 |
## 次のステップ
AWS アカウント および IAM 認証情報の作成後、AWS CLI を使用するには次のいずれかを実行します。
+ お使いのコンピュータに AWS CLI バージョン 2 の[最新リリースをインストールする](getting-started-install.md)。
+ お使いのコンピュータに AWS CLI バージョン 2 の[過去のリリースをインストールする](getting-started-version.md)。
+ [Docker イメージを使用](getting-started-docker.md)して、お使いのコンピュータから AWS CLI バージョン 2 にアクセスする。
+ AWS CloudShell を使用して、お使いのブラウザから AWS コンソールの AWS CLI バージョン 2 にアクセスする。詳細については、[AWS CloudShell ユーザーガイド](https://docs.aws.amazon.com/cloudshell/latest/userguide/)を参照してください。
# AWS CLI の最新バージョンのインストールまたは更新
このトピックでは、サポートされているオペレーティングシステムに AWS Command Line Interface (AWS CLI) の最新リリースをインストールまたは更新する方法について説明します。AWS CLI の最新リリースについては、GitHub の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
AWS CLI の過去のリリースをインストールするには、「[過去にリリースされた AWS CLI バージョン 2 をインストールする](getting-started-version.md)」を参照してください。アンインストール手順については、「[AWS CLI バージョン 2 のアンインストール](uninstall.md)」を参照してください。
**重要**
AWS CLI バージョン 1 と 2 では同じ `aws` コマンド名が使用されます。AWS CLI バージョン 1 を以前にインストールしている場合については、「[AWS CLI バージョン 2 の移行ガイド](cliv2-migration.md)」を参照してください。
**Topics**
+ [
## AWS CLI のインストールと更新の手順
](#getting-started-install-instructions)
+ [
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
](#install-tshoot)
+ [
## 次のステップ
](#install-next-steps)
## AWS CLI のインストールと更新の手順
インストール手順については、お使いのオペレーティングシステムのセクションを展開します。
### Linux
#### インストールと更新の要件
+ ダウンロードしたパッケージを抽出または解凍できる必要があります。オペレーティングシステムに組み込み `unzip` コマンドがない場合は、同等のコマンドを使用します。
+ AWS CLI では `glibc`、`groff`、および `less` を使用します。これらは、Linux のほとんどの主要なディストリビューションにデフォルトで含まれています。
+ AWS CLI は、CentOS、Fedora、Ubuntu、Amazon Linux 1、Amazon Linux 2、Amazon Linux 2023、および Linux ARM の最近のディストリビューションの 64 ビットバージョンでサポートされています。
+ `snap` 以外のサードパーティーのリポジトリは AWS で管理されていないため、そうしたリポジトリに AWS CLI の最新バージョンが含まれていることを保証できません。
#### AWS CLI をインストールまたは更新する
**警告**
Amazon Linux でのアップデートが初めての場合、AWS CLI の最新バージョンをインストールするには、次のコマンドを使用して、プリインストールされている `yum` バージョンをアンインストールする必要があります。
```
$ sudo yum remove awscli
```
AWS CLI の `yum` インストールが削除されたら、以下に示す Linux のインストール手順に従ってください。
AWS CLI をインストールするには、次のいずれかの方法を使用します。
+ **コマンドラインインストーラ**は、インストールするバージョンを指定できるため、バージョン管理に適したオプションです。このオプションは自動更新されないため、更新するたびに新しいインストーラをダウンロードして以前のバージョンを上書きする必要があります。
+ **公式にサポートされている `snap` パッケージ**は、snap パッケージが自動的に更新されるため、常に最新バージョンの AWS CLI を使用するのに適したオプションです。AWS CLI のマイナーバージョンを選択するための組み込みサポートはないため、チームがバージョンを固定する必要がある場合には最適なインストール方法ではありません。
------
#### [ Command line installer - Linux x86 (64-bit) ]
AWS CLI の現在のインストールを更新するには、更新するたびに新しいインストーラをダウンロードして以前のバージョンを上書きします。AWS CLI を Linux にインストールするには、コマンドラインから以下の手順を実行します。
基本的なインストールを提供する、1 つのコピーアンドペーストグループでの簡単なインストール手順を次に示します。ガイド付き手順については、次のステップを参照してください。
**注記**
**(オプション)** 次のコマンドブロックは、ダウンロードの整合性を最初に検証せずに AWS CLI をダウンロードしてインストールします。ダウンロードの整合性を検証するには、以下の詳しい手順に従ってください。
AWS CLI を**インストール**するには、次のコマンドを実行します。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
AWS CLI の**現在のインストールを更新**するには、既存のシンボリックリンクとインストーラの情報を追加して `--bin-dir`、`--install-dir`、および `--update` パラメータで `install` コマンドを作成します。次のコマンドブロックは、*/usr/local/bin* のサンプルのシンボリックリンクと */usr/local/aws-cli* のサンプルのインストーラの場所を使用して、現在のユーザーに対し AWS CLI をローカルにインストールします。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
**ガイド付きインストールのステップ**
1. 次のいずれかの方法でインストールファイルをダウンロードします。
+ **`curl` コマンドの使用** – `-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。以下のコマンドの例のオプションを使用すると、ダウンロードしたファイルが現在のディレクトリにローカル名 `awscliv2.zip` で書き込まれます。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
```
+ **URL からのダウンロード** - ブラウザでインストーラをダウンロードするには、次の URL を使用します。[https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip)
1. **(オプション) ダウンロードした zip ファイルの整合性を確認する**
上述のステップで、AWS CLI のインストーラパッケージ `.zip` を手動でダウンロードすることを選択した場合、以下の手順で `GnuPG` ツールを使用して署名を確認できます。
AWS CLI インストーラパッケージの `.zip` ファイルは、PGP 署名を使用して暗号化で署名されます。ファイルの破損や変更がある場合、この検証は失敗します。その場合、インストールを続行しないでください。
1. ご利用のパッケージマネージャーを使用し、`gpg` コマンドをダウンロードしてインストールします。`GnuPG` の詳細については、[GnuPG のウェブサイト](https://www.gnupg.org/)を参照してください。
1. パブリックキーファイルを作成するには、テキストファイルを作成し、次のテキストに貼り付けます。
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
参考までに、パブリックキーの詳細を以下に示します。
```
Key ID: A6310ACC4672475C
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. 次のコマンドで AWS CLI パブリックキーをインポートします。*public-key-file-name* は、作成したパブリックキーのファイル名に置き換えます。
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. ダウンロードしたパッケージの AWS CLI 署名ファイルをダウンロードします。これは、対応する `.zip` ファイルと同じパスと名前を持っていますが、拡張子は `.sig` です。次の例では、現在のディレクトリに `awscliv2.sig` という名前のファイルとして保存します。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
1. 署名を検証し、`.sig` ファイル名と `.zip` ファイル名の両方をパラメータとして `gpg` コマンドに渡します。
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
出力は以下の例のようになります。
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**重要**
出力内の警告は予想されており、問題を示すものではありません。これは、個人用の PGP キー (持っている場合) と AWS CLI PGP キーの間に信頼チェーンがないために表示されます。詳細については、「[信用の輪 (Web of Trust)](https://en.wikipedia.org/wiki/Web_of_trust)」を参照してください。
1. インストーラを解凍します。Linux ディストリビューションに組み込み `unzip` コマンドがない場合は、同等のコマンドを使用して解凍します。次のコマンド例では、パッケージを解凍し、現在のディレクトリの下に `aws` という名前のディレクトリを作成します。
```
$ unzip awscliv2.zip
```
**注記**
以前のバージョンからアップデートする場合、`unzip` コマンドでは、既存のファイルを上書きするように求められます。スクリプトのオートメーションなどでこのプロンプトをスキップする場合は、`unzip` の `-u` 更新フラグを使用します。このフラグは、既存のファイルを自動的に更新し、必要に応じて新しいファイルを作成します。
```
$ unzip -u awscliv2.zip
```
1. インストールプログラムを実行します。インストールコマンドは、新しく解凍された `install` ディレクトリにある `aws` という名前のファイルを使用します。デフォルトでは、すべてのファイルが `/usr/local/aws-cli` にインストールされ、シンボリックリンクが `/usr/local/bin` に作成されます。コマンドには、これらのディレクトリへの書き込み権限を付与するための `sudo` が含まれます。
```
$ sudo ./aws/install
```
すでに書き込み権限を持つディレクトリを指定した場合は、`sudo` なしでインストールできます。次の `install` コマンド用の手順を使用して、インストール場所を指定します。
+ `-i` および `-b` パラメータに指定するパス内のボリューム名やディレクトリ名に、スペース文字などの空白文字が含まれないことを確認します。スペースが含まれていると、インストールは失敗します。
+ `--install-dir`または `-i` — このオプションは、すべてのファイルのコピー先ディレクトリを指定します。
デフォルト値は `/usr/local/aws-cli` です。
+ `--bin-dir`または `-b` — このオプションは、インストールディレクトリのメイン`aws`プログラムが、指定されたパスのファイル`aws`にシンボル的にリンクされることを指定します。指定したディレクトリへの書き込み権限が必要です。パスにすでに存在するディレクトリへのシンボリックリンクを作成すると、インストールディレクトリをユーザーの `$PATH` 変数に追加する必要がなくなります。
デフォルト値は `/usr/local/bin` です。
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**注記**
AWS CLI の現在のインストールを更新するには、既存のシンボリックリンクとインストーラの情報を追加して `--update` パラメータで `install` コマンドを作成します。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
既存のシンボリックリンクとインストールディレクトリを検索するには、次の手順に従います。
`which` コマンドを使用して、シンボリックリンクを見つけます。これにより、`--bin-dir` パラメータで使用するパスが指定されます。
```
$ which aws
/usr/local/bin/aws
```
`ls` コマンドを使用して、シンボリックリンクが指すディレクトリを見つけます。これにより、`--install-dir` パラメータで使用するパスが指定されます。
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. 以下のコマンドを使用して、インストールを確認します。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
#### [ Command line - Linux ARM ]
AWS CLI の現在のインストールを更新するには、更新するたびに新しいインストーラをダウンロードして以前のバージョンを上書きします。AWS CLI を Linux にインストールするには、コマンドラインから以下の手順を実行します。
基本的なインストールを提供する、1 つのコピーアンドペーストグループでの簡単なインストール手順を次に示します。ガイド付き手順については、次のステップを参照してください。
**注記**
**(オプション)** 次のコマンドブロックは、ダウンロードの整合性を最初に検証せずに AWS CLI をダウンロードしてインストールします。ダウンロードの整合性を検証するには、以下の詳しい手順に従ってください。
AWS CLI を**インストール**するには、次のコマンドを実行します。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
AWS CLI の**現在のインストールを更新**するには、既存のシンボリックリンクとインストーラの情報を追加して `--bin-dir`、`--install-dir`、および `--update` パラメータで `install` コマンドを作成します。以下のコマンドブロックでは */usr/local/bin* のシンボリックリンクと */usr/local/aws-cli* のインストーラの場所の例を使用しています。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
**ガイド付きインストールのステップ**
1. 次のいずれかの方法でインストールファイルをダウンロードします。
+ **`curl` コマンドの使用** – `-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。以下のコマンドの例のオプションを使用すると、ダウンロードしたファイルが現在のディレクトリにローカル名 `awscliv2.zip` で書き込まれます。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
```
+ **URL からのダウンロード** - ブラウザでインストーラをダウンロードするには、次の URL を使用します。[https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip)
1. **(オプション) ダウンロードした zip ファイルの整合性を確認する**
上述のステップで、AWS CLI のインストーラパッケージ `.zip` を手動でダウンロードすることを選択した場合、以下の手順で `GnuPG` ツールを使用して署名を確認できます。
AWS CLI インストーラパッケージの `.zip` ファイルは、PGP 署名を使用して暗号化で署名されます。ファイルの破損や変更がある場合、この検証は失敗します。その場合、インストールを続行しないでください。
1. ご利用のパッケージマネージャーを使用し、`gpg` コマンドをダウンロードしてインストールします。`GnuPG` の詳細については、[GnuPG のウェブサイト](https://www.gnupg.org/)を参照してください。
1. パブリックキーファイルを作成するには、テキストファイルを作成し、次のテキストに貼り付けます。
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
参考までに、パブリックキーの詳細を以下に示します。
```
Key ID: A6310ACC4672475C
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. 次のコマンドで AWS CLI パブリックキーをインポートします。*public-key-file-name* は、作成したパブリックキーのファイル名に置き換えます。
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. ダウンロードしたパッケージの AWS CLI 署名ファイルをダウンロードします。これは、対応する `.zip` ファイルと同じパスと名前を持っていますが、拡張子は `.sig` です。次の例では、現在のディレクトリに `awscliv2.sig` という名前のファイルとして保存します。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
1. 署名を検証し、`.sig` ファイル名と `.zip` ファイル名の両方をパラメータとして `gpg` コマンドに渡します。
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
出力は以下の例のようになります。
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**重要**
出力内の警告は予想されており、問題を示すものではありません。これは、個人用の PGP キー (持っている場合) と AWS CLI PGP キーの間に信頼チェーンがないために表示されます。詳細については、「[信用の輪 (Web of Trust)](https://en.wikipedia.org/wiki/Web_of_trust)」を参照してください。
1. インストーラを解凍します。Linux ディストリビューションに組み込み `unzip` コマンドがない場合は、同等のコマンドを使用して解凍します。次のコマンド例では、パッケージを解凍し、現在のディレクトリの下に `aws` という名前のディレクトリを作成します。
```
$ unzip awscliv2.zip
```
**注記**
以前のバージョンからアップデートする場合、`unzip` コマンドでは、既存のファイルを上書きするように求められます。スクリプトのオートメーションなどでこのプロンプトをスキップする場合は、`unzip` の `-u` 更新フラグを使用します。このフラグは、既存のファイルを自動的に更新し、必要に応じて新しいファイルを作成します。
```
$ unzip -u awscliv2.zip
```
1. インストールプログラムを実行します。インストールコマンドは、新しく解凍された `install` ディレクトリにある `aws` という名前のファイルを使用します。デフォルトでは、すべてのファイルが `/usr/local/aws-cli` にインストールされ、シンボリックリンクが `/usr/local/bin` に作成されます。コマンドには、これらのディレクトリへの書き込み権限を付与するための `sudo` が含まれます。
```
$ sudo ./aws/install
```
すでに書き込み権限を持つディレクトリを指定した場合は、`sudo` なしでインストールできます。次の `install` コマンド用の手順を使用して、インストール場所を指定します。
+ `-i` および `-b` パラメータに指定するパス内のボリューム名やディレクトリ名に、スペース文字などの空白文字が含まれないことを確認します。スペースが含まれていると、インストールは失敗します。
+ `--install-dir`または `-i` — このオプションは、すべてのファイルのコピー先ディレクトリを指定します。
デフォルト値は `/usr/local/aws-cli` です。
+ `--bin-dir`または `-b` — このオプションは、インストールディレクトリのメイン`aws`プログラムが、指定されたパスのファイル`aws`にシンボル的にリンクされることを指定します。指定したディレクトリへの書き込み権限が必要です。パスにすでに存在するディレクトリへのシンボリックリンクを作成すると、インストールディレクトリをユーザーの `$PATH` 変数に追加する必要がなくなります。
デフォルト値は `/usr/local/bin` です。
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**注記**
AWS CLI の現在のインストールを更新するには、既存のシンボリックリンクとインストーラの情報を追加して `--update` パラメータで `install` コマンドを作成します。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
既存のシンボリックリンクとインストールディレクトリを検索するには、次の手順に従います。
`which` コマンドを使用して、シンボリックリンクを見つけます。これにより、`--bin-dir` パラメータで使用するパスが指定されます。
```
$ which aws
/usr/local/bin/aws
```
`ls` コマンドを使用して、シンボリックリンクが指すディレクトリを見つけます。これにより、`--install-dir` パラメータで使用するパスが指定されます。
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. 以下のコマンドを使用して、インストールを確認します。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
#### [ Snap package ]
`snap` では、AWS CLI の公式 AWS サポートバージョンを提供しています。常に最新バージョンの AWS CLI をシステムにインストールしておきたい場合は、自動更新される snap パッケージならばそれが可能です。AWS CLI のマイナーバージョンを選択するための組み込みサポートはないため、チームがバージョンを固定する必要がある場合には最適なインストール方法ではありません。AWS CLI の特定のマイナーバージョンをインストールする場合は、コマンドラインインストーラの使用をお勧めします。
1. Linux プラットフォームに `snap` がまだインストールされていない場合は、プラットフォームに `snap` をインストールします。
1. `snap` のインストールの詳細については、*Snap ドキュメント*の「[Installing the daemon](https://snapcraft.io/docs/installing-snapd)」を参照してください。
1. `PATH` 変数が正しく更新されるように、システムの再起動が必要な場合があります。インストールに問題がある場合は、「*Snap ドキュメント*」の「[一般的な問題を修正する](https://snapcraft.io/docs/fix-common-issues)」のステップに従います。
1. `snap` が正しくインストールされていることを確認するには、次のコマンドを実行します。
```
$ snap version
```
1. 次の `snap install` コマンドを AWS CLI に対して実行します。
```
$ snap install aws-cli --classic
```
アクセス許可によっては、コマンドに `sudo` を追加することが必要な場合があります。
```
$ sudo snap install aws-cli --classic
```
**注記**
AWS CLI のスナップリポジトリ (追加の `snap` 手順を含む) を表示するには、*Canonical Snapcraft ウェブサイト*の「[https://snapcraft.io/aws-cli](https://snapcraft.io/aws-cli)」ページを参照してください。
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
------
### macOS
#### インストールと更新の要件
+ AWS CLI は macOS バージョン 11 以降でサポートされています。詳細については、*AWS開発者ツールブログ*の「[AWS CLI v2 の macOS サポートポリシーの更新](https://aws.amazon.com/blogs/developer/macos-support-policy-updates-for-the-aws-cli-v2/)」を参照してください。
+ AWS はサードパーティーのリポジトリのメンテナンスを行っていないため、最新バージョンの AWS CLI が含まれていることは保証できません。
**macOS バージョンのサポートマトリックス**
| AWS CLI バージョン | サポートされている macOS バージョン |
| --- | --- |
| 2.21.0 - 最新 | 11 以上 |
| 2.17.0～2.20.0 | 10.15 以上 |
| 2.0.0～2.16.12 | 10.14 以下 |
#### AWS CLI をインストールまたは更新する
最新バージョンに更新する場合は、現在のバージョンで使用したのと同じインストール方法を使用します。macOS に AWS CLI をインストールするには、次の方法があります。
------
#### [ GUI installer ]
以下のステップは、標準の macOS ユーザーインターフェイスとブラウザを使用して AWS CLI の最新バージョンをインストールする方法を示しています。
1. ブラウザで、macOS `pkg` ファイルをダウンロードします: [https://awscli.amazonaws.com/AWSCLIV2.pkg](https://awscli.amazonaws.com/AWSCLIV2.pkg)
1. ダウンロードしたファイルを実行し、その後は画面の指示に従います。AWS CLI は以下の方法でインストールできます。
+ **コンピュータ上のすべてのユーザーが対象 ( が必要)`sudo`**
+ 任意のフォルダにインストールするか、推奨されるデフォルトのフォルダ `/usr/local/aws-cli` を選択できます。
+ インストーラによって、選択したインストールフォルダ内のメインプログラムにリンクするシンボリックリンクが `/usr/local/bin/aws` に自動的に作成されます。
+ **現在のユーザーのみが対象 ( は不要)`sudo`**
+ 書き込みアクセス許可がある任意のフォルダにインストールできます。
+ 標準のユーザー権限により、インストーラの完了後に、コマンドプロンプトで次のコマンドを使用して、`$PATH` および `aws` プログラムを指すシンボリックリンクファイルを `aws_completer` で手動で作成する必要があります。シンボリックリンクのデフォルトの場所は `/usr/local/bin/` です。
```
$ ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
フォルダへの書き込みアクセス許可がない場合は、コマンドに `sudo` を使用する必要がある場合があります。次の例では、`/usr/local/bin/` にあるシンボリックリンクのデフォルトの場所で `sudo` を使用します。
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
**注記**
インストーラの任意の場所で **Cmd \$1 L** キーを押すと、インストールのデバッグログを表示できます。これにより、ログをフィルター処理して保存できるログペインが開きます。また、ログファイルは `/var/log/install.log` に自動的に保存されます。
1. シェルが `aws` で `$PATH` コマンドを検索して実行できることを確認するには、次のコマンドを使用します。
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
#### [ Command line installer - All users ]
`sudo` アクセス許可がある場合は、コンピュータ上のすべてのユーザーを対象に AWS CLI をインストールできます。1 つの簡単な手順でグループのコピーと貼り付けができます。以下のステップの各行の説明を参照してください。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
**ガイド付きインストール手順**
1. `curl` コマンドを使用して、ファイルをダウンロードします。`-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。この例では、ファイルは現在のフォルダ内の `AWSCLIV2.pkg` に書き込まれます。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
1. ダウンロードした `installer` ファイルをソースとして指定して、標準の macOS `.pkg` プログラムを実行します。`-pkg` パラメータを使用して、インストールするパッケージの名前、およびパッケージをインストールするドライブの `-target /` パラメータを指定します。ファイルは `/usr/local/aws-cli` にインストールされ、シンボリックリンクが `/usr/local/bin` に自動的に作成されます。これらのフォルダに対する書き込みアクセス許可を付与するには、コマンドに `sudo` を含める必要があります。
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
インストールが完了すると、デバッグログが `/var/log/install.log` に書き込まれます。
1. シェルが `aws` で `$PATH` コマンドを検索して実行できることを確認するには、次のコマンドを使用します。
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
#### [ Command line - Current user ]
1. AWS CLI のインストール先フォルダを指定するには、任意のファイル名で XML ファイルを作成する必要があります。このファイルは、以下の例のような XML 形式のファイルです。すべての値は示されているままにします。ただし、9 行目のパス */Users/myusername* を、AWS CLI をインストールするフォルダへのパスに置き換える必要があります。*フォルダはすでに存在している必要があります。存在しない場合、コマンドは失敗します。**choices.xml* と名前の付いた次の XML の例では、AWS CLI を フォルダ `/Users/myusername` にインストールするようにインストーラに指定します。そこに `aws-cli` という名前のフォルダが作成されます。
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. `pkg` コマンドを使用して `curl` インストーラをダウンロードします。`-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。この例では、ファイルは現在のフォルダ内の `AWSCLIV2.pkg` に書き込まれます。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
1. 以下のオプションを使用して、標準の macOS `installer` プログラムを実行できます。
+ `-pkg` パラメータで、インストールするパッケージの名前を指定します。
+ `-target` パラメータを `CurrentUserHomeDirectory` に設定して、*現在のユーザーのみ*へのインストールを指定します。
+ `-applyChoiceChangesXML` パラメータで作成した XML ファイルのパス (現在のフォルダへの相対パス) と名前を指定します。
次の例では、フォルダ AWS CLI に `/Users/myusername/aws-cli` をインストールします。
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. 通常、標準のユーザーアクセス許可では `$PATH` 内のフォルダへの書き込みが許可されないため、このモードのインストーラは `aws` および `aws_completer` プログラムにシンボリックリンクを追加しようとしません。AWS CLI を正しく実行するには、インストーラの完了後にシンボリックリンクを手動で作成する必要があります。`$PATH` に書き込み可能なフォルダが含まれていて、そのフォルダをターゲットのパスとして指定すると、`sudo` なしで以下のコマンドを実行できます。`$PATH` に書き込み可能なフォルダが含まれていない場合は、`sudo` を使用して、指定したターゲットフォルダに対する書き込みアクセス許可を取得する必要があります。シンボリックリンクのデフォルトの場所は `/usr/local/bin/` です。`folder/installed` を、AWS CLI のインストールへのパスに置き換えます。
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
インストールが完了すると、デバッグログが `/var/log/install.log` に書き込まれます。
1. シェルが `aws` で `$PATH` コマンドを検索して実行できることを確認するには、次のコマンドを使用します。
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
### Server
#### インストールと更新の要件
+ AWS CLI は、Microsoft がサポートする 64 ビット Windows のバージョンでサポートされています。
+ ソフトウェアをインストールするための管理者権限
#### AWS CLI をインストールまたは更新する
Windows での AWS CLI の現在のインストールを更新するには、以前のバージョンを上書きするために更新するたびに、新しいインストーラをダウンロードします。AWS CLI は定期的に更新されています。最新バージョンがいつリリースされたかを確認するには、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
1. Windows 用の AWS CLI MSI インストーラ (64 ビット) をダウンロードして実行します。
[https://awscli.amazonaws.com/AWSCLIV2.msi](https://awscli.amazonaws.com/AWSCLIV2.msi)
または、MSI インストーラを実行するのに、`msiexec` コマンドを実行できます。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
```
`msiexec` で使用できるさまざまなパラメータについては、*Microsoft Docs* ウェブサイトの [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) を参照してください。例えば、`/qn` フラグを使用してサイレントインストールを行うことができます。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn
```
1. インストールを確認するには、[**スタート**] メニューを開き、`cmd` を検索してコマンドプロンプトウィンドウを開いて、コマンドプロンプトで `aws --version` コマンドを使用します。
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Windows がプログラムを見つけることができない場合、パスを更新するためにコマンドプロンプトウィンドウを閉じて再度開くか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
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)」を参照してください。
## 次のステップ
AWS CLI のインストールが成功したら、ダウンロードしたインストーラファイルを安全に削除できます。[AWS CLI バージョン 2 を使用するための前提条件](getting-started-prereqs.md) の各ステップを実行したら、AWS CLI をインストールして [のセットアップAWS CLI](getting-started-quickstart.md) を実行する必要があります。
# 過去にリリースされた AWS CLI バージョン 2 をインストールする
このトピックでは、サポートされているオペレーティングシステムに過去にリリースされた AWS Command Line Interface バージョン 2 (AWS CLI) をインストールする方法について説明します。AWS CLI バージョン 2 のリリースについては、GitHub の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
AWS CLI バージョン 2 のインストール手順:
## Linux
### インストール要件
+ インストールする AWS CLI バージョン 2 がリリースされています。バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
+ ダウンロードしたパッケージを抽出または解凍できる必要があります。オペレーティングシステムに組み込み `unzip` コマンドがない場合は、同等のコマンドを使用します。
+ AWS CLI バージョン 2 は `glibc`、`groff`、および `less` を使用します。これらは、Linux のほとんどの主要なディストリビューションにデフォルトで含まれています。
+ AWS CLI バージョン 2 は、CentOS、Fedora、Ubuntu、Amazon Linux 1、Amazon Linux 2、Linux ARM の最近のディストリビューションの 64 ビットバージョンでサポートされています。
+ AWS はサードパーティーのリポジトリのメンテナンスを行っていないため、最新バージョンの AWS CLI が含まれていることは保証できません。
### インストール手順
AWS CLI を Linux にインストールするには、コマンドラインから以下の手順を実行します。
64 ビット Linux と Linux ARM のどちらを使用するかに基づいて、1 つの簡単なステップでグループをコピーアンドペーストする方法を説明します。以下のステップの各行の説明を参照してください。
------
#### [ Linux x86 (64-bit) ]
**注記**
**(オプション)** 次のコマンドブロックは、ダウンロードの整合性を最初に検証せずに AWS CLI をダウンロードしてインストールします。ダウンロードの整合性を検証するには、以下の詳しい手順に従ってください。
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
AWS CLI を**インストール**するには、次のコマンドを実行します。
バージョンを指定する場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-x86_64-2.0.30.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
AWS CLI の**現在のインストールを更新**するには、既存のシンボリックリンクとインストーラの情報を追加して `--bin-dir`、`--install-dir`、および `--update` パラメータで `install` コマンドを作成します。以下のコマンドブロックでは */usr/local/bin* のシンボリックリンクと */usr/local/aws-cli* のインストーラの場所の例を使用しています。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
#### [ Linux ARM ]
**注記**
**(オプション)** 次のコマンドブロックは、ダウンロードの整合性を最初に検証せずに AWS CLI をダウンロードしてインストールします。ダウンロードの整合性を検証するには、以下の詳しい手順に従ってください。
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
AWS CLI を**インストール**するには、次のコマンドを実行します。
バージョンを指定する場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-aarch64-2.0.30.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
AWS CLI の**現在のインストールを更新**するには、既存のシンボリックリンクとインストーラの情報を追加して `--bin-dir`、`--install-dir`、および `--update` パラメータで `install` コマンドを作成します。以下のコマンドブロックでは */usr/local/bin* のシンボリックリンクと */usr/local/aws-cli* のインストーラの場所の例を使用しています。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
1. 次のいずれかの方法でインストールファイルをダウンロードします。
------
#### [ Linux x86 (64-bit) ]
+ **`curl` コマンドの使用** – `-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。以下のコマンドの例のオプションを使用すると、ダウンロードしたファイルが現在のディレクトリにローカル名 `awscliv2.zip` で書き込まれます。
バージョンを指定する場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-x86_64-2.0.30.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
```
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
+ **URL からダウンロードする** -
ブラウザで、ファイル名にハイフンとバージョン番号を追加して、AWS CLI の特定のバージョンをダウンロードします。
```
https://awscli.amazonaws.com/awscli-exe-linux-x86_64-version.number.zip
```
この例では、バージョン *2.0.30* のファイル名が awscli-exe-linux-x86\$164-2.0.30.zip になるため、リンクが [https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip) になります。
------
#### [ Linux ARM ]
+ **`curl` コマンドの使用** – `-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。以下のコマンドの例のオプションを使用すると、ダウンロードしたファイルが現在のディレクトリにローカル名 `awscliv2.zip` で書き込まれます。
バージョンを指定する場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-aarch64-2.0.30.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
+ **URL からダウンロードする** -
ブラウザで、ファイル名にハイフンとバージョン番号を追加して、AWS CLI の特定のバージョンをダウンロードします。
```
https://awscli.amazonaws.com/awscli-exe-linux-aarch64-version.number.zip
```
この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-aarch64-2.0.30.zip` になるため、リンクが [https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip) になります。
------
1. **(オプション) ダウンロードした zip ファイルの整合性を確認する**
上述のステップで、AWS CLI のインストーラパッケージ `.zip` を手動でダウンロードすることを選択した場合、以下の手順で `GnuPG` ツールを使用して署名を確認できます。
AWS CLI インストーラパッケージの `.zip` ファイルは、PGP 署名を使用して暗号化で署名されます。ファイルの破損や変更がある場合、この検証は失敗します。その場合、インストールを続行しないでください。
1. ご利用のパッケージマネージャーを使用し、`gpg` コマンドをダウンロードしてインストールします。`GnuPG` の詳細については、[GnuPG のウェブサイト](https://www.gnupg.org/)を参照してください。
1. パブリックキーファイルを作成するには、テキストファイルを作成し、次のテキストに貼り付けます。
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
参考までに、パブリックキーの詳細を以下に示します。
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. 次のコマンドで AWS CLI パブリックキーをインポートします。*public-key-file-name* は、作成したパブリックキーのファイル名に置き換えます。
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. ダウンロードしたパッケージの AWS CLI 署名ファイルをダウンロードします。これは、対応する `.zip` ファイルと同じパスと名前を持っていますが、拡張子は `.sig` です。次の例では、現在のディレクトリに `awscliv2.sig` という名前のファイルとして保存します。
------
#### [ Linux x86 (64-bit) ]
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-x86_64-2.0.30.zip.sig` になるため、コマンドは以下のようになります。
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
------
#### [ Linux ARM ]
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `awscli-exe-linux-aarch64-2.0.30.zip.sig` になるため、コマンドは以下のようになります。
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1)」を参照してください。
------
1. 署名を検証し、`.sig` ファイル名と `.zip` ファイル名の両方をパラメータとして `gpg` コマンドに渡します。
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
出力は以下の例のようになります。
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**重要**
出力内の警告は予想されており、問題を示すものではありません。これは、個人用の PGP キー (持っている場合) と AWS CLI PGP キーの間に信頼チェーンがないために表示されます。詳細については、「[信用の輪 (Web of Trust)](https://en.wikipedia.org/wiki/Web_of_trust)」を参照してください。
1. インストーラを解凍します。Linux ディストリビューションに組み込み `unzip` コマンドがない場合は、同等のコマンドを使用して解凍します。次のコマンド例では、パッケージを解凍し、現在のディレクトリの下に `aws` という名前のディレクトリを作成します。
```
$ unzip awscliv2.zip
```
1. インストールプログラムを実行します。インストールコマンドは、新しく解凍された `install` ディレクトリにある `aws` という名前のファイルを使用します。デフォルトでは、すべてのファイルが `/usr/local/aws-cli` にインストールされ、シンボリックリンクが `/usr/local/bin` に作成されます。コマンドには、これらのディレクトリへの書き込み権限を付与するための `sudo` が含まれます。
```
$ sudo ./aws/install
```
すでに書き込み権限を持つディレクトリを指定した場合は、`sudo` なしでインストールできます。次の `install` コマンド用の手順を使用して、インストール場所を指定します。
+ `-i` および `-b` パラメータに指定するパス内のボリューム名やディレクトリ名に、スペース文字などの空白文字が含まれないことを確認します。スペースが含まれていると、インストールは失敗します。
+ `--install-dir`または `-i` — このオプションは、すべてのファイルのコピー先ディレクトリを指定します。
デフォルト値は `/usr/local/aws-cli` です。
+ `--bin-dir`または `-b` — このオプションは、インストールディレクトリのメイン`aws`プログラムが、指定されたパスのファイル`aws`にシンボル的にリンクされることを指定します。指定したディレクトリへの書き込み権限が必要です。パスにすでに存在するディレクトリへのシンボリックリンクを作成すると、インストールディレクトリをユーザーの `$PATH` 変数に追加する必要がなくなります。
デフォルト値は `/usr/local/bin` です。
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**注記**
AWS CLI バージョン 2 の現在のインストールを、新しいバージョンに更新するには、既存のシンボリックリンクとインストーラの情報を追加して `--update`パラメータで `install` コマンドを作成します。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
既存のシンボリックリンクとインストールディレクトリを検索するには、次の手順に従います。
`which` コマンドを使用して、シンボリックリンクを見つけます。これにより、`--bin-dir` パラメータで使用するパスが指定されます。
```
$ which aws
/usr/local/bin/aws
```
`ls` コマンドを使用して、シンボリックリンクが指すディレクトリを見つけます。これにより、`--install-dir` パラメータで使用するパスが指定されます。
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. 以下のコマンドを使用して、インストールを確認します。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
## macOS
### インストール要件
+ インストールする AWS CLI バージョン 2 がリリースされています。バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1)」を参照してください。
+ AWS CLI バージョン 2 は、Apple がサポートしているバージョンの 64 ビット macOS でサポートされています。
+ AWS はサードパーティーのリポジトリのメンテナンスを行っていないため、最新バージョンの AWS CLI が含まれていることは保証できません。
### インストール手順
macOS に AWS CLI バージョン 2 をインストールするには、次の方法があります。
------
#### [ GUI installer ]
以下のステップは、標準の macOS ユーザーインターフェイスとブラウザを使用して AWS CLI バージョン 2 の最新バージョンをインストールするか、最新バージョンに更新する方法を説明しています。最新バージョンに更新する場合は、現在のバージョンに使用したのと同じインストール方法を使用します。
1. ブラウザで、ファイル名にハイフンとバージョン番号を追加して、AWS CLI の特定のバージョンをダウンロードします。
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.pkg
```
この例では、バージョン *2.0.30* のファイル名が `AWSCLIV2-2.0.30.pkg` になるため、リンクが [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg) になります。
1. ダウンロードしたファイルを実行し、その後は画面の指示に従います。AWS CLI バージョン 2 は以下の方法でインストールできます。
+ **コンピュータ上のすべてのユーザーが対象 ( が必要)`sudo`**
+ 任意のフォルダにインストールするか、推奨されるデフォルトのフォルダ `/usr/local/aws-cli` を選択できます。
+ インストーラによって、選択したインストールフォルダ内のメインプログラムにリンクするシンボリックリンクが `/usr/local/bin/aws` に自動的に作成されます。
+ **現在のユーザーのみが対象 ( は不要)`sudo`**
+ 書き込みアクセス許可がある任意のフォルダにインストールできます。
+ 標準のユーザー権限により、インストーラの完了後に、コマンドプロンプトで次のコマンドを使用して、`$PATH` および `aws` プログラムを指すシンボリックリンクファイルを `aws_completer` で手動で作成する必要があります。`$PATH` に書き込み可能なフォルダが含まれている場合、そのフォルダをターゲットのパスとして指定すると、`sudo` なしで以下のコマンドを実行できます。`$PATH` に書き込み可能なフォルダが含まれていない場合は、コマンドで `sudo` を使用して、指定したターゲットフォルダに対する書き込みアクセス許可を取得する必要があります。シンボリックリンクのデフォルトの場所は `/usr/local/bin/` です。
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
**注記**
インストーラの任意の場所で **Cmd \$1 L** キーを押すと、インストールのデバッグログを表示できます。これにより、ログをフィルター処理して保存できるログペインが開きます。また、ログファイルは `/var/log/install.log` に自動的に保存されます。
1. シェルが `aws` で `$PATH` コマンドを検索して実行できることを確認するには、次のコマンドを使用します。
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
#### [ Command line installer - All users ]
`sudo` 許可がある場合は、コンピュータ上のすべてのユーザー用に AWS CLI バージョン 2 をインストールできます。1 つの簡単な手順でグループのコピーと貼り付けができます。以下のステップの各行の説明を参照してください。
AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `AWSCLIV2-2.0.30.pkg` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
1. `curl` コマンドを使用して、ファイルをダウンロードします。`-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。この例では、ファイルは現在のフォルダ内の `AWSCLIV2.pkg` に書き込まれます。
AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `AWSCLIV2-2.0.30.pkg` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
1. ダウンロードした `installer` ファイルをソースとして指定して、標準の macOS `.pkg` プログラムを実行します。`-pkg` パラメータを使用して、インストールするパッケージの名前、およびパッケージをインストールするドライブの `-target /` パラメータを指定します。ファイルは `/usr/local/aws-cli` にインストールされ、シンボリックリンクが `/usr/local/bin` に自動的に作成されます。これらのフォルダに対する書き込みアクセス許可を付与するには、コマンドに `sudo` を含める必要があります。
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
インストールが完了すると、デバッグログが `/var/log/install.log` に書き込まれます。
1. シェルが `aws` で `$PATH` コマンドを検索して実行できることを確認するには、次のコマンドを使用します。
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
#### [ Command line - Current user ]
1. AWS CLI のインストール先フォルダを指定するには、XML ファイルを作成する必要があります。このファイルは、以下の例のような XML 形式のファイルです。値はすべてそのままにしておきます。ただし、9 行目のパス */Users/myusername* は、AWS CLI バージョン 2 をインストールするフォルダへのパスに置き換える必要があります。*フォルダはすでに存在している必要があります。存在しない場合、コマンドは失敗します。*この XML の例では、インストーラによってフォルダ AWS CLI に `/Users/myusername` という名前のフォルダが作成され、そこに `aws-cli` がインストールされることを指定します。
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. `pkg` コマンドを使用して `curl` インストーラをダウンロードします。`-o` オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。この例では、ファイルは現在のフォルダ内の `AWSCLIV2.pkg` に書き込まれます。
AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *2.0.30* のファイル名が `AWSCLIV2-2.0.30.pkg` になるため、コマンドは以下のようになります。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
1. 以下のオプションを使用して、標準の macOS `installer` プログラムを実行できます。
+ `-pkg` パラメータで、インストールするパッケージの名前を指定します。
+ `-target` パラメータを `CurrentUserHomeDirectory` に設定して、*現在のユーザーのみ*へのインストールを指定します。
+ `-applyChoiceChangesXML` パラメータで作成した XML ファイルのパス (現在のフォルダへの相対パス) と名前を指定します。
次の例では、フォルダ AWS CLI に `/Users/myusername/aws-cli` をインストールします。
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. 通常、標準のユーザーアクセス許可では `$PATH` 内のフォルダへの書き込みが許可されないため、このモードのインストーラは `aws` および `aws_completer` プログラムにシンボリックリンクを追加しようとしません。AWS CLI を正しく実行するには、インストーラの完了後にシンボリックリンクを手動で作成する必要があります。`$PATH` に書き込み可能なフォルダが含まれていて、そのフォルダをターゲットのパスとして指定すると、`sudo` なしで以下のコマンドを実行できます。`$PATH` に書き込み可能なフォルダが含まれていない場合は、`sudo` を使用して、指定したターゲットフォルダに対する書き込みアクセス許可を取得する必要があります。シンボリックリンクのデフォルトの場所は `/usr/local/bin/` です。
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
インストールが完了すると、デバッグログが `/var/log/install.log` に書き込まれます。
1. シェルが `aws` で `$PATH` コマンドを検索して実行できることを確認するには、次のコマンドを使用します。
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` コマンドが見つからない場合は、端末を再起動するか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
------
## Server
### インストール要件
+ インストールする AWS CLI バージョン 2 がリリースされています。バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
+ AWS CLI は、Microsoft がサポートする 64 ビット Windows のバージョンでサポートされています。
+ ソフトウェアをインストールするための管理者権限
### インストール手順
Windows で AWS CLI バージョン 2 の現在のインストールを更新するには、更新するたびに新しいインストーラをダウンロードして、以前のバージョンを上書きします。AWS CLI は定期的に更新されます。最新バージョンがいつリリースされたかを確認するには、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
1. 以下のいずれかの方法で、Windows 用の AWS CLI MSI インストーラ (64 ビット) をダウンロードして実行します。
+ **MSI インストーラのダウンロードと実行**し、AWS CLI の特定のバージョンのダウンロードリンクを作成するには、ファイル名にハイフンとバージョン番号を追加します。
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
この例では、バージョン *2.0.30* のファイル名が `AWSCLIV2-2.0.30.msi` になるため、リンクが [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi) になります。
+ **msiexec コマンドの使用**: または、`msiexec` コマンドへのリンクを追加することで、MSI インストーラを使用できます。AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
この例では、バージョン *2.0.30* のファイル名が `AWSCLIV2-2.0.30.msi` になるため、リンクが [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi) になります。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi
```
`msiexec` で使用できるさまざまなパラメータについては、*Microsoft Docs* ウェブサイトの [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) を参照してください。
バージョンのリストについては、*GitHub* の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
1. インストールを確認するには、[**スタート**] メニューを開き、`cmd` を検索してコマンドプロンプトウィンドウを開いて、コマンドプロンプトで `aws --version` コマンドを使用します。
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Windows がプログラムを見つけることができない場合、パスを更新するためにコマンドプロンプトウィンドウを閉じて再度開くか、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」のトラブルシューティングに従ってください。
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
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)」を参照してください。
## 次のステップ
[AWS CLI バージョン 2 を使用するための前提条件](getting-started-prereqs.md) の各ステップを実行したら、AWS CLI をインストールして [のセットアップAWS CLI](getting-started-quickstart.md) を実行する必要があります。
# ソースからの AWS CLI のビルドとインストール
このトピックでは、サポートされているオペレーティングシステムに AWS Command Line Interface (AWS CLI) の最新リリースをインストールまたは更新する方法について説明します。
AWS CLI の最新リリースについては、GitHub の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
**重要**
AWS CLI バージョン 1 と 2 では同じ `aws` コマンド名が使用されます。AWS CLI バージョン 1 を以前にインストールしている場合については、「[AWS CLI バージョン 2 の移行ガイド](cliv2-migration.md)」を参照してください。
**Topics**
+ [
## ソースからビルドする理由
](#source-getting-started-install-why)
+ [
## クイックステップ
](#source-getting-started-install-quicksteps)
+ [
## ステップ 1: すべての要件の設定
](#source-getting-started-install-reqs)
+ [
## ステップ 2: AWS CLI ソースインストールの構成
](#source-getting-started-install-config)
+ [
## ステップ 3: AWS CLI の構築
](#source-getting-started-install-build)
+ [
## ステップ 4: AWS CLI のインストール
](#source-getting-started-install-instructions)
+ [
## ステップ 5: インストールの検証
](#source-getting-started-install-verify)
+ [
## ワークフローの例
](#source-getting-started-install-workflows)
+ [
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
](#source-install-tshoot)
+ [
## 次のステップ
](#source-install-next-steps)
## ソースからビルドする理由
AWS CLI は、Docker イメージだけでなく、ほとんどのプラットフォームと環境用の[ビルド済みインストーラーとしても利用できます](getting-started-install.md)。
通常、これらのインストーラーはほとんどのユースケースに対応しています。ソースからインストールする手順は、インストーラーがカバーしていないユースケースに役立てるためのものです。ユースケースには次のようなものがあります。
+ ビルド済みインストーラーは、使用中の環境をサポートしていません。例えば、ARM 32 ビット版はビルド済みインストーラーではサポートされていません。
+ ビルド済みインストーラーには、使用中の環境にはない依存関係があります。例えば、Alpine Linux では [https://musl.libc.org/](https://musl.libc.org/) を使用していますが、現在のインストーラーでは `glibc` が必要になるため、ビルド済みインストーラーがすぐに動作しません。
+ ビルド済みインストーラーには、使用中の環境によってアクセスが制限されているリソースが必要です。例えば、セキュリティが強化されたシステムでは、共有メモリへのアクセス許可が与えられない場合があります。これはフリーズした `aws` インストーラーに必要です。
+ コードとパッケージのビルドプロセスは完全に制御されることが望ましいため、ビルド済みインストーラーは、パッケージマネージャーのメンテナンス担当者にとって障害となることがよくあります。ソースからビルドすることで、ディストリビューションのメンテナンス担当者は AWS CLI を更新し続けるためのプロセスをより合理化できます。メンテナンス担当者は、`brew`、`yum`、`apt` などのサードパーティーのパッケージマネージャーからインストールする際に、AWS CLI のより最新のバージョンをお客様に提供できるようになります。
+ AWS CLI の機能をパッチするお客様は、ソースから AWS CLI をビルドしてインストールする必要があります。これは、AWS CLI GitHub リポジトリに変更を投稿する前に、ソースに加えた変更をテストすることを望むコミュニティメンバーにとって特に重要です。
## クイックステップ
**注記**
すべてのコード例は、ソースディレクトリのルートから実行されることを前提としています。
ソースから AWS CLI をビルドしてインストールするには、このセクションの手順に従ってください。AWS CLI は、[GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html) を利用してソースからインストールします。最も単純なケースでは、AWS CLI GitHub リポジトリのルートからデフォルトのサンプルコマンドを実行することで、AWS CLI をソースからインストールできます。
1. [環境のすべての要件を設定します。](#source-getting-started-install-reqs)これには、[GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html) が生成したファイルを実行できること、Python 3.8 以降がインストールされていることが含まれます。
1. ターミナルで、AWS CLI ソースフォルダの最上位レベルに移動し、`./configure` コマンドを実行します。このコマンドは、必要とされるすべての依存関係についてシステムをチェックし、検出され指定された構成に基づいて、AWS CLI をビルドおよびインストールするための `Makefile` を生成します。
------
#### [ Linux and macOS ]
次の `./configure` コマンド例では、デフォルト設定を使用して AWS CLI 用のビルド構成を設定します。
```
$ ./configure
```
------
#### [ Windows PowerShell ]
MSYS2 を呼び出すコマンドを実行する前に、現在の作業ディレクトリを保存する必要があります。
```
PS C:\> $env:CHERE_INVOKING = 'yes'
```
次に、次の `./configure` コマンド例を使用して、Python 実行ファイルへのローカルパスを使用し、C:\$1Program Files\$1AWSCLI にインストールし、すべての依存関係をダウンロードするための AWS CLI 用のビルド構成を設定します。
```
PS C:\> C:\msys64\usr\bin\bash -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
```
------
詳細、使用可能な構成オプション、およびデフォルト設定情報については、「[ステップ 2: AWS CLI ソースインストールの構成](#source-getting-started-install-config)」セクションを参照してください。
1. `make` コマンドを実行します。このコマンドは、ご使用の構成設定に従って AWS CLI をビルドします。
次の `make` コマンド例は、既存の `./configure` 設定を使用してデフォルトオプションでビルドされます。
------
#### [ Linux and macOS ]
```
$ make
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "make"
```
------
詳細と使用可能なビルドオプションについては、「[ステップ 3: AWS CLI の構築](#source-getting-started-install-build)」セクションを参照してください。
1. `make install` コマンドを実行します。このコマンドは、ビルドされた AWS CLI をご使用のシステム上で構成された場所にインストールします。
次の `make install` コマンド例では、デフォルトのコマンド設定を使用して、ビルドされた AWS CLI をインストールし、構成された場所にシンボリックリンクを作成します。
------
#### [ Linux and macOS ]
```
$ make install
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "make install"
```
インストール後、以下を使用して AWS CLI にパスを追加します。
```
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
```
------
詳細と使用可能なインストールオプションについては、「[ステップ 4: AWS CLI のインストール](#source-getting-started-install-instructions)」セクションを参照してください。
1. 次のコマンドを使用して、AWS CLI が正常にインストールされたことを確認します。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
インストールエラーのトラブルシューティングの手順については、「[AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング](#source-install-tshoot)」セクションを参照してください。
## ステップ 1: すべての要件の設定
ソースから AWS CLI をビルドするには、事前に以下を完了しておく必要があります。
**注記**
すべてのコード例は、ソースディレクトリのルートから実行されることを前提としています。
1. AWS CLI GitHub リポジトリをフォークするか、ソースの tarball をダウンロードして、AWS CLI ソースをダウンロードします。手順は、以下のいずれかです。
+ GitHub から [AWS CLI リポジトリ](https://github.com/aws/aws-cli)のクローンをフォークして作成します。詳細については、「GitHub Docs」の「[Fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo)」(レポジトリのフォーク) を参照してください。
+ 次のコマンドを使用して、[https://awscli.amazonaws.com/awscli.tar.gz](https://awscli.amazonaws.com/awscli.tar.gz) から最新のソースターボールをダウンロードし、コンテンツを抽出します。
```
$ curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscli.tar.gz"
$ tar -xzf awscli.tar.gz
```
**注記**
特定のバージョンをダウンロードするには、次のリンク形式を使用してください。[https://awscli.amazonaws.com/awscli-*versionnumber* .tar.gz](https://awscli.amazonaws.com/awscli.tar.gz)
たとえば、バージョン 2.10.0 の場合、リンクは次のようになります。[https://awscli.amazonaws.com/awscli-*2.10.0* .tar.gz](https://awscli.amazonaws.com/awscli.tar.gz)
ソースバージョンは、AWS CLI の **2.10.0** のバージョン以降で使用できます。
**(オプション) 以下の手順を完了してダウンロードした zip ファイルの整合性を確認する**
1. `GnuPG` ツールを使用してこの署名を検証するには、次のステップを行います。
AWS CLI インストーラパッケージの `.zip` ファイルは、PGP 署名を使用して暗号化で署名されます。ファイルの破損や変更がある場合、この検証は失敗します。その場合、インストールを続行しないでください。
1. ご利用のパッケージマネージャーを使用し、`gpg` コマンドをダウンロードしてインストールします。`GnuPG` の詳細については、[GnuPG のウェブサイト](https://www.gnupg.org/)を参照してください。
1. パブリックキーファイルを作成するには、テキストファイルを作成し、次のテキストに貼り付けます。
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
参考までに、パブリックキーの詳細を以下に示します。
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. 次のコマンドで AWS CLI パブリックキーをインポートします。*public-key-file-name* は、作成したパブリックキーのファイル名に置き換えます。
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. ダウンロードしたパッケージの AWS CLI 署名ファイルを [https://awscli.amazonaws.com/awscli.tar.gz.sig](https://awscli.amazonaws.com/awscli.tar.gz.sig) でダウンロードします。これは、対応する tarball ファイルと同じパスと名前を持っていますが、拡張子は `.sig` です。tarball ファイルと同じパスに保存します。または、次のコマンドブロックを使用します。
```
$ curl awscliv2.sig https://awscli.amazonaws.com/ -o awscli.tar.gz.sig
```
1. 署名を検証し、`.sig` ファイル名と `.zip` ファイル名の両方をパラメータとして `gpg` コマンドに渡します。
```
$ gpg --verify awscliv2.sig awscli.tar.gz
```
出力は以下の例のようになります。
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**重要**
出力内の警告は予想されており、問題を示すものではありません。これは、個人用の PGP キー (持っている場合) と AWS CLI PGP キーの間に信頼チェーンがないために表示されます。詳細については、「[信用の輪 (Web of Trust)](https://wikipedia.org/wiki/Web_of_trust)」を参照してください。
1. `configure` や `Makefile` などの [GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html) で生成されたファイルを実行できる環境があります。これらのファイルは POSIX プラットフォーム間で幅広く移植可能です。
------
#### [ Linux and macOS ]
ご使用の環境に Autotools がまだインストールされていない場合、または更新する必要がある場合は、「*GNU ドキュメント*」の「[Autotools を (ユーザーとして) インストールする方法](https://www.gnu.org/software/automake/faq/autotools-faq.html#How-do-I-install-the-Autotools-_0028as-user_0029_003f)」、または「[基本インストール](https://www.gnu.org/savannah-checkouts/gnu/automake/manual/automake.html#Basic-Installation)」に記載されているインストール手順に従ってください。
------
#### [ Windows PowerShell ]
**警告**
Windows 環境の場合は、ビルド済みインストーラーを使用することをお勧めします。ビルド済みインストーラーのインストール手順については、「[AWS CLI の最新バージョンのインストールまたは更新](getting-started-install.md)」を参照してください
Windows には POSIX に準拠したシェルが付属していないため、ソースから AWS CLI をインストールするには追加のソフトウェアをインストールする必要があります。[MSYS2](https://www.msys2.org/) には、Windows ソフトウェアのビルドとインストールに役立つツールとライブラリのコレクション、特に Autotools が使用する POSIX ベースのスクリプト向けのものが用意されています。
1. MSYS2 をインストールします。MSYS2 のインストールと使用方法については、「*MSYS2 ドキュメント*」の「[インストールと使用手順](https://www.msys2.org/)」を参照してください。
1. MSYS2 ターミナルを開き、次のコマンドを使用して Autotools をインストールします。
```
$ pacman -S autotools
```
**注記**
このガイドの Windows 用の構成、ビルド、インストールのコード例を使用する場合、デフォルトの MSYS2 インストールパスは `C:\msys64\usr\bin\bash` であることを前提としています。PowerShell 内で MSYS2 を呼び出すときは、bash コマンドを引用符で囲んだ次の形式を使用します。
```
PS C:\> C:\msys64\usr\bin\bash -lc "command example"
```
次のコマンド例では、`./configure` コマンドを呼び出します。
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
```
------
1. Python 3.8 以降のインタープリタがインストールされています。必要な Python の最低バージョンは、公式の「[AWS SDK とツール用の Python サポートポリシー](https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)」と同じタイムラインに従います。インタープリタは、サポート終了日から 6 か月間のみサポートされます。
1. **(オプション)** AWS CLI のビルドとランタイム Python ライブラリの依存関係をすべてインストールします。`./configure` コマンドは、不足している依存関係がないかどうか、また、そのインストール方法について通知します。
これらの依存関係は、構成で自動的にインストールして使用できます。詳細については、「[依存関係のダウンロード](#source-getting-started-install-config-dependencies)」を参照してください。
## ステップ 2: AWS CLI ソースインストールの構成
AWS CLI をビルドおよびインストールするための構成は、`configure` スクリプトを使用して指定されます。すべての構成オプションを文書化するには、`--help` オプションを使用して `configure` スクリプトを実行します。
------
#### [ Linux and macOS ]
```
$ ./configure --help
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure --help"
```
------
**Topics**
+ [
### インストール場所
](#source-getting-started-install-config-location)
+ [
### Python インタープリタ
](#source-getting-started-install-config-interpreter)
+ [
### 依存関係のダウンロード
](#source-getting-started-install-config-dependencies)
+ [
### インストールタイプ
](#source-getting-started-install-config-type)
### インストール場所
AWS CLI のソースインストールでは、次の 2 つの構成可能なディレクトリを使用して AWS CLI をインストールします。
+ `libdir` - AWS CLI をインストールする親ディレクトリ。AWS CLI インストールへのパスは `/aws-cli` です。Linux と macOS のデフォルト `libdir` 値は `/usr/local/lib` で、デフォルトのインストールディレクトリを `/usr/local/lib/aws-cli` にします
+ `bindir` - AWS CLI 実行ファイルがインストールされているディレクトリ。デフォルトの場所は `/usr/local/bin` です。
以下の `configure` オプションは使用するディレクトリを制御します。
+ `--prefix` - インストールに使用するディレクトリプレフィックスを設定します。Linux と macOS のデフォルト値は `/usr/local` です。
+ `--libdir` - AWS CLI のインストールに使用する `libdir` を設定します。デフォルト値は `/lib` です。`--libdir` と `--prefix` が両方とも指定されていない場合、Linux と macOS のデフォルトは `/usr/local/lib/` です。
+ `--bindir` - AWS CLI `aws`、および `aws_completer` 実行ファイルのインストールに使用する `bindir` を設定します。デフォルト値は `/bin` です。`bindir` と `--prefix` が両方とも指定されていない場合、Linux と macOS のデフォルトは `/usr/local/bin/` です。
------
#### [ Linux and macOS ]
次のコマンド例では、`--prefix` オプションを使用して AWS CLI をローカルユーザーにインストールします。このコマンドは、AWS CLI を `$HOME/.local/lib/aws-cli` にインストールし、実行ファイルを `$HOME/.local/bin` にインストールします。
```
$ ./configure --prefix=$HOME/.local
```
次のコマンド例では、`--libdir` オプションを使用して、AWS CLI をアドオンアプリケーションとして `/opt` ディレクトリにインストールします。このコマンドは、AWS CLI を `/opt/aws-cli` にインストールし、実行ファイルを `/usr/local/bin` のデフォルトの場所にインストールします。
```
$ ./configure --libdir=/opt
```
------
#### [ Windows PowerShell ]
次のコマンド例では、`--prefix` オプションを使用して AWS CLI をローカルユーザーにインストールします。このコマンドは、AWS CLI を `$HOME/.local/lib/aws-cli` にインストールし、実行ファイルを `$HOME/.local/bin` にインストールします。
```
$ C:\msys64\usr\bin\bash -lc "./configure --prefix='C:\Program Files\AWSCLI'"
```
次のコマンド例では、`--libdir` オプションを使用して、AWS CLI をアドオンアプリケーションとして `/opt` ディレクトリにインストールします。このコマンドは AWS CLI を `C:\Program Files\AWSCLI\opt\aws-cli` にインストールします。
------
### Python インタープリタ
**注記**
Windows にインストールする場合は、Python インタープリタを指定することを強くお勧めします。
`./configure` スクリプトは、インストールされている Python 3.8 以降のインタープリタを自動的に選択し、[https://www.gnu.org/software/automake/manual/html_node/Python.html](https://www.gnu.org/software/automake/manual/html_node/Python.html) Autoconf マクロを使用して AWS CLI のビルドと実行に使用します。
使用する Python インタープリタは、`configure` スクリプトの実行時に `PYTHON` 環境変数を使用して明示的に設定できます。
------
#### [ Linux and macOS ]
```
$ PYTHON=/path/to/python ./configure
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "PYTHON='C:\path\to\python' ./configure"
```
------
### 依存関係のダウンロード
デフォルトでは、AWS CLI のすべてのビルドとランタイムの依存関係がシステムに既にインストールされている必要があります。これには Python ライブラリの依存関係も含まれます。`configure` スクリプトの実行時にすべての依存関係がチェックされ、システムに Python の依存関係がない場合、`configure` スクリプトはエラーになります。
次のコード例は、システムに依存関係がない場合にエラーになります。
------
#### [ Linux and macOS ]
```
$ ./configure
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
File "", line 198, in _run_module_as_main
File "", line 88, in _run_code
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in
main()
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
parsed_args.func(parsed_args)
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
validate_env(parsed_args.artifact)
File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:
awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)
We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.
If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'
configure: error: "Python dependencies not met."
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
File "", line 198, in _run_module_as_main
File "", line 88, in _run_code
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in
main()
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
parsed_args.func(parsed_args)
File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
validate_env(parsed_args.artifact)
File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:
awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)
We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.
If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'
configure: error: "Python dependencies not met."
```
------
必要な Python 依存関係を自動的にインストールするには、`--with-download-deps` オプションを使用してください。このフラグを使用すると、ビルドプロセスは次の処理を行います。
+ Python ライブラリの依存関係チェックをスキップします。
+ 必要な Python の依存関係をすべてダウンロードし、ダウンロードした依存関係**だけ**を使用して、`make` ビルド中に AWS CLI をビルドするように構成します。
以下の configure コマンドの例では、`--with-download-deps` オプションを使用して Python の依存関係をダウンロードおよび使用しています。
------
#### [ Linux and macOS ]
```
$ ./configure --with-download-deps
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure --with-download-deps"
```
------
### インストールタイプ
ソースインストールのプロセスでは、次のインストールタイプがサポートされます。
+ `system-sandbox` - **(デフォルト)** 隔離された Python 仮想環境を作成し、AWS CLI を仮想環境にインストールし、仮想環境内の `aws` および `aws_completer` 実行ファイルへのシンボリックリンクを作成します。この AWS CLI のインストールは、ランタイム用に選択した Python インタープリタに直接依存します。
これは、AWS CLI をシステムにインストールするための軽量なインストールメカニズムで、Python のベストプラクティスに従い、仮想環境でインストールをサンドボックス化します。このインストールは、Python のインストールと連動して、可能な限りスムーズな方法でソースから AWS CLI をインストールすることを希望するお客様を対象としています。
+ `portable-exe` - AWS CLI をフリーズして、同様のアーキテクチャの環境に配布できるスタンドアロンの実行ファイルにします。これは、AWS CLI の公式ビルド済み実行ファイルを生成するのと同じプロセスです。`portable-exe` は、AWS CLI のランタイムに使用する `configure` ステップで選択した Python インタープリタのコピーをフリーズします。これにより、Python インタープリタがない他のマシンに移動させることができます。
このタイプのビルドは、AWS CLI インストールと、環境にインストールされた Python バージョンが連動していないことを確認でき、Python がまだインストールされていない他のシステムにビルドを配布できるので便利です。これにより、使用する AWS CLI 実行ファイルの依存関係とセキュリティを制御できます。
インストールタイプを構成するには、`--with-install-type` オプションを使用して `portable-exe` または `system-sandbox` の値を指定します。
次の `./configure` コマンド例は、`portable-exe` の値を指定します。
------
#### [ Linux and macOS ]
```
$ ./configure --with-install-type=portable-exe
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "./configure --with-install-type=portable-exe"
```
------
## ステップ 3: AWS CLI の構築
`make` コマンドを使用して、ご使用の構成設定を使用して AWS CLI をビルドします。
------
#### [ Linux and macOS ]
```
$ make
```
------
#### [ Windows PowerShell ]
```
PS C:\> C:\msys64\usr\bin\bash -lc "make"
```
------
**注記**
仮想環境は、Python [https://docs.python.org/3/library/venv.html](https://docs.python.org/3/library/venv.html) モジュールを使用してビルドディレクトリに作成されます。仮想環境は、[Python 標準ライブラリにベンダリングされているバージョンの pip](https://docs.python.org/3/library/ensurepip.html) でブートストラップされます。
Python ライブラリの依存関係をコピーします。`configure` コマンドで `--with-download-deps` フラグが指定されているかどうかに応じて、このステップは次のいずれかを実行します。
`--with-download-deps` は指定**されます**。Python の依存関係は pip でインストールされます。これには、`wheel`、`setuptools`、およびすべての AWS CLI ランタイム依存関係が含まれます。`portable-exe` をビルドしている場合は、`pyinstaller` がインストールされます。これらの要件はすべて、[https://github.com/jazzband/pip-tools](https://github.com/jazzband/pip-tools) から生成されるロックファイルで指定されています。
`--with-download-deps` は指定**されません**。Python インタープリタのサイトパッケージの Python ライブラリとスクリプト (例: `pyinstaller`) は、ビルドに使用されている仮想環境にコピーされます。
AWS CLI コードベース上で `pip install` を直接実行して、オフラインでツリー内ビルドを行い、ビルド仮想環境に AWS CLI をインストールします。このインストールでは、pip フラグ [--no-build-isolation](https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-no-build-isolation)、[--use-feature=in-tree-build](https://pip.pypa.io/en/stable/cli/pip_install/#local-project-installs)、[--no-cache-dir](https://pip.pypa.io/en/stable/cli/pip_install/#caching)、および [https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-no-index](https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-no-index) を使用します。
**(オプション)** `configure` コマンドで `--install-type` が `portable-exe` に設定されている場合、[https://www.pyinstaller.org/](https://www.pyinstaller.org/) を使用してスタンドアロン実行ファイルをビルドします。
## ステップ 4: AWS CLI のインストール
`make install` コマンドは、ビルドされた AWS CLI をシステム上で構成された場所にインストールします。
------
#### [ Linux and macOS ]
以下のコマンド例では、構成とビルド設定を使用して AWS CLI をインストールします。
```
$ make install
```
------
#### [ Windows PowerShell ]
以下のコマンド例では、構成とビルド設定を使用して AWS CLI をインストールし、AWS CLI のパスを含む環境変数を追加します。
```
PS C:\> C:\msys64\usr\bin\bash -lc " make install "
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
```
------
`make install` ルールは [https://www.gnu.org/software/make/manual/html_node/DESTDIR.html#DESTDIR](https://www.gnu.org/software/make/manual/html_node/DESTDIR.html#DESTDIR) 変数をサポートします。この変数を指定すると、AWS CLI をインストールするときに、既に構成されているインストールパスの前に、指定されたパスが追加されます。デフォルトでは、この変数には値が設定されていません。
------
#### [ Linux and macOS ]
次のコード例では、`--prefix=/usr/local` フラグを使用してインストール場所を構成し、`DESTDIR=/tmp/stage` を `make install` コマンドに使用してその宛先を変更します。これらのコマンドを実行すると、AWS CLI が `/tmp/stage/usr/local/lib/aws-cli` にインストールされ、その実行ファイルが `/tmp/stage/usr/local/bin` に配置されます。
```
$ ./configure --prefix=/usr/local
$ make
$ make DESTDIR=/tmp/stage install
```
------
#### [ Windows PowerShell ]
次のコード例では、`--prefix=\awscli` フラグを使用してインストール場所を構成し、`DESTDIR=C:\Program Files` を `make install` コマンドに使用してその宛先を変更します。これらのコマンドを実行すると、AWS CLI が `C:\Program Files\awscli` にインストールされます。
```
$ ./configure --prefix=\awscli
$ make
$ make DESTDIR='C:\Program Files' install
```
------
**注記**
次のいずれかを構成済みのインストールディレクトリに移動します。
インストールタイプが `system-sandbox` の場合、ビルドした仮想環境を移動します。
インストールタイプが `portable-exe` の場合、ビルドしたスタンドアロン実行ファイルを移動します。
構成した bin ディレクトリで、`aws` および `aws_completer` 実行ファイルの両方にシンボリックリンクを作成します。
## ステップ 5: インストールの検証
次のコマンドを使用して、AWS CLI が正常にインストールされたことを確認します。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
`aws` コマンドが認識されない場合は、新しいシンボリックリンクを更新するために、ターミナルの再起動が必要になる場合があります。AWS CLI のインストールまたはアンインストール後に、さらに問題が発生した場合の一般的なトラブルシューティングの手順については、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください
## ワークフローの例
このセクションでは、ソースからインストールするための基本的なワークフローの例をいくつか紹介します。
### Linux および macOS の基本的なインストール
次の例は、AWS CLI を `/usr/local/lib/aws-cli` のデフォルトの場所にインストールする基本的なインストールワークフローです。
```
$ cd path/to/cli/respository/
$ ./configure
$ make
$ make install
```
### Windows 自動インストール
**注記**
このワークフローを使用するには、管理者として PowerShell を実行している必要があります。
MSYS2 は、CI 環境で自動化された方法で使用できます。「*MSYS2 ドキュメント*」の「[CI での MSYS2 の使用](https://www.msys2.org/docs/ci/)」を参照してください。
------
#### [ Downloaded Tarball ]
`awscli.tar.gz` ファイルをダウンロードし、解凍して、AWS CLI をインストールします。次のコマンドを使用する場合は、次のパスを置き換えます。
+ `C:\msys64\usr\bin\bash` をご使用の MSYS2 パスの場所にします。
+ `.\awscli-2.x.x\` を解凍した `awscli.tar.gz` フォルダ名にします。
+ `PYTHON='C:\path\to\python.exe'` をローカルの Python パスにします。
次のコード例では、MSYS2 を使用して PowerShell からの AWS CLI のビルドとインストールを自動化し、使用する Python のローカルインストールを指定します。
```
PS C:\> curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscliv2.zip" # Download the awscli.tar.gz file in the current working directory
PS C:\> tar -xvzf .\awscli.tar.gz # Extract awscli.tar.gz file
PS C:\> cd .\awscli-2.x.x\ # Navigate to the root of the extracted files
PS C:\> $env:CHERE_INVOKING = 'yes' # Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
PS C:\> C:\msys64\usr\bin\bash -lc "make"
PS C:\> C:\msys64\usr\bin\bash -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 source-sandbox/AMD64
```
------
#### [ GitHub Repository ]
`awscli.tar.gz` ファイルをダウンロードし、解凍して、AWS CLI をインストールします。次のコマンドを使用する場合は、次のパスを置き換えます。
+ `C:\msys64\usr\bin\bash` をご使用の MSYS2 パスの場所にします。
+ `C:path\to\cli\repository\` を *GitHub* からクローンした [AWS CLI リポジトリ](https://github.com/aws/aws-cli)へのパスにします。詳細については、「*GitHub Docs*」の「[レポジトリのフォーク](https://docs.github.com/en/get-started/quickstart/fork-a-repo)」を参照してください。
+ `PYTHON='C:\path\to\python.exe'` をローカルの Python パスにします。
次のコード例では、MSYS2 を使用して PowerShell からの AWS CLI のビルドとインストールを自動化し、使用する Python のローカルインストールを指定します。
```
PS C:\> cd C:path\to\cli\repository\
PS C:\> $env:CHERE_INVOKING = 'yes' # Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
PS C:\> C:\msys64\usr\bin\bash -lc "make"
PS C:\> C:\msys64\usr\bin\bash -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
```
------
### Alpine Linux コンテナ
以下は、[Alpine 用のビルド済みバイナリの代わり](https://github.com/aws/aws-cli/issues/4685)として、Alpine Linux コンテナに AWS CLI を正常にインストールするために使用できる Dockerfile の例です。この例を使用する場合は、*AWSCLI\$1VERSION* を目的の AWS CLI バージョン番号に置き換えてください。
```
1. FROM python:3.8-alpine AS builder
2.
3. ENV AWSCLI_VERSION=2.10.1
4.
5. RUN apk add --no-cache \
6. curl \
7. make \
8. cmake \
9. gcc \
10. g++ \
11. libc-dev \
12. libffi-dev \
13. openssl-dev \
14. && curl https://awscli.amazonaws.com/awscli-${AWSCLI_VERSION}.tar.gz | tar -xz \
15. && cd awscli-${AWSCLI_VERSION} \
16. && ./configure --prefix=/opt/aws-cli/ --with-download-deps \
17. && make \
18. && make install
19.
20. FROM python:3.8-alpine
21.
22. RUN apk --no-cache add groff
23.
24. COPY --from=builder /opt/aws-cli/ /opt/aws-cli/
25.
26. ENTRYPOINT ["/opt/aws-cli/bin/aws"]
```
このイメージは、Amazon Linux 2 でビルドされたものと同様のコンテナからビルドされ、AWS CLI で呼び出されます。
```
$ docker build --tag awscli-alpine .
$ docker run --rm -it awscli-alpine --version
aws-cli/2.2.1 Python/3.8.11 Linux/5.10.25-linuxkit source-sandbox/x86_64.alpine.3 prompt/off
```
このイメージの最終的なサイズは、公式の AWS CLI Docker イメージ以下のサイズです。公式の Docker イメージについては、「[AWS CLI に対して公式の Amazon ECR Public イメージまたは Docker イメージを実行する](getting-started-docker.md)」を参照してください。
## 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)」を参照してください。
トラブルシューティングガイドに記載されていない問題については、*GitHub* の [AWS CLI リポジトリ](https://github.com/aws/aws-cli/labels/source-distribution)で `source-distribution` ラベルの付いた問題を検索してください。既存の問題にエラーが取り上げられていない場合は、[新しい問題を作成](https://github.com/aws/aws-cli/issues/new?assignees=&labels=source-distribution%2Cneeds-triage&template=source-distribution.yml&title=%28short+issue+description%29)して、AWS CLI メンテナンス担当者からサポートを受けてください。
## 次のステップ
AWS CLI のインストール後に、[のセットアップAWS CLI](getting-started-quickstart.md) を実行してください。
# AWS CLI に対して公式の Amazon ECR Public イメージまたは Docker イメージを実行する
このトピックでは、Amazon Elastic Container Registry Public (Amazon ECR Public) または Docker Hub の公式イメージを使用して Docker で AWS CLI バージョンの実行、バージョン管理、設定を行う方法について説明します。Docker の使用方法の詳細については、[Docker のドキュメント](https://docs.docker.com/)を参照してください。
公式イメージは、AWS が直接サポートおよび維持する分離、移植性、セキュリティを提供します。これにより、インストールを自分で管理しなくても、コンテナベースの環境で AWS CLI バージョン 2 を使用できるようになります。
**Topics**
+ [
## 前提条件
](#cliv2-docker-prereq)
+ [
## Amazon ECR Public と DockerHub のどちらを選択するか
](#cliv2-docker-versus)
+ [
## AWS CLI バージョン 2 の公式イメージを実行する
](#cliv2-docker-install)
+ [
## 公式イメージのインターフェイスと下位互換性に関する注意事項
](#cliv2-docker-install-notes)
+ [
## 特定のバージョンとタグの使用
](#cliv2-docker-upgrade)
+ [
## 最新の公式イメージに更新する
](#cliv2-docker-update)
+ [
## ホストファイル、認証情報、環境変数、構成を共有する
](#cliv2-docker-share-files)
+ [
## docker run コマンドの短縮
](#cliv2-docker-aliases)
## 前提条件
Docker がインストールされている必要があります。インストール手順については、[Docker のウェブサイト](https://docs.docker.com/install/)を参照してください。
Docker のインストールを確認するには、次のコマンドを実行し、出力があることを確認します。
```
$ docker --version
Docker version 19.03.1
```
## Amazon ECR Public と DockerHub のどちらを選択するか
AWS CLI イメージには、Docker Hub ではなく、Amazon ECR Public を使用することをお勧めします。Docker Hubでは、一般消費者向けのレート制限が厳しくなっているため、スロットリングの問題が発生する可能性があります。さらに、Amazon ECR Public は、複数のリージョンにイメージをレプリケートして、高い可用性を実現し、リージョンの停止問題に対処します。
Docker Hub のレート制限の詳細については、*Docker* ウェブサイトの「[Understanding Docker Hub Rate Limiting (Docker Hub のレート制限とは)](https://www.docker.com/increase-rate-limits/)」を参照してください。
## AWS CLI バージョン 2 の公式イメージを実行する
`docker run` コマンドを初めて使用すると、最新のイメージがコンピュータにダウンロードされます。それ以降の `docker run` コマンドの使用は、ローカルコピーから実行されます。
AWS CLI バージョン 2 Docker イメージを実行するには、`docker run` コマンドを使用します。
------
#### [ Amazon ECR Public ]
AWS CLI バージョン 2 の Amazon ECR Public の公式イメージは、Amazon ECR Public の [`aws-cli/aws-cli` リポジトリ](https://gallery.ecr.aws/aws-cli/aws-cli)でホストされます。
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli command
```
------
#### [ Docker Hub ]
AWS CLI バージョン 2 の Docker の公式イメージは、Docker Hub の `amazon/aws-cli` リポジトリでホストされます。
```
$ docker run --rm -it amazon/aws-cli command
```
------
コマンドの機能は次のとおりです。
+ `docker run --rm -it repository/name` — `aws` 実行可能ファイルと同等です。このコマンドを実行するたびに、Docker はダウンロードしたイメージのコンテナをスピンアップし、`aws` コマンドを実行します。デフォルトで、イメージは AWS CLI バージョン 2 の最新バージョンを使用します。
例えば、Docker で `aws --version` コマンドを呼び出すには、以下を実行します。
------
#### [ Amazon ECR Public ]
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli --version
aws-cli/2.27.41 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
```
------
#### [ Docker Hub ]
```
$ docker run --rm -it amazon/aws-cli --version
aws-cli/2.27.41 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
```
------
+ `--rm` - コマンドが終了後にコンテナをクリーンアップすることを指定します。
+ `-it` - で疑似 TTY をで開くように指定します。`stdin`これにより、コンテナで実行中でも、例えば `aws help` コマンドや `aws configure` コマンドを使用して、AWS CLI バージョン 2 に入力を提供できるようになります。`-it` を省略する場合は、以下の点を考慮してください。
+ スクリプトを実行している場合は、`-it` は不要です。
+ スクリプトでエラーが発生する場合は、Docker 呼び出しから `-it` を省略することで問題が解決する場合があります。
+ パイプ出力を実行しようとすると `-it` でエラーの原因となることがあり、Docker 呼び出しから `-it` を省略することで、この問題が解決する場合があります。`-it` フラグを保持したままパイプ出力を実行する場合は、デフォルトで使用されている[クライアント側のページャー](cli-usage-pagination.md#cli-usage-pagination-clientside) AWS CLI を無効にすることで問題が解決できます。
`docker run` コマンドの詳細については、[Docker reference guide](https://docs.docker.com/engine/reference/run/) を参照してください。
## 公式イメージのインターフェイスと下位互換性に関する注意事項
+ イメージでサポートされる唯一のツールは AWS CLI です。必ず、`aws` 実行可能ファイルは直接実行する必要があります。例えば、`less` および `groff` がイメージに明示的にインストールされていても、AWS CLI コマンド以外では直接実行できません。
+ `/aws` 作業ディレクトリは、ユーザーによってコントロールします。AWS CLI コマンドを実行することでユーザーから指示されない限り、イメージはこのディレクトリに書き込まれません。
+ 最新のタグに依存する場合、下位互換性は保証されません。下位互換性を保証するには、特定の `` タグに固定する必要があります。このタグはイミュータブルであり、1 回 のみプッシュされます。
## 特定のバージョンとタグの使用
AWS CLI バージョン 2 の公式イメージには、使用できる複数のバージョン (`2.0.6` バージョン以降) があります。AWS CLI バージョン 2 の特定バージョンを実行するには、適切なタグを `docker run` コマンドに付加します。初めてタグを指定して `docker run` コマンドを使用すると、そのタグの最新のイメージがコンピュータにダウンロードされます。それ以降、そのタグで `docker run` コマンドを使用する場合は、ローカルコピーから実行されます。
次の 2 種類のタグを使用できます。
+ `latest` – イメージの AWS CLI バージョン 2 の最新バージョンを定義します。AWS CLI バージョン 2 の最新バージョンを使用する場合は、`latest` タグを使用することをお勧めします。ただし、このタグに依存する場合の下位互換性は保証されません。`latest` タグは、`docker run` コマンドでデフォルトで使用されます。`latest` タグを明示的に使用するには、タグをコンテナイメージ名に追加します。
------
#### [ Amazon ECR Public ]
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli:latest command
```
------
#### [ Docker Hub ]
```
$ docker run --rm -it amazon/aws-cli:latest command
```
------
+ `` – イメージの AWS CLI バージョン 2 の特定バージョンを定義します。公式イメージを本番環境で使用する予定の場合は、下位互換性を確保するために、AWS CLI バージョン 2 の特定バージョンを使用することをお勧めします。例えば、バージョン `2.0.6` を実行するには、コンテナイメージ名にバージョンを追加します。
------
#### [ Amazon ECR Public ]
```
$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli:2.0.6 command
```
------
#### [ Docker Hub ]
```
$ docker run --rm -it amazon/aws-cli:2.0.6 command
```
------
## 最新の公式イメージに更新する
最新のイメージは、`docker run` コマンドの初回使用時にのみコンピュータにダウンロードされるため、更新したイメージは手動でプルする必要があります。手動で最新バージョンに更新するには、`latest` タグ付きイメージをプルすることをお勧めします。イメージをプルすると、コンピュータに最新バージョンがダウンロードされます。
------
#### [ Amazon ECR Public ]
```
$ docker pull public.ecr.aws/aws-cli/aws-cli:latest
```
------
#### [ Docker Hub ]
```
$ docker pull amazon/aws-cli:latest
```
------
## ホストファイル、認証情報、環境変数、構成を共有する
AWS CLI バージョン 2 はコンテナで実行されるため、CLI はデフォルトでホストファイルシステムにアクセスできません。これには、設定と認証情報が含まれます。ホストファイルシステム、認証情報、および設定をコンテナと共有するには、ホストシステムの `~/.aws` ディレクトリを `/root/.aws` のコンテナにマウントして、`-v` コマンドに `docker run` フラグを付けます。これにより、コンテナで実行されている AWS CLI バージョン 2 がホストファイル情報を検索できるようになります。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli command
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli command
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli command
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli command
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws amazon/aws-cli command
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws amazon/aws-cli command
```
------
`-v` フラグとマウントの詳細については、[Docker reference guide](https://docs.docker.com/storage/volumes/) を参照してください。
**注記**
`config` および `credentials` の詳細については、「[Configuration and credential file settings in the AWS CLI](cli-configure-files.md)」を参照してください。
### 例 1: 認証情報と設定の提供
この例では、Amazon Simple Storage Service (Amazon S3) でバケットを一覧表示する `s3 ls` コマンドの実行時に、ホストの認証情報および設定を提供しています。以下の例では、AWS CLI 認証情報および設定ファイルのデフォルトの場所を使用しています。別の場所を使用するには、ファイルパスを変更します。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws amazon/aws-cli s3 ls
```
------
特定システムの環境変数は、`-e`フラグを使用して呼び出すことができます。環境変数を使用するには、変数を名前で呼び出します。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
```
------
### 例 2: ホストシステムへの Amazon S3 ファイルのダウンロード
一部の AWS CLI バージョン 2 コマンドでは、コンテナ内のホストシステムからファイルを読み取ったり、コンテナからホストシステムにファイルを書き込むことができます。
この例では、現在の作業ディレクトリをコンテナの `S3` ディレクトリにマウントして、`s3://aws-cli-docker-demo/hello` オブジェクト `/aws` をローカルファイルシステムにダウンロードします。`hello` オブジェクトをコンテナの `/aws` ディレクトリにダウンロードすると、ファイルはホストシステムの現在の作業ディレクトリにも保存されます。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
```
------
ダウンロードしたファイルがローカルファイルシステムに存在することを確認するには、以下を実行します。
**Linux および macOS**:
```
$ cat hello
Hello from Docker!
```
**Windows PowerShell**:
```
$ type hello
Hello from Docker!
```
### 例 3: AWS\$1PROFILE 環境変数の使用
特定システムの環境変数は、`-e`フラグを使用して呼び出すことができます。使用したいそれぞれの環境変数を呼び出してください。この例では、Amazon Simple Storage Service (Amazon S3) でバケットをリストする `s3 ls` コマンドの実行時に、ホスト認証情報、設定、および * AWS\$1PROFILE * 環境変数を提供しています。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ docker run --rm -it -v ~/.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows コマンドプロンプト**
```
$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo
```
**Windows PowerShell**:
```
C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
```
------
## docker run コマンドの短縮
`docker run` コマンドを短縮するには、オペレーティングシステムの機能を使用して Linux および macOS で [https://www.linux.com/topic/desktop/understanding-linux-links/](https://www.linux.com/topic/desktop/understanding-linux-links/) (シンボリックリンク) または [https://www.linux.com/topic/desktop/aliases-diy-shell-commands/](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/) を作成するか、あるいは Windows で [https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey) を作成することをお勧めします。`aws` エイリアスを設定するには、次のいずれかのコマンドを実行します。
+ `aws` コマンドへの基本的なアクセスについては、以下を実行します。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ alias aws='docker run --rm -it public.ecr.aws/aws-cli/aws-cli'
```
**Windows コマンドプロンプト**
```
C:\> doskey aws=docker run --rm -it public.ecr.aws/aws-cli/aws-cli $*
```
**Windows PowerShell**:
```
C:\> Function AWSCLI {docker run --rm -it public.ecr.aws/aws-cli/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ alias aws='docker run --rm -it amazon/aws-cli'
```
**Windows コマンドプロンプト**
```
C:\> doskey aws=docker run --rm -it amazon/aws-cli $*
```
**Windows PowerShell**:
```
C:\> Function AWSCLI {docker run --rm -it amazon/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
+ `aws` コマンド使用時にホストファイルシステムおよび構成設定にアクセスする場合は、以下を実行します。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws public.ecr.aws/aws-cli/aws-cli'
```
**Windows コマンドプロンプト**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws public.ecr.aws/aws-cli/aws-cli $*
```
**Windows PowerShell**:
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli'
```
**Windows コマンドプロンプト**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli $*
```
**Windows PowerShell**:
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
```
------
+ `aws` エイリアスで使用する特定のバージョンを割り当てるには、バージョンタグを追加します。
------
#### [ Amazon ECR Public ]
**Linux および macOS**:
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws public.ecr.aws/aws-cli/aws-cli:2.0.6'
```
**Windows コマンドプロンプト**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws public.ecr.aws/aws-cli/aws-cli:2.0.6 $*
```
**Windows PowerShell**:
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli:2.0.6 $args}
Set-Alias -Name aws -Value AWSCLI
```
------
#### [ Docker Hub ]
**Linux および macOS**:
```
$ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli:2.0.6'
```
**Windows コマンドプロンプト**
```
C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli:2.0.6 $*
```
**Windows PowerShell**:
```
C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli:2.0.6 $args}
Set-Alias -Name aws -Value AWSCLI
```
------
エイリアスの設定後、ホストシステムにインストールされている場合と同様に、コンテナから AWS CLI バージョン 2 を実行できます。
```
$ aws --version
aws-cli/2.27.41 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
```
# のセットアップAWS CLI
このトピックでは、AWS Command Line Interface (AWS CLI) が AWS と対話するために使用する基本設定をすばやく指定する方法について説明します。これらには、セキュリティ認証情報、デフォルトの出力形式、およびデフォルトの AWS リージョンが含まれます。
**Topics**
+ [
## プログラムによるアクセス用の認証情報を収集する
](#getting-started-prereqs-keys)
+ [
## 新しい設定と認証情報のセットアップ
](#getting-started-quickstart-new)
+ [
## 既存の設定と認証情報ファイルの使用
](#getting-started-quickstart-existing)
## プログラムによるアクセス用の認証情報を収集する
AWS マネジメントコンソール の外部で AWS を操作するには、プログラムによるアクセスが必要です。認証と認証情報の説明については、次のいずれかのオプションを選択します。
****
| 認証タイプ | 目的 | 手順 |
| --- | --- | --- |
| AWS マネジメントコンソールの認証情報 | **(推奨)** コンソール認証情報を使用して AWS CLI にログインし、短期の認証情報を使用します。AWS アカウントアクセスにルート、IAM ユーザー、または IAM とのフェデレーションを使用する場合に推奨 | [コンソール認証情報を使用して AWS ローカル開発にログインする](cli-configure-sign-in.md) |
| IAM アイデンティティセンターのワークフォースユーザーの短期認証情報 | IAM Identity Center のワークフォースユーザーに短期の認証情報を使用します。セキュリティのベストプラクティスは、IAM アイデンティティセンターで AWS Organizations を使用することです。その場合は、組み込みの IAM アイデンティティセンターディレクトリや Active Directory などのユーザーディレクトリを短期認証情報と組み合わせます。 | [AWS CLI を使用した IAM アイデンティティセンター認証の設定](cli-configure-sso.md) |
| IAM ユーザーの短期認証情報 | 長期認証情報よりも安全な IAM ユーザーの短期認証情報を使用します。認証情報が漏洩した場合でも、有効期限が切れる前に使用される可能性のある期間が限られます。 | [Authenticating with short-term credentials for the AWS CLI](cli-authentication-short-term.md) |
| Amazon EC2 インスタンスの IAM または IAM アイデンティティセンターのユーザー。 | Amazon EC2 インスタンスメタデータを使用し、Amazon EC2 インスタンスに割り当てられたロールを使用して一時的な認証情報のクエリを実行します。 | [Using Amazon EC2 instance metadata as credentials in the AWS CLI](cli-configure-metadata.md) |
| アクセス許可のロールの引き受け | 別の認証情報メソッドと組み合わせて、ユーザーがアクセスできない可能性のある AWS のサービスに一時的にアクセスできるようにするためのロールを引き受けます。 | [AWS CLI での IAM ロールの使用](cli-configure-role.md) |
| IAM ユーザーの長期認証情報 | (非推奨) 有効期限のない長期認証情報を使用します。 | [Authenticating using IAM user credentials for the AWS CLI](cli-authentication-user.md) |
| IAM または IAM アイデンティティセンターのワークフォースユーザーの外部ストレージ | (非推奨) 別の認証情報メソッドと組み合わせます。ただし、認証情報値の値は AWS CLI 以外の場所に保存します。この方法は、認証情報が保存される外部の場所の安全性に依存します。 | [Sourcing credentials with an external process in the AWS CLI](cli-configure-sourcing-external.md) |
## 新しい設定と認証情報のセットアップ
AWS CLI は、設定と認証情報を、`credentials` ファイルと `config` ファイルの*プロファイル* (設定のコレクション) に保存します。
**Topics**
+ [
### AWS CLI コマンドを使用した設定
](#getting-started-quickstart-new-command)
+ [
### 認証情報と設定ファイルの手動編集
](#getting-started-quickstart-new-file)
以下の例では、各認証方法でサンプル値を使用しています。サンプル値を自分の値に置き換えてください。
### AWS CLI コマンドを使用した設定
一般的には、任意のターミナルの `aws configure` または `aws configure sso` コマンドを使用するのが、AWS CLI のインストールをセットアップするための最も簡単な方法です。希望する認証情報メソッドに応じた関連情報を入力するよう AWS CLI から求められます。デフォルトでは、このプロファイル内の情報は、使用するプロファイルを明示的に指定しない AWS CLI コマンドを実行する場合に使用されます。
`credentials` ファイルと`config` ファイルの詳細については、「[Configuration and credential file settings in the AWS CLI](cli-configure-files.md)」を参照してください。
------
#### [ Console sessions as short-term credentials ]
この例では、`aws login` コマンドで既存のコンソール認証情報を使用できます。このサインイン方法は、最初のアカウント設定中に作成されたルート認証情報、IAM ユーザー、または ID プロバイダーからのフェデレーティッド ID で使用できます。詳細については、「[コンソール認証情報を使用した AWS ローカル開発へのログイン](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sign-in.html)」を参照してください。
```
$ aws login
No AWS region has been configured. The AWS region is the geographic location of your AWS resources.
If you've used AWS before and already have resources in your account, tell us which region they were
created in. If you haven't created resources in your account before, you can pick the region closest to you:
https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html. You are able to change
the region in the CLI at any time with the command `aws configure set region NEW_REGION`.
AWS Region [us-east-1]: us-east-1
Attempting to open the login page for `us-east-1` in your default browser. If the browser does not open,
use the following URL to complete your login:
https://us-east-1.signin.aws.amazon.com/v1/authorize
If you cannot connect to this URL, make sure that you have specified a valid region.
Waiting for login...
Logged in with role `arn:aws:sts::012345678910:user/iam-user`, and configured profile
`default` to use `us-east-1`. This session will expire on October 14, 2025 at 2:04 PST. After this time, you
can renew your session with `aws login`.
```
------
#### [ IAM Identity Center (SSO) ]
この例は、`aws configure sso` ウィザードを使用した AWS IAM アイデンティティセンター 用です。詳細については、「[AWS CLI を使用した IAM アイデンティティセンター認証の設定](cli-configure-sso.md)」を参照してください。
```
$ aws configure sso
SSO session name (Recommended): my-sso
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]:us-east-1
Attempting to automatically open the SSO authorization page in your default browser.
There are 2 AWS accounts available to you.
> DeveloperAccount, developer-account-admin@example.com (111122223333)
ProductionAccount, production-account-admin@example.com (444455556666)
Using the account ID 111122223333
There are 2 roles available to you.
> ReadOnly
FullAccess
Using the role name "ReadOnly"
CLI default client Region [None]: us-west-2
CLI default output format [None]: json
CLI profile name [123456789011_ReadOnly]: user1
```
------
#### [ IAM Identity Center (Legacy SSO) ]
この例は、`aws configure sso` ウィザードを使用した AWS IAM アイデンティティセンター の従来の方法を示しています。従来の SSO を使用するには、セッション名を空白のままにします。詳細については、「[AWS CLI を使用した IAM アイデンティティセンター認証の設定](cli-configure-sso.md)」を参照してください。
```
$ aws configure sso
SSO session name (Recommended):
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]:us-east-1
SSO authorization page has automatically been opened in your default browser.
Follow the instructions in the browser to complete this authorization request.
There are 2 AWS accounts available to you.
> DeveloperAccount, developer-account-admin@example.com (111122223333)
ProductionAccount, production-account-admin@example.com (444455556666)
Using the account ID 111122223333
There are 2 roles available to you.
> ReadOnly
FullAccess
Using the role name "ReadOnly"
CLI default client Region [None]: us-west-2
CLI default output format [None]: json
CLI profile name [123456789011_ReadOnly]: user1
```
------
#### [ Short-term credentials ]
この例は、AWS Identity and Access Management の短期の認証情報用です。aws configure ウィザードを使用して初期値を設定すると、`aws configure set` コマンドは必要な最後の値を割り当てます。詳細については、「[Authenticating with short-term credentials for the AWS CLI](cli-authentication-short-term.md)」を参照してください。
```
$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json
$ aws configure set aws_session_token fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
------
#### [ IAM role ]
この例は IAM ロールを引き受けるためのものです。IAM ロールを使用するプロファイルは、別のプロファイルから認証情報を取得し、IAM ロールのアクセス許可を適用します。以下の例で、`default` は認証情報のソースプロファイルです。`user1` は同じ認証情報を借り出して新しいロールを継承します。このプロセス用のウィザードは存在しないため、各値の設定には `aws configure set` コマンドを使用します。詳細については、「[AWS CLI での IAM ロールの使用](cli-configure-role.md)」を参照してください。
```
$ aws configure set role_arn arn:aws:iam::123456789012:role/defaultrole
$ aws configure set source_profile default
$ aws configure set role_session_name session_user1
$ aws configure set region us-west-2
$ aws configure set output json
```
------
#### [ Amazon EC2 instance metadata credentials ]
次の例は、ホストしている Amazon EC2 インスタンスメタデータから取得した認証情報用です。このプロセス用のウィザードは存在しないため、各値の設定には `aws configure set` コマンドを使用します。詳細については、「[Using Amazon EC2 instance metadata as credentials in the AWS CLI](cli-configure-metadata.md)」を参照してください。
```
$ aws configure set role_arn arn:aws:iam::123456789012:role/defaultrole
$ aws configure set credential_source Ec2InstanceMetadata
$ aws configure set region us-west-2
$ aws configure set output json
```
------
#### [ Long-term credentials ]
**警告**
セキュリティリスクを避けるため、専用ソフトウェアを開発するときや実際のデータを扱うときは、IAM ユーザーを認証に使用しないでください。代わりに、[AWS IAM アイデンティティセンター](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) などの ID プロバイダーとのフェデレーションを使用してください。
この例は、AWS Identity and Access Management の長期の認証情報用です。詳細については、「[Authenticating using IAM user credentials for the AWS CLI](cli-authentication-user.md)」を参照してください。
```
$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json
```
------
認証方法と認証情報メソッドの詳細については、「[Authentication and access credentials for the AWS CLI](cli-chap-authentication.md)」を参照してください。
### 認証情報と設定ファイルの手動編集
情報をコピーして貼り付ける場合は、`config` ファイルと `credentials` ファイルを手動で編集することをお勧めします。希望する認証情報メソッドに応じて、ファイルは異なる方法で設定されます。
ファイルはホームディレクトリの `.aws` フォルダの下に保存されます。ホームディレクトリの場所はオペレーティングシステムによって異なりますが、環境変数 `%UserProfile%` (Windows の場合) および `$HOME` またはチルド `~` (Unix ベースのシステムの場合) を使用して参照されます。これらの設定が保存される場所の詳細については、「[構成設定はどこに保存されていますか。](cli-configure-files.md#cli-configure-files-where)」を参照してください。
次の例は、`default` プロファイルと `user1` という名前のプロファイルを示しており、サンプル値を使用しています。サンプル値を自分の値に置き換えてください。`credentials` ファイルと`config` ファイルの詳細については、「[Configuration and credential file settings in the AWS CLI](cli-configure-files.md)」を参照してください。
------
#### [ IAM Identity Center (SSO) ]
この例は AWS IAM アイデンティティセンター 用です。詳細については、「[AWS CLI を使用した IAM アイデンティティセンター認証の設定](cli-configure-sso.md)」を参照してください。
**認証情報ファイル**
`credentials` ファイルは、この認証方法には使用しません。
**設定ファイル**
```
[default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = readOnly
region = us-west-2
output = text
[profile user1]
sso_session = my-sso
sso_account_id = 444455556666
sso_role_name = readOnly
region = us-east-1
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_registration_scopes = sso:account:access
```
------
#### [ IAM Identity Center (Legacy SSO) ]
この例は、AWS IAM アイデンティティセンター の従来の方法を示しています。詳細については、「[AWS CLI を使用した IAM アイデンティティセンター認証の設定](cli-configure-sso.md)」を参照してください。
**認証情報ファイル**:
`credentials` ファイルは、この認証方法には使用しません。
**設定ファイル**
```
[default]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-east-1
sso_account_id = 111122223333
sso_role_name = readOnly
region = us-west-2
output = text
[profile user1]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-east-1
sso_account_id = 444455556666
sso_role_name = readOnly
region = us-east-1
output = json
```
------
#### [ Short-term credentials ]
この例は、AWS Identity and Access Management の短期の認証情報用です。詳細については、「[Authenticating with short-term credentials for the AWS CLI](cli-authentication-short-term.md)」を参照してください。
**認証情報ファイル**:
```
[default]
aws_access_key_id=ASIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
[user1]
aws_access_key_id=ASIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
**設定ファイル**
```
[default]
region=us-west-2
output=json
[profile user1]
region=us-east-1
output=text
```
------
#### [ IAM role ]
この例は IAM ロールを引き受けるためのものです。IAM ロールを使用するプロファイルは、別のプロファイルから認証情報を取得し、IAM ロールのアクセス許可を適用します。以下の例で、`default` は認証情報のソースプロファイルで、`user1` は同じ認証情報を借り出して新しいロールを継承します。詳細については、「[AWS CLI での IAM ロールの使用](cli-configure-role.md)」を参照してください。
**認証情報ファイル**:
`credentials` ファイルは、ソースプロファイルが使用する認証によって異なります。次の例で、ソースプロファイルは短期の認証情報を使用しています。
```
[default]
aws_access_key_id=ASIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
**設定ファイル**
```
[default]
region=us-west-2
output=json
[profile user1]
role_arn=arn:aws:iam::777788889999:role/user1role
source_profile=default
role_session_name=session_user1
region=us-east-1
output=text
```
------
#### [ Amazon EC2 instance metadata credentials ]
次の例は、ホストしている Amazon EC2 インスタンスメタデータから取得した認証情報用です。詳細については、「[Using Amazon EC2 instance metadata as credentials in the AWS CLI](cli-configure-metadata.md)」を参照してください。
**認証情報ファイル**:
`credentials` ファイルは、この認証方法には使用しません。
**設定ファイル**
```
[default]
role_arn=arn:aws:iam::123456789012:role/defaultrole
credential_source=Ec2InstanceMetadata
region=us-west-2
output=json
[profile user1]
role_arn=arn:aws:iam::777788889999:role/user1role
credential_source=Ec2InstanceMetadata
region=us-east-1
output=text
```
------
#### [ Long-term credentials ]
**警告**
セキュリティリスクを避けるため、専用ソフトウェアを開発するときや実際のデータを扱うときは、IAM ユーザーを認証に使用しないでください。代わりに、[AWS IAM アイデンティティセンター](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) などの ID プロバイダーとのフェデレーションを使用してください。
この例は、AWS Identity and Access Management の長期の認証情報用です。詳細については、「[Authenticating using IAM user credentials for the AWS CLI](cli-authentication-user.md)」を参照してください。
**認証情報ファイル**:
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
[user1]
aws_access_key_id=AKIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
```
**設定ファイル**
```
[default]
region=us-west-2
output=json
[profile user1]
region=us-east-1
output=text
```
------
認証方法と認証情報メソッドの詳細については、「[Authentication and access credentials for the AWS CLI](cli-chap-authentication.md)」を参照してください。
## 既存の設定と認証情報ファイルの使用
既存の設定および認証情報ファイルがある場合は、AWS CLI にこれらのファイルを使用できます。
`config` ファイルと `credentials` ファイルを使用するには、これらのファイルをホームディレクトリの `.aws` という名前の付いたフォルダに移動します。ホームディレクトリの場所はオペレーティングシステムによって異なりますが、環境変数 `%UserProfile%` (Windows の場合) および `$HOME` またはチルド `~` (Unix ベースのシステムの場合) を使用して参照されます。
`AWS_CONFIG_FILE` と `AWS_SHARED_CREDENTIALS_FILE` の環境変数を別のローカルパスに設定することで、`config` ファイルと `credentials` ファイルの場所をデフォルト以外の場所に指定できます。詳細については、「[Configuring environment variables for the AWS CLI](cli-configure-envvars.md)」を参照してください。
設定と認証情報ファイルの設定の詳細については、「[Configuration and credential file settings in the AWS CLI](cli-configure-files.md)」を参照してください。