1.2. IAMロールの作成 (handson-cli-iam-instance-profile-role)¶

手順の目的¶

IAMロール"handson-cli-iam-instance-profile-role"を作成します。

設定値の指定¶

手順に必要な設定値を変数に格納をします。

1. IAMロール名¶

IAMロール名を指定します。

変数の設定:

IAM_ROLE_NAME='handson-cli-iam-instance-profile-role'

2. IAMロールパス¶

IAMロールパスを指定します。

変数の設定:
IAM_ROLE_PATH='/handson-cli/'

3. 信頼ポリシードキュメントファイル名¶

信頼ポリシードキュメント用ディレクトリを指定します。

変数の設定:

DIR_IAM_ROLE_DOC="${HOME}/environment/conf-handson-cli-iam-instance-profile"

信頼ポリシードキュメント名を指定します。

変数の設定:

IAM_ROLE_DOC_NAME='handson-cli-iam-instance-profile-role'

信頼ポリシードキュメントのファイル名を指定します。

変数の設定:

FILE_IAM_ROLE_DOC="${DIR_IAM_ROLE_DOC}/${IAM_ROLE_DOC_NAME}.json" \
  && echo ${FILE_IAM_ROLE_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-iam-instance-profile/handson-cli-iam-instance-profile-role.json

4. IAMロールの説明¶

IAMロールの説明を指定します。

変数の設定:

IAM_ROLE_DESCRIPTION='Role for handson-cli-iam-instance-profile.'

設定値の確認¶

各変数に正しい設定値が格納されていることを確認します。

変数の確認:

cat << END

  # 1. IAM_ROLE_NAME:"handson-cli-iam-instance-profile-role"
       IAM_ROLE_NAME="${IAM_ROLE_NAME}"
  # 2. IAM_ROLE_PATH:"/handson-cli/"
       IAM_ROLE_PATH="${IAM_ROLE_PATH}"
  # 3. FILE_IAM_ROLE_DOC:"${HOME}/environment/conf-handson-cli-iam-instance-profile/handson-cli-iam-instance-profile-role.json"
       FILE_IAM_ROLE_DOC="${FILE_IAM_ROLE_DOC}"
  # 4. IAM_ROLE_DESCRIPTION:"Role for handson-cli-iam-instance-profile."
       IAM_ROLE_DESCRIPTION="${IAM_ROLE_DESCRIPTION}"

END

各変数について、上の行と下の行の値の内容もしくは形式が同じであることを確認します。もし異なる場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行¶

IAMロールを作成します。

変数の確認:

cat << END

  # IAM_ROLE_NAME:"handson-cli-iam-instance-profile-role"
    IAM_ROLE_NAME="${IAM_ROLE_NAME}"
  # IAM_ROLE_PATH:"/handson-cli/"
    IAM_ROLE_PATH="${IAM_ROLE_PATH}"
  # IAM_ROLE_DESCRIPTION:"Role for handson-cli-iam-instance-profile."
    IAM_ROLE_DESCRIPTION="${IAM_ROLE_DESCRIPTION}"
  # FILE_IAM_ROLE_DOC:"${HOME}/environment/conf-handson-cli-iam-instance-profile/handson-cli-iam-instance-profile-role.json"
    FILE_IAM_ROLE_DOC="${FILE_IAM_ROLE_DOC}"

END

コマンド:

aws iam create-role \
  --role-name ${IAM_ROLE_NAME} \
  --path ${IAM_ROLE_PATH} \
  --assume-role-policy-document file://${FILE_IAM_ROLE_DOC} \
  --description "${IAM_ROLE_DESCRIPTION}"

結果(例):

{
    "Role": {
        "Path": "/handson-cli/",
        "RoleName": "handson-cli-iam-instance-profile-role",
        "RoleId": "AROAXXXXXXXXXXXXXXXXX",
        "Arn": "arn:aws:iam::<AWSアカウントID>:role/handson-cli/handson-cli-iam-instance-profile-role",
        "CreateDate": "2024-03-06T01:23:45.678Z",
        "AssumeRolePolicyDocument": {
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Sid": "",
                    "Effect": "Allow",
                    "Principal": {
                        "Service": "ec2.amazonaws.com"
                    },
                    "Action": "sts:AssumeRole"
                }
            ]
        }
    }
}

完了確認¶

「IAMロール"handson-cli-iam-instance-profile-role"が存在する。」ことを確認します。

コマンド:

aws iam list-roles \
  --query "Roles[?RoleName == \`${IAM_ROLE_NAME}\`].RoleName" \
  --output text

結果(例):

handson-cli-iam-instance-profile-role

手順の完了¶

(参考) マネジメントコンソールの確認¶

IAMダッシュボード( https://console.aws.amazon.com/iam/home )にアクセスします。

左ペインの"ロール"をクリックします。

ロール一覧(画面)

検索欄にロール名"handson-cli-iam-instance-profile-role"を入力して、エンターキーを押します。
ロール名"handson-cli-iam-instance-profile-role"が表示されていることを確認します。