AWS_CLIの初期設定（やらないとエラーがでます）

2021-02-23 2022-07-02

1 前提条件（環境）
2 実現させること
3 AWS_CLIを初期設定しなかった場合
4 AWC_CLIの利用上の注意点
- 4.1 AWS_CLIのネットワーク構成
5 AWS_CLIの初期設定
6 IAMユーザーの作成
- 6.1 アクセスキーの設定
7 技術者（経験者）を仕事を任せたい場合
8 経験者（専門家）にもっと技術を聞きたい場合

この記事ではAWS_CLIを利用するために必要な初期設定について記載しています。

前提条件（環境）

Amazon Linux2(EC2）を利用
LighthSailのEC2を利用

実現させること

EC2でawsコマンドを利用できるようにする
awsコマンドのバージョンを確認する
awsコマンドを利用してEC2のメタデータ（タグ）を取得する

AWS_CLIを初期設定しなかった場合

以下のエラーが出力されます。リージョンの設定がされていないとのメッセージです。

[code] [root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]# aws ec2 describe-instances
You must specify a region. You can also configure your region by running "aws configure".
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]#

[/code]

AWS_CLIのエラー一覧

2021.12.3

現場でよく使うAWS_CLIコマンド集TIPS ACL_CLIのバージョンが古い場合 <span>Note: AWS CLI version 2, the lates...

AWC_CLIの利用上の注意点

AWS_CLIのネットワーク構成

パブリックサブネットにあるEC2上で行うこと。

理由は、awsコマンドの仕様上、AWSが用意している外部サーバとのやりとりが必要となるためです。

なお、プライベートサブネットにあるEC2でも、VPCエンドポイントを利用すれば外部接続できるので問題なく利用できます。

AWS_CLIの初期設定

AWS_CLIをEC2（Amazon_Linux2)にインストールする

EC2の場合は、デフォルトでインストールされているのでやらなくてOK

AWS_CLIがインストールされているか確認する

[code] [root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]# aws --version
aws-cli/1.18.147 Python/2.7.18 Linux/4.14.246-187.474.amzn2.x86_64 botocore/1.18.6
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]#

[/code]

AWS_CLIのヘルプを確認する

どんなコマンドがあるか調べてみましょう。

[code]

# awsコマンドのヘルプ
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]# aws help
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]#
※qでエスケープ

# aws ec2コマンドのヘルプ
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]# aws ec2 help
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]#
※qでエスケープ

[/code]

AWS_CLIの設定ファイルを作成する

AWS_CLIがインストールされていることを確認できたら、次にやることはAWS_CLIの設定ファイルを作成することです。

[code] [root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]# aws configure
AWS Access Key ID [None]: aaa
AWS Secret Access Key [None]: bbb
Default region name [None]: ap-northeast-1
Default output format [None]: json
[root@ip-172-26-1-254 ~]#
[root@ip-172-26-1-254 ~]#

[/code]

指定したものは以下４つです。

アクセスキー（一時的に入力、後で編集する）
シークレットアクセスキー（一時的に入力、後で編集する）
リージョン（LightSailのGUI画面から確認。aとかcはいらない仕様）
アウトプット方式（json or text：aws_cliコマンドのアウトプット表示を指定）

AWS_CLIの設定ファイルができたか確認する

[code] [root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]# pwd
/root/.aws
[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]# ll
total 8
-rw------- 1 root root 48 Dec 4 00:06 config
-rw------- 1 root root 62 Dec 4 00:06 credentials
[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]#

[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]# cat config
[default] output = json
region = ap-northeast-1
[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]# cat credentials
[default] aws_access_key_id = aaa
aws_secret_access_key = bbb
[root@ip-172-26-1-254 .aws]#
[root@ip-172-26-1-254 .aws]#

[/code]