DR Orchestrator Framework を使用してクロスリージョンフェイルオーバーとフェイルバックを自動化する

GitHub リポジトリのクローンを作成します。

リポジトリのクローンを作成するには、次のコマンドを実行します。

git clone https://github.com/aws-samples/aws-cross-region-dr-databases.git

Lambda 関数コードを .zip ファイルアーカイブにパッケージ化します。

Lambda 関数のアーカイブファイルを作成して、DR Orchestrator Framework の依存関係を含めます。

cd <YOUR-LOCAL-GIT-FOLDER>/DR-Orchestration-artifacts

bash scripts/deploy-orchestrator-sh.sh

S3 バケットを作成します。

DR Orchestrator Framework を最新の設定とともに保存するには、S3 バケットが必要です。2 つの S3 バケットを作成します。1 つはプライマリリージョン (us-east-1) に、もう 1 つはセカンダリリージョン () に作成しますus-west-2。

をランダムな値xxxxxxに置き換えて、バケット名を一意にします。

サブネットとセキュリティグループを作成します。

プライマリリージョン (us-east-1) とセカンダリリージョン () の両方でus-west-2、 に Lambda 関数をデプロイするための 2 つのサブネットと 1 つのセキュリティグループを作成しますVPC。

DR Orchestrator パラメータファイルを更新します。

<YOUR-LOCAL-GIT-FOLDER>/DR-Orchestration-artifacts/cloudformation フォルダで、次の DR Orchestrator パラメータファイルを更新します。

次のパラメータ値を使用して、 xと をリソースの名前yに置き換えます。

[
    {
         "ParameterKey": "TemplateStoreS3BucketName",
         "ParameterValue": "dr-orchestrator-xxxxxx-us-east-1"
    },
    {
        "ParameterKey": "TemplateVPCId",
        "ParameterValue": "vpc-xxxxxx"
    },
    {
        "ParameterKey": "TemplateLambdaSubnetID1",
        "ParameterValue": "subnet-xxxxxx"
    },
    {
        "ParameterKey": "TemplateLambdaSubnetID2",
        "ParameterValue": "subnet-yyyyyy"
    },
    {
        "ParameterKey": "TemplateLambdaSecurityGroupID",
        "ParameterValue": "sg-xxxxxxxxxx"
    }
 ]

DR Orchestrator Framework コードを S3 バケットにアップロードします。

コードは、ローカルディレクトリよりも S3 バケットの方が安全です。すべてのファイルとサブフォルダを含むDR-Orchestration-artifactsディレクトリを S3 バケットにアップロードします。

コードをアップロードするには、次の手順を実行します。

DR Orchestrator Framework をプライマリリージョンにデプロイします。

DR Orchestrator Framework をプライマリリージョン (us-east-1) にデプロイするには、次のコマンドを実行します。

cd <YOUR-LOCAL-GIT-FOLDER>/DR-Orchestration-artifacts/cloudformation

aws cloudformation deploy \
--region us-east-1 \
--stack-name dr-orchestrator \
--template-file Orchestrator-Deployer.yaml \
--parameter-overrides file://Orchestrator-Deployer-parameters-us-east-1.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

DR Orchestrator Framework をセカンダリリージョンにデプロイします。

セカンダリリージョン (us-west-2) で、次のコマンドを実行します。

cd <YOUR-LOCAL-GIT-FOLDER>/DR-Orchestration-artifacts/cloudformation

aws cloudformation deploy \
--region us-west-2 \
--stack-name dr-orchestrator \
--template-file Orchestrator-Deployer.yaml \
--parameter-overrides file://Orchestrator-Deployer-parameters-us-west-2.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

デプロイメントを確認する

AWS CloudFormation コマンドが正常に実行されると、次の出力が返されます。

Successfully created/updated stack - dr-orchestrator

または、 AWS CloudFormation コンソールに移動してdr-orchestratorスタックのステータスを確認することもできます。

データベースサブネットとセキュリティグループを作成します。

でVPC、プライマリ (us-east-1) リージョンとセカンダリ (us-west-2) リージョンの両方に、DB インスタンスまたはグローバルデータベース用に 2 つのサブネットと 1 つのセキュリティグループを作成します。

プライマリ DB インスタンスまたはクラスターのパラメータファイルを更新します。

<YOUR LOCAL GIT FOLDER>/App-Stack フォルダで、プライマリリージョンのパラメータファイルを更新します。

Amazon RDS

RDS-MySQL-parameter-us-east-1.json ファイルで、作成したリソースの名前DBSecurityGroupで SubnetIdsと を更新します。

{
  "Parameters": {
    "SubnetIds": "subnet-xxxxxx,subnet-xxxxxx",
    "DBSecurityGroup": "sg-xxxxxxxxxx",
    "MySqlGlobalIdentifier":"rds-mysql-instance",
    "InitialDatabaseName": "mysqldb",
    "DBPortNumber": "3789",
    "PrimaryRegion": "us-east-1",
    "SecondaryRegion": "us-west-2",
    "KMSKeyAliasName": "rds/rds-mysql-instance-KmsKeyId"
  }
}

Amazon Aurora

Aurora-MySQL-parameter-us-east-1.json ファイルで、作成したリソースの名前DBSecurityGroupで SubnetIdsと を更新します。

{
  "Parameters": {
    "SubnetIds": "subnet1-xxxxxx,subnet2-xxxxxx",
    "DBSecurityGroup": "sg-xxxxxxxxxx",
    "GlobalClusterIdentifier":"dr-globaldb-cluster-mysql",
    "DBClusterName":"dbcluster-01",
    "SourceDBClusterName":"dbcluster-02",
    "DBPortNumber": "3787",
    "DBInstanceClass":"db.r5.large",
    "InitialDatabaseName": "sampledb",
    "PrimaryRegion": "us-east-1",
    "SecondaryRegion": "us-west-2",
    "KMSKeyAliasName": "rds/dr-globaldb-cluster-mysql-KmsKeyId"
  }
}

Amazon ElastiCache (Redis OSS）

ElastiCache-parameter-us-east-1.json ファイルで、作成したリソースの名前DBSecurityGroupで SubnetIdsと を更新します。

{
  "Parameters": {
    "CacheNodeType": "cache.m5.large",
    "DBSecurityGroup": "sg-xxxxxxxxxx",
    "SubnetIds": "subnet-xxxxxx,subnet-xxxxxx",
    "EngineVersion": "5.0.6",
    "GlobalReplicationGroupIdSuffix": "demo-redis-global-datastore",
    "NumReplicas": "1",
    "NumShards": "1",
    "ReplicationGroupId": "demo-redis-cluster",
    "DBPortNumber": "3788",
    "TransitEncryption": "true",
    "KMSKeyAliasName": "elasticache/demo-redis-global-datastore-KmsKeyId",
    "PrimaryRegion": "us-east-1",
    "SecondaryRegion": "us-west-2"
  }
}

DB インスタンスまたはクラスターをプライマリリージョンにデプロイします。

インスタンスまたはクラスターをプライマリリージョン (us-east-1) にデプロイするには、データベースエンジンに基づいて次のコマンドを実行します。

Amazon RDS

cd <YOUR-LOCAL-GIT-FOLDER>/App-Stack

aws cloudformation deploy \
--region us-east-1 \
--stack-name rds-mysql-app-stack \
--template-file RDS-MySQL-Primary.yaml \
--parameter-overrides file://RDS-MySQL-parameter-us-east-1.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

Amazon Aurora

cd <YOUR-LOCAL-GIT-FOLDER>/App-Stack

aws cloudformation deploy \
--region us-east-1 \
--stack-name aurora-mysql-app-stack \
--template-file Aurora-MySQL-Primary.yaml \
--parameter-overrides file://Aurora-MySQL-parameter-us-east-1.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

Amazon ElastiCache (Redis OSS）

cd <YOUR-LOCAL-GIT-FOLDER>/App-Stack

aws cloudformation deploy \
--region us-east-1 --stack-name elasticache-ds-app-stack \
--template-file ElastiCache-Primary.yaml \
--parameter-overrides file://ElastiCache-parameter-us-east-1.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

AWS CloudFormation リソースが正常にデプロイされたことを確認します。

セカンダリ DB インスタンスまたはクラスターのパラメータファイルを更新します。

<YOUR LOCAL GIT FOLDER>/App-Stack フォルダで、セカンダリリージョンのパラメータファイルを更新します。

Amazon RDS

RDS-MySQL-parameter-us-west-2.json ファイルで、作成したリソースの名前DBSecurityGroupで SubnetIDsと を更新します。を、プライマリ DB インスタンスの AWS CloudFormation スタックの Outputs セクションからMySQLKmsKeyId取得した の値PrimaryRegionKMSKeyArnで更新します。

{
  "Parameters": {
    "SubnetIds": "subnet-aaaaaaaaa,subnet-bbbbbbbbb",
    "DBSecurityGroup": "sg-cccccccccc",
    "MySqlGlobalIdentifier":"rds-mysql-instance",
    "InitialDatabaseName": "mysqldb",
    "DBPortNumber": "3789",
    "PrimaryRegion": "us-east-1",
    "SecondaryRegion": "us-west-2",
    "KMSKeyAliasName": "rds/rds-mysql-instance-KmsKeyId",
    "PrimaryRegionKMSKeyArn":"arn:aws:kms:us-east-1:xxxxxxxxx:key/mrk-xxxxxxxxxxxxxxxxxxxxx"
  }
} 

Amazon Aurora

Aurora-MySQL-parameter-us-west-2.json ファイルで、作成したリソースの名前DBSecurityGroupで SubnetIDsと を更新します。を、プライマリ DB インスタンスの AWS CloudFormation スタックの Outputs セクションからAuroraKmsKeyId取得した の値PrimaryRegionKMSKeyArnで更新します。

{
  "Parameters": {
    "SubnetIds": "subnet1-aaaaaaaaa,subnet2-bbbbbbbbb",
    "DBSecurityGroup": "sg-cccccccccc",
    "GlobalClusterIdentifier":"dr-globaldb-cluster-mysql",
    "DBClusterName":"dbcluster-01",
    "SourceDBClusterName":"dbcluster-02",
    "DBPortNumber": "3787",
    "DBInstanceClass":"db.r5.large",
    "InitialDatabaseName": "sampledb",
    "PrimaryRegion": "us-east-1",
    "SecondaryRegion": "us-west-2",
    "KMSKeyAliasName": "rds/dr-globaldb-cluster-mysql-KmsKeyId"
  }
}

Amazon ElastiCache (Redis OSS）

ElastiCache-parameter-us-west-2.json ファイルで、作成したリソースの名前DBSecurityGroupで SubnetIDsと を更新します。を、プライマリ DB インスタンスの AWS CloudFormation スタックの Outputs セクションからElastiCacheKmsKeyId取得した の値PrimaryRegionKMSKeyArnで更新します。

{
  "Parameters": {
    "CacheNodeType": "cache.m5.large",
    "DBSecurityGroup": "sg-cccccccccc",
    "SubnetIds": "subnet-aaaaaaaaa,subnet-bbbbbbbbb",
    "EngineVersion": "5.0.6",
    "GlobalReplicationGroupIdSuffix": "demo-redis-global-datastore",
    "NumReplicas": "1",
    "NumShards": "1",
    "ReplicationGroupId": "demo-redis-cluster",
    "DBPortNumber": "3788",
    "TransitEncryption": "true",
    "KMSKeyAliasName": "elasticache/demo-redis-global-datastore-KmsKeyId",
    "PrimaryRegion": "us-east-1",
    "SecondaryRegion": "us-west-2"
  }
}

DB インスタンスまたはクラスターをセカンダリリージョンにデプロイします。

データベースエンジンに基づいて、次のコマンドを実行します。

Amazon RDS

cd <YOUR-LOCAL-GIT-FOLDER>/App-Stack

aws cloudformation deploy \
--region us-west-2 \
--stack-name rds-mysql-app-stack \
--template-file RDS-MySQL-DR.yaml \
--parameter-overrides file://RDS-MySQL-parameter-us-west-2.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

Amazon Aurora

cd <YOUR-LOCAL-GIT-FOLDER>/App-Stack

aws cloudformation deploy \
--region us-west-2 \
--stack-name aurora-mysql-app-stack \
--template-file Aurora-MySQL-DR.yaml \
--parameter-overrides file://Aurora-MySQL-parameter-us-west-2.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

Amazon ElastiCache (Redis OSS）

cd <YOUR-LOCAL-GIT-FOLDER>/App-Stack

aws cloudformation deploy \
--region us-west-2 \
--stack-name elasticache-ds-app-stack \
--template-file ElastiCache-DR.yaml \
--parameter-overrides file://ElastiCache-parameter-us-west-2.json \
--capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_NAMED_IAM CAPABILITY_IAM \
--disable-rollback

AWS CloudFormation リソースが正常にデプロイされたことを確認します。