使用 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 存储桶。

需要使用 S3 存储桶来存储 DR Orchestrator Framework 以及您的最新配置。创建两个 S3 存储桶，一个位于主区域（us-east-1）中，一个在辅助区域（us-west-2）中：

将 xxxxxx 替换为随机值以使存储桶名称保持唯一。

创建子网和安全组。

在主区域（us-east-1）和辅助区域（us-west-2）中，为在您的 VPC 中部署 Lambda 函数创建两个子网和一个安全组：

更新 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。

要在主要区域（us-east-1）中部署 DR Orchestrator Framework，请运行以下命令：

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

验证部署。

如果 CloudFormation 命令成功运行，它将返回以下输出：

Successfully created/updated stack - dr-orchestrator

或者，您可以导航到 CloudFormation 控制台并验证dr-orchestrator堆栈的状态。

创建数据库子网和安全组。

在您的 VPC 中，在主区域（us-east-1）和辅助区域（us-west-2）中为数据库实例或全局数据库创建两个子网和一个安全组：

更新主数据库实例或集群的参数文件。

在 <YOUR LOCAL GIT FOLDER>/App-Stack 文件夹中，更新主要区域的参数文件。

Amazon RDS

在 RDS-MySQL-parameter-us-east-1.json 文件中，使用您创建的资源的名称更新 SubnetIds 和 DBSecurityGroup：

{
  "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 文件中，使用您创建的资源的名称更新 SubnetIds 和 DBSecurityGroup：

{
  "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"
  }
}

亚马逊 ElastiCache （Redis OSS）

在 ElastiCache-parameter-us-east-1.json 文件中，使用您创建的资源的名称更新 SubnetIds 和 DBSecurityGroup。

{
  "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"
  }
}

在主要区域中部署数据库实例或集群。

要在主区域（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

亚马逊 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

验证 CloudFormation 资源是否成功部署。

更新辅助数据库实例或集群的参数文件。

在 <YOUR LOCAL GIT FOLDER>/App-Stack 文件夹中，更新辅助区域的参数文件。

Amazon RDS

在 RDS-MySQL-parameter-us-west-2.json 文件中，使用您创建的资源的名称更新 SubnetIDs 和 DBSecurityGroup。PrimaryRegionKMSKeyArn使用MySQLKmsKeyId从主数据库实例 CloudFormation 堆栈的 O ut puts 部分中获取的值更新：

{
  "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 文件中，使用您创建的资源的名称更新 SubnetIDs 和 DBSecurityGroup。PrimaryRegionKMSKeyArn使用AuroraKmsKeyId从主数据库实例 CloudFormation 堆栈的 O ut puts 部分中获取的值更新：

{
  "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"
  }
}

亚马逊 ElastiCache （Redis OSS）

在 ElastiCache-parameter-us-west-2.json 文件中，使用您创建的资源的名称更新 SubnetIDs 和 DBSecurityGroup。PrimaryRegionKMSKeyArn使用ElastiCacheKmsKeyId从主数据库实例 CloudFormation 堆栈的 O ut puts 部分中获取的值更新：

{
  "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"
  }
}

在辅助区域中部署数据库实例或集群。

根据您的数据库引擎运行以下命令。

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

亚马逊 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

验证 CloudFormation 资源是否成功部署。