AWS CLI を使用した DAX クラスターの作成

次の内容で、service-trust-relationship.json というファイルを作成します。

{
    "Version": "2012-10-17",
    "Statement": [
       {
            "Effect": "Allow",
            "Principal": {
                "Service": "dax.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

サービスロールを作成します。

aws iam create-role \
    --role-name DAXServiceRoleForDynamoDBAccess \
    --assume-role-policy-document file://service-trust-relationship.json

次の内容で、service-role-policy.json というファイルを作成します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "dynamodb:DescribeTable",
                "dynamodb:PutItem",
                "dynamodb:GetItem",
                "dynamodb:UpdateItem",
                "dynamodb:DeleteItem",
                "dynamodb:Query",
                "dynamodb:Scan",
                "dynamodb:BatchGetItem",
                "dynamodb:BatchWriteItem",
                "dynamodb:ConditionCheckItem"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:dynamodb:us-west-2:accountID:*"
            ]
        }
    ]
}

accountID をご自分の AWS アカウント ID に置き換えます。AWS アカウント ID を見つけるには、コンソールの右上隅で、ログイン ID を選択します。ドロップダウンメニューに AWS アカウント ID が表示されます

この例の Amazon リソースネーム (ARN) では、accountID は 12 桁の数字である必要があります。ハイフンなどの区切り文字を使用しないでください。

サービスロールの IAM ポリシーを作成します。

aws iam create-policy \
    --policy-name DAXServicePolicyForDynamoDBAccess \
    --policy-document file://service-role-policy.json

出力では、以下の例のように、作成したポリシーの ARN に注意してください。

arn:aws:iam::123456789012:policy/DAXServicePolicyForDynamoDBAccess

ポリシーをサービスロールにアタッチします。以下のコードにある arn を、前のステップで書き留めた実際のロール ARN に置き換えます。

aws iam attach-role-policy \
    --role-name DAXServiceRoleForDynamoDBAccess \
    --policy-arn arn

デフォルト VPC の ID を確認するには、次のコマンドを入力します。

aws ec2 describe-vpcs

出力では、以下の例のように、デフォルト VPC の識別子に注意してください。

vpc-12345678

デフォルト VPC に関連付けられているサブネットの ID を確認します。vpcID を実際の VPC ID に置き換えます (vpc-12345678 など)。

aws ec2 describe-subnets \
    --filters "Name=vpc-id,Values=vpcID" \
    --query "Subnets[*].SubnetId"

出力で、サブネット ID を記録します (subnet-11111111 など)。

サブネットグループを作成します。--subnet-ids パラメータに少なくとも 1 つのサブネット ID を指定してください。

aws dax create-subnet-group \
    --subnet-group-name my-subnet-group \
    --subnet-ids subnet-11111111 subnet-22222222 subnet-33333333 subnet-44444444

サービスロールの Amazon リソースネーム (ARN) を取得します。

aws iam get-role \
    --role-name DAXServiceRoleForDynamoDBAccess \
    --query "Role.Arn" --output text

出力では、以下の例のように、サービスロール ARN に注意してください。

arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess

DAX クラスターを作成します。roleARN を、前のステップで書き留めた ARN に置き換えます。

aws dax create-cluster \
    --cluster-name mydaxcluster \
    --node-type dax.r4.large \
    --replication-factor 3 \
    --iam-role-arn roleARN \
    --subnet-group my-subnet-group \
    --sse-specification Enabled=true \
    --region us-west-2

クラスター内のすべてのノードは、タイプ dax.r4.large (--node-type) です。3つのノード (--replication-factor) があります (1 つのプライマリノードと 2 つのレプリカ)。

デフォルトセキュリティグループの ID を確認するには、次のコマンドを入力します。vpcID を実際の VPC ID (「ステップ 2: サブネットグループの作成」を参照) に置き換えます。

aws ec2 describe-security-groups \
    --filters Name=vpc-id,Values=vpcID Name=group-name,Values=default \
    --query "SecurityGroups[*].{GroupName:GroupName,GroupId:GroupId}"

出力で、セキュリティグループ ID を記録します (sg-01234567 など)。

次のように入力します。sgID を実際のセキュリティグループ ID に置き換えます。暗号化されていないクラスターの場合はポート 8111 を、暗号化されたクラスターの場合は 9111 を使用します。

aws ec2 authorize-security-group-ingress \
    --group-id sgID --protocol tcp --port 8111