Déployer un cluster Amazon ElastiCache pour Redis à l'aide d'AWS CDK et TypeScript | AWS Database Blog

L'AWS Cloud Development Kit (AWS CDK) vous permet de créer des ressources AWS avec une seule ligne de code. Par exemple, vous pouvez créer un VPC dans TypeScript avec la ligne suivante :new EC2.Vpc(this, 'cache_vpc');Cependant, plusieurs ressources AWS nécessitent plusieurs lignes de code car vous devez souvent créer des ressources de support. Par exemple, vous devez créer un CfnSubnetGroup et un SecurityGroup avant de créer un Amazon ElastiCache pour Redis CfnReplicationGroup. Ce résumé illustre les étapes de déploiement d'un cluster Amazon ElastiCache à l'aide d'AWS CDK et TypeScript. Nous vous montrons également comment déployer des ressources à l'aide d'Amazon ElastiCache pour Redis Serverless.

Creating AWS Resources with AWS Cloud Development Kit (AWS CDK) for ElastiCache

Création de ressources AWS avec AWS Cloud Development Kit (AWS CDK) pour ElastiCache

Introduction

Introduction

AWS Cloud Development Kit (AWS CDK) enables developers to define and provision AWS resources using familiar programming languages such as TypeScript. This article guides readers through the process of deploying an Amazon ElastiCache cluster and ElastiCache Serverless resources using AWS CDK and TypeScript.

AWS Cloud Development Kit (AWS CDK) permet aux développeurs de définir et de provisionner des ressources AWS à l'aide de langages de programmation familiers tels que TypeScript. Cet article guide les lecteurs tout au long du processus de déploiement d'un cluster Amazon ElastiCache et de ressources ElastiCache Serverless à l'aide d'AWS CDK et TypeScript.

Prerequisites

Conditions préalables

• AWS account
• AWS Command Line Interface (AWS CLI)
• AWS CDK
• Node.js 16.14.0 or later

Creating Prerequisite Resources

Compte AWSAWS Command Line Interface (AWS CLI)AWS CDKNode.js 16.14.0 ou version ultérieureCréation de ressources prérequises

1. Install AWS CDK:

npm install -g aws-cdk
Installer AWS CDK : npm install -g aws-cdk
cdk --version

2. Create AWS CDK Directory Structure:

mkdir work & cd work
cdk --versionCréer la structure du répertoire AWS CDK : travail mkdir et travail cd
cdk init --language typescript

3. Install NPM Packages:

npm install

4. Create VPC:

In the lib/work-stack.ts file, create a VPC:

cdk init --langue typescriptInstaller les packages NPM :npm installCréer un VPC :Dans le fichier lib/work-stack.ts, créez un VPC :

import * as cdk from 'aws-cdk-lib';
importer * en tant que cdk depuis 'aws-cdk-lib' ;
import { Construct } from 'constructs';
importer { Construct } à partir de 'constructions' ;
import * as EC2 from 'aws-cdk-lib/aws-ec2';
importer * en tant qu'EC2 depuis 'aws-cdk-lib/aws-ec2' ;

export class WorkStack extends cdk.Stack {
la classe d'exportation WorkStack étend cdk.Stack {
  private vpc: EC2.Vpc;
vpc privé : EC2.Vpc ;

  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
constructeur (portée : construction, identifiant : chaîne, accessoires ? : cdk.StackProps) {
    super(scope, id, props);
super(portée, identifiant, accessoires);
    this.vpc = new EC2.Vpc(this, 'cache_vpc');
this.vpc = new EC2.Vpc(this, 'cache_vpc');
  }
}
}

5. Bootstrap AWS Environment:

cdk bootstrap

6. Synthesize CloudFormation Template:

cdk synth

7. Deploy VPC:

cdk deploy --require-approval never

Create Subnet Group

}Environnement AWS Bootstrap : cdk bootstrapSynthesize CloudFormation Modèle : cdk synthDeploy VPC : cdk déployer --require-approval neverCreate Subnet Group

1. Update lib/work-stack.ts to create a subnet group for ElastiCache:

import * as cdk from 'aws-cdk-lib';
Mettez à jour lib/work-stack.ts pour créer un groupe de sous-réseaux pour ElastiCache : import * as cdk from 'aws-cdk-lib' ;
importer * en tant que cdk depuis 'aws-cdk-lib' ;
import { Construct } from 'constructs';
importer { Construct } à partir de 'constructions' ;
import * as EC2 from 'aws-cdk-lib/aws-ec2';
importer * en tant qu'EC2 depuis 'aws-cdk-lib/aws-ec2' ;
import { aws_elasticache as ElastiCache } from 'aws-cdk-lib';
importer { aws_elasticache as ElastiCache } depuis 'aws-cdk-lib' ;

export class WorkStack extends cdk.Stack {
la classe d'exportation WorkStack étend cdk.Stack {
  private vpc: EC2.Vpc;
vpc privé : EC2.Vpc ;

  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
constructeur (portée : construction, identifiant : chaîne, accessoires ? : cdk.StackProps) {
    const groupName = "ElastiCacheSubnetGroup";
const groupName = "ElastiCacheSubnetGroup";
    super(scope, id, props);
super(portée, identifiant, accessoires);
    this.vpc = new EC2.Vpc(this, 'cache_vpc');
this.vpc = new EC2.Vpc(this, 'cache_vpc');

    const subnetIds = [];
const subnetIds = [];
    for (const subnet of this.vpc.privateSubnets) {
pour (sous-réseau const de this.vpc.privateSubnets) {
      console.log("createElastiCache subnet ID: ", subnet.subnetId);
console.log("ID ​​de sous-réseau createElastiCache : ", subnet.subnetId);
      subnetIds.push(subnet.subnetId);
subnetIds.push(subnet.subnetId);
    }
}
}

    const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
      cacheSubnetGroupName: groupName,
cacheSubnetGroupName : nom_groupe,
      subnetIds: subnetIds,
identifiants de sous-réseau : identifiants de sous-réseau,
      description: "ElastiCache Subnet Group",
description : "Groupe de sous-réseaux ElastiCache",
    }
}
}
);
  }
}
}

2. Synthesize and deploy the stack:

cdk synth; cdk deploy --require-approval never

Creating an ElastiCache for Redis Replication Group

}Synthétisez et déployez le stack:cdk synth; cdk déployer --require-approval neverCréation d'un groupe de réplication ElastiCache pour Redis

1. Create Security Group:

import * as cdk from 'aws-cdk-lib';
Créer un groupe de sécurité : importer * en tant que cdk depuis 'aws-cdk-lib' ;
importer * en tant que cdk depuis 'aws-cdk-lib' ;
import { Construct } from 'constructs';
importer { Construct } à partir de 'constructions' ;
import * as EC2 from 'aws-cdk-lib/aws-ec2';
importer * en tant qu'EC2 depuis 'aws-cdk-lib/aws-ec2' ;
import { aws_elasticache as ElastiCache } from 'aws-cdk-lib';
importer { aws_elasticache as ElastiCache } depuis 'aws-cdk-lib' ;
import { SecurityGroup, Peer, Port } from 'aws-cdk-lib/aws-ec2';
importer { SecurityGroup, Peer, Port } depuis 'aws-cdk-lib/aws-ec2' ;

export class WorkStack extends cdk.Stack {
la classe d'exportation WorkStack étend cdk.Stack {
  private vpc: EC2.Vpc;
vpc privé : EC2.Vpc ;

  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
constructeur (portée : construction, identifiant : chaîne, accessoires ? : cdk.StackProps) {
    const groupName = "ElastiCacheSubnetGroup";
const groupName = "ElastiCacheSubnetGroup";
    super(scope, id, props);
super(portée, identifiant, accessoires);
    this.vpc = new EC2.Vpc(this, 'cache_vpc');
this.vpc = new EC2.Vpc(this, 'cache_vpc');

    const subnetIds = [];
const subnetIds = [];
    for (const subnet of this.vpc.privateSubnets) {
pour (sous-réseau const de this.vpc.privateSubnets) {
      console.log("createElastiCache subnet ID: ", subnet.subnetId);
console.log("ID ​​de sous-réseau createElastiCache : ", subnet.subnetId);
      subnetIds.push(subnet.subnetId);
subnetIds.push(subnet.subnetId);
    }
}
}

    const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
      cacheSubnetGroupName: groupName,
cacheSubnetGroupName : nom_groupe,
      subnetIds: subnetIds,
identifiants de sous-réseau : identifiants de sous-réseau,
      description: "ElastiCache Subnet Group",
description : "Groupe de sous-réseaux ElastiCache",
    }
}
}
);

    const securityGroup = new SecurityGroup(this, "ElastiCacheSecurityGroup", {
const securityGroup = new SecurityGroup(this, "ElastiCacheSecurityGroup", {
      vpc: this.vpc,
vpc : ceci.vpc,
      allowAllOutbound: true,
allowAllOutbound : vrai,
      description: "ElastiCache Security Group",
description : "Groupe de sécurité ElastiCache",
      securityGroupName: "ElastiCacheSecurityGroup",
securityGroupName : "ElastiCacheSecurityGroup",
    }
}
}
);

    securityGroup.addIngressRule(Peer.anyIpv4(), Port.tcp(6379), "Redis port");
securityGroup.addIngressRule(Peer.anyIpv4(), Port.tcp(6379), "Port Redis");
  }
}
}

2. Create Replication Group:

import * as cdk from 'aws-cdk-lib';
}Créer un groupe de réplication : importer * en tant que cdk depuis 'aws-cdk-lib' ;
importer * en tant que cdk depuis 'aws-cdk-lib' ;
import { Construct } from 'constructs';
importer { Construct } à partir de 'constructions' ;
import * as EC2 from 'aws-cdk-lib/aws-ec2';
importer * en tant qu'EC2 depuis 'aws-cdk-lib/aws-ec2' ;
import { aws_elasticache as ElastiCache } from 'aws-cdk-lib';
importer { aws_elasticache as ElastiCache } depuis 'aws-cdk-lib' ;
import { SecurityGroup, Peer, Port } from 'aws-cdk-lib/aws-ec2';
importer { SecurityGroup, Peer, Port } depuis 'aws-cdk-lib/aws-ec2' ;

export class WorkStack extends cdk.Stack {
la classe d'exportation WorkStack étend cdk.Stack {
  private vpc: EC2.Vpc;
vpc privé : EC2.Vpc ;

  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
constructeur (portée : construction, identifiant : chaîne, accessoires ? : cdk.StackProps) {
    const groupName = "ElastiCacheSubnetGroup";
const groupName = "ElastiCacheSubnetGroup";
    super(scope, id, props);
super(portée, identifiant, accessoires);
    this.vpc = new EC2.Vpc(this, 'cache_vpc');
this.vpc = new EC2.Vpc(this, 'cache_vpc');

    const subnetIds = [];
const subnetIds = [];
    for (const subnet of this.vpc.privateSubnets) {
pour (sous-réseau const de this.vpc.privateSubnets) {
      console.log("createElastiCache subnet ID: ", subnet.subnetId);
console.log("ID ​​de sous-réseau createElastiCache : ", subnet.subnetId);
      subnetIds.push(subnet.subnetId);
subnetIds.push(subnet.subnetId);
    }
}
}

    const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
      cacheSubnetGroupName: groupName,
cacheSubnetGroupName : nom_groupe,
      subnetIds: subnetIds,
identifiants de sous-réseau : identifiants de sous-réseau,
      description: "ElastiCache Subnet Group",
description : "Groupe de sous-réseaux ElastiCache",
    }
}
}
);

    const securityGroup = new SecurityGroup(this, "ElastiCacheSecurityGroup", {
const securityGroup = new SecurityGroup(this, "ElastiCacheSecurityGroup", {
      vpc: this.vpc,
vpc : ceci.vpc,
      allowAllOutbound: true,
allowAllOutbound : vrai,
      description: "ElastiCache Security Group",
description : "Groupe de sécurité ElastiCache",
      securityGroupName: "ElastiCacheSecurityGroup",
securityGroupName : "ElastiCacheSecurityGroup",
    }
}
}
);

    securityGroup.addIngressRule(Peer.anyIpv4(), Port.tcp(6379), "Redis port");
securityGroup.addIngressRule(Peer.anyIpv4(), Port.tcp(6379), "Port Redis");

    const cache = new ElastiCache.CfnReplicationGroup(this, "ReplicationGroup", {
const cache = new ElastiCache.CfnReplicationGroup(this, "ReplicationGroup", {
      replicationGroupDescription: "Elastic Cache Replication Group",
replicationGroupDescription : "Groupe de réplication du cache élastique",
      numCacheClusters: 1,
numCacheClusters : 1,
      automaticFailoverEnabled: false,
automatiqueFailoverEnabled : faux,
      engine: 'redis',
moteur : 'redis',
      cacheNodeType: 'cache.m7g.large',
cacheNodeType : 'cache.m7g.large',
      cacheSubnetGroupName: subnetGroup.ref,
cacheSubnetGroupName : subnetGroup.ref,
      securityGroupIds: [securityGroup.securityGroupId],
securityGroupIds : [securityGroup.securityGroupId],
    }
}
}
);

    // Establish dependency between cache and subnetGroup
// Établit une dépendance entre le cache et subnetGroup
    cache.addDependency(subnetGroup);
cache.addDependency(subnetGroup);
  }
}
}

3. Synthesize and deploy the stack:

cdk synth; cdk deploy --require-approval never

Deploying ElastiCache for Redis Serverless Resources

}Synthétisez et déployez le stack:cdk synth; cdk déployer --require-approval neverDeploying ElastiCache pour les ressources sans serveur Redis

1. Create Security Group:

import * as cdk from 'aws-cdk-lib';
Créer un groupe de sécurité : importer * en tant que cdk depuis 'aws-cdk-lib' ;
importer * en tant que cdk depuis 'aws-cdk-lib' ;
import { Construct } from 'constructs';
importer { Construct } à partir de 'constructions' ;
import * as EC2 from 'aws-cdk-lib/aws-ec2';
importer * en tant qu'EC2 depuis 'aws-cdk-lib/aws-ec2' ;
import { aws_elasticache as ElastiCache } from 'aws-cdk-lib';
importer { aws_elasticache as ElastiCache } depuis 'aws-cdk-lib' ;
import { SecurityGroup, Peer, Port } from 'aws-cdk-lib/aws-ec2';
importer { SecurityGroup, Peer, Port } depuis 'aws-cdk-lib/aws-ec2' ;

export class WorkStack extends cdk.Stack {
la classe d'exportation WorkStack étend cdk.Stack {
  private vpc: EC2.Vpc;
vpc privé : EC2.Vpc ;

  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
constructeur (portée : construction, identifiant : chaîne, accessoires ? : cdk.StackProps) {
    const groupName = "ElastiCacheSubnetGroup";
const groupName = "ElastiCacheSubnetGroup";
    super(scope, id, props);
super(portée, identifiant, accessoires);
    this.vpc = new EC2.Vpc(this, 'cache_vpc');
this.vpc = new EC2.Vpc(this, 'cache_vpc');

    const subnetIds = [];
const subnetIds = [];
    for (const subnet of this.vpc.privateSubnets) {
pour (sous-réseau const de this.vpc.privateSubnets) {
      console.log("createElastiCache subnet ID: ", subnet.subnetId);
console.log("ID ​​de sous-réseau createElastiCache : ", subnet.subnetId);
      subnetIds.push(subnet.subnetId);
subnetIds.push(subnet.subnetId);
    }
}
}

    const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
const subnetGroup = new ElastiCache.CfnSubnetGroup(this, "ElastiCacheSubnetGroup", {
      cacheSubnetGroupName: groupName,
cacheSubnetGroupName : nom_groupe,
      subnetIds: subnetIds,
identifiants de sous-réseau : identifiants de sous-réseau,
      description: "ElastiCache Subnet Group",
description : "Groupe de sous-réseaux ElastiCache",
    }
}
}
);

    const securityGroup = new SecurityGroup(this, "ElastiCacheSecurityGroup", {
const securityGroup = new SecurityGroup(this, "ElastiCacheSecurityGroup", {
      vpc: this.vpc,
vpc : ceci.vpc,
      allowAllOutbound: true,
allowAllOutbound : vrai,
      description: "ElastiCache Security Group",
description : "Groupe de sécurité ElastiCache",
      securityGroupName: "ElastiCacheSecurityGroup",
securityGroupName : "ElastiCacheSecurityGroup",
    }
}
}
);