aws-cli等を経由してローカルのPCでAmplifyを利用した開発の環境を構築する方法をまとめます。
この記事ではaws-cliとamplify-cliをインストールしてローカルでaws,amplify系のコマンドを実行出来る様にするまでの手順をまとめました。
環境
| 名前 | バージョン |
|---|---|
| Mac OS | 12.2.1 |
aws-cliのインストール
ローカル環境でawsのサービスを利用する為にaws-cliをインストールします。
aws-cliのv2系はGUIでインストーラーをダウンロードするのが手っ取り早いです。
v1系で差支えなければpip経由でインストール出来ます。
pyenvのインストール
pipを利用する為にpyenvをインストールします。
$ git clone https://github.com/pyenv/pyenv.git ~/.pyenv
~ $ pyenv --version
pyenv 2.2.0-5-g54889eb8
~/.bash_profileの設定
# pyenv
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
~/.bashrcの設定
# pyenv
eval "$(pyenv init -)"
読み込み
$ source ~/.bash_profile
インストールバージョンのリストの確認
$ pyenv versions
* system (set by $HOME/.pyenv/version)
$ pyenv install --list
指定したバージョンのインストール
$ pyenv install 3.9.7
$ pyenv global 3.9.7
$ pyenv local 3.9.7
$ python --version
Python 3.9.7
$ which python
$HOME/.pyenv/shims/python
pipでaws-cliのインストール
$ pip install awscli
$ aws --version
aws-cli/1.21.7 Python/3.9.7 Darwin/19.6.0 botocore/1.22.7
これでaws-cliを利用出来る様になります。
.awsの確認
*既にAWSコンソール上でプロファイルが作成済みである事想定です。
*.awsディレクトリ未作成作成の場合はディレクトリの作成とパーミッションを付与する必要があります。
$ cd ~/
$ mkdir .aws
$ chmod 766 .aws
$ cd ~/.aws
$ touch credentials
下記の様な形でプロファイルの設定を記載します。
$ cat ~/.aws/credentials
[default]
aws_access_key_id=xxxxxxxxxxxxxxxxxxxx
aws_secret_access_key=xxxxxxxxxxxxxxxxxxxx
[profile_name]
aws_access_key_id=xxxxxxxxxxxxxxxxxxxx
aws_secret_access_key=xxxxxxxxxxxxxxxxxxxx
$ cat ~/.aws/config
[default]
region=xxxxxxxxxxxxxxxxxxxx
output=json
[profile profile_name]
region=xxxxxxxxxxxxxxxxxxxx
プロファイルの確認
$ aws configure list
Name Value Type Location
---- ----- ---- --------
profile <not set> None None
access_key ****************XXXX shared-credentials-file
secret_key ****************XXXX shared-credentials-file
region xx-xxxxxxxxx-1 config-file ~/.aws/config
プロファイル名の指定
$ aws configure list --profile profile_name
Name Value Type Location
---- ----- ---- --------
profile profile_name manual --profile
access_key ****************XXXX shared-credentials-file
secret_key ****************XXXX shared-credentials-file
region xx-xxxxxxxxx-1 config-file ~/.aws/config
プロファイルの切り替え
複数のプロファイルを有している場合、~/.bash_profileに下記を追記する事でデフォルトのプロファイルを設定する事が出来ます。
$ vim ~/.bash_profile
# aws-cli
export AWS_PROFILE=profile_name
$ source ~/.bash_profile
オプションの指定無しでプロファイルの確認
$ aws configure list
Name Value Type Location
---- ----- ---- --------
profile profile_name manual --profile
access_key ****************XXXX shared-credentials-file
secret_key ****************XXXX shared-credentials-file
region xx-xxxxxxxxx-1 config-file ~/.aws/config
amplify-cliの設定
ローカルでamplifyを利用する為にamplify-cliをインストールする必要があります。
amplify-cliのインストール
$ npm install -g @aws-amplify/cli
$ amplify -v
6.3.1
configureの設定(AWSアカウントの紐付け)
Amplify用のプロファイルが未作成の場合はamplify configureコマンドでAWSのマネジメントコンソールを開きつつ新しいIAMユーザーを作成することが出来ます。
下記のコマンドを実行後、マネジメントコンソールが開かれる為
$ amplify configure
ユーザー詳細の設定、AWSアクセスの種類の設定、アクセス権限の設定、タグの設定を行います。
- AWSアクセスの種類→
プログラムによるアクセスのみを選択する。 - アクセス権限の設定→
AdministratorAccessやAdministratorAccess-Amplifyを設定する。 - タグは任意
作成後にaccess_keyなどをローカルに設定してプロファイル情報を保存します。
amplify configureコマンドを実行中の場合、引き続き対話形式でキーの設定を入力する事で.aws/config、.aws/credentialsを更新する事が出来ます。
$ amplify configure
Follow these steps to set up access to your AWS account:
Sign in to your AWS administrator account:
https://console.aws.amazon.com/
Press Enter to continue
Specify the AWS Region
? region: ap-northeast-1
Specify the username of the new IAM user:
? user name: amplify-test-user
Complete the user creation using the AWS console
xxxxxxxxxx
Press Enter to continue
Enter the access key of the newly created user:
? accessKeyId: ********************
? secretAccessKey: ****************************************
This would update/create the AWS Profile in your local machine
? Profile Name: profile_name
Successfully set up the new user.
これでローカルでawsコマンドやamplifyコマンドを実行出来る様になりました。
次回はamplifyコマンドを利用して既存のプロジェクトにamplifyのリソースを紐づけて行きます。