將 Amazon DocumentDB 執行個體新增至叢集

Using the AWS Management Console

使用下列程序，使用 Amazon DocumentDB 主控台為叢集建立執行個體。

1. 登入 AWS Management Console，然後在 /docdb 開啟亞馬遜文件資料庫主控台。https://console.aws.amazon.com

2. 在導覽窗格中，選擇叢集。

   提示

   如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 ()。

3. 若要選擇要新增執行個體的叢集，請選取叢集名稱左側的按鈕。

4. 選擇 Actions (動作)，然後選擇 Add instances (新增執行個體)。

5. 在 Add instance to: (新增執行個體至)<cluster-name> 頁面，針對您想要加到叢集的每個執行個體重複以下步驟。您最多可以擁有 15 個。

   1. 執行個體識別碼 — 您可以為此執行個體輸入唯一識別碼，或允許 Amazon DocumentDB 根據叢集識別碼提供執行個體識別碼。

      執行個體命名限制：

      • 長度為 [1—63] 字母、數字或連字號。

      • 第一個字元必須是字母。

      • 不能以連字號結尾或連續包含兩個連字號。

      • 亞馬遜RDS、Neptune 和 Amazon DocumentDB 中每 AWS 帳戶個區域的所有執行個體必須是唯一的。

   2. 實例類別 — 從下拉式清單中選擇要用於此實例的實例類型。

   3. 促銷層 — 從下拉式清單中選擇執行個體的促銷方案，或選擇 [無偏好設定] 以允許 Amazon DocumentDB 為您的執行個體設定促銷方案。數字越小表示優先順序越高。如需詳細資訊，請參閱控制容錯移轉目標。

   4. 若要新增更多執行個體，請選擇 Add additional instances (新增其他執行個體)，然後重複步驟 a、b 和 c。

6. 完成操作。

   • 若要新增執行個體到您的叢集，請選擇 Create (建立)。

   • 若要取消操作，請選擇 Cancel (取消)。

建立執行個體需要幾分鐘才能完成。您可以使用主控台或 AWS CLI 檢視執行個體的狀態。如需詳細資訊，請參閱監視執行個體的狀態。

Using the AWS CLI

使用create-db-instance AWS CLI 作業搭配下列參數來建立叢集的主要執行個體。

• --db-instance-class – 必要。執行個體的運算與記憶體容量，例如 db.m4.large。並非所有實例類都可用 AWS 區域。

• --db-instance-identifier – 必要。識別執行個體的字串。

  執行個體命名限制條件：

  • 長度為 [1—63] 字母、數字或連字號。

  • 第一個字元必須是字母。

  • 不能以連字號結尾或連續包含兩個連字號。

  • 亞馬遜RDS、Neptune 和 Amazon DocumentDB 中每 AWS 帳戶個區域的所有執行個體必須是唯一的。

• --engine – 必要。必須為 docdb。

• --availability-zone-可選。要在其中建立執行個體的可用區域。使用此參數尋找不同可用區域中的執行個體，以提高容錯能力。如需詳細資訊，請參閱Amazon DocumentDB 高可用性和複寫。

• --promotion-tier-可選。此執行個體的容錯移轉優先順序方案。必須介於 0 和 15 之間，數字越小優先順序越高。如需詳細資訊，請參閱控制容錯移轉目標。

1. 首先，決定您可以在其中建立執行個體的可用區域。

   如果您想在建立執行個體之前指定可用區域，請執行下列命令來判斷 Amazon DocumentDB 叢集可用的可用區域。

   若為 Linux、macOS 或 Unix：

   aws docdb describe-db-clusters \
          --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

   針對 Windows：

   aws docdb describe-db-clusters ^
          --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

   此操作的輸出將會如下所示。

   [
       [
           "sample-cluster",
           [
               "us-east-1c",
               "us-east-1b",
               "us-east-1a"
           ]
       ]
   ]
                           

2. 其次，判定您可以在區域中建立哪些執行個體類別。

   若要判斷您區域中可用的執行個體類別，請執行以下命令。從輸出中，為您要新增至 Amazon DocumentDB 叢集的執行個體選擇一個執行個體類別。

   若為 Linux、macOS 或 Unix：

   aws docdb describe-orderable-db-instance-options \
           --engine docdb \
           --query 'OrderableDBInstanceOptions[*].DBInstanceClass'

   針對 Windows：

   aws docdb describe-orderable-db-instance-options ^
           --engine docdb ^
           --query 'OrderableDBInstanceOptions[*].DBInstanceClass'

   此操作的輸出將會如下所示。

   [
       "db.r5.16xlarge",
       "db.r5.2xlarge",
       "db.r5.4xlarge",
       "db.r5.8xlarge",
       "db.r5.large",
       "db.r5.xlarge"
   ]

3. 最後，將執行個體新增至您的 Amazon DocumentDB 叢集。

   若要將執行個體新增至 Amazon DocumentDB 叢集，請執行下列命令。

   若為 Linux、macOS 或 Unix：

   aws docdb create-db-instance \
          --db-cluster-identifier sample-cluster \
          --db-instance-identifier sample-instance-2 \
          --availability-zone us-east-1b \
          --promotion-tier 2 \
          --db-instance-class db.r5.xlarge \
          --engine docdb

   針對 Windows：

   aws docdb create-db-instance ^
          --db-cluster-identifier sample-cluster ^
          --db-instance-identifier sample-instance-2 ^
          --availability-zone us-east-1b ^
          --promotion-tier 2 ^
          --db-instance-class db.r5.xlarge ^
          --engine docdb

   此操作的輸出將會如下所示。

   {
       "DBInstance": {
           "DBInstanceIdentifier": "sample-instance-2",
           "DBInstanceClass": "db.r5.xlarge",
           "Engine": "docdb",
           "DBInstanceStatus": "creating",
           "PreferredBackupWindow": "02:00-02:30",
           "BackupRetentionPeriod": 1,
           "VpcSecurityGroups": [
               {
                   "VpcSecurityGroupId": "sg-abcd0123",
                   "Status": "active"
               }
           ],
           "AvailabilityZone": "us-east-1b",
           "DBSubnetGroup": {
               "DBSubnetGroupName": "default",
               "DBSubnetGroupDescription": "default",
               "VpcId": "vpc-6242c31a",
               "SubnetGroupStatus": "Complete",
               "Subnets": [
                   {
                       "SubnetIdentifier": "subnet-abcd0123",
                       "SubnetAvailabilityZone": {
                           "Name": "us-west-2a"
                       },
                       "SubnetStatus": "Active"
                   },
                   {
                       "SubnetIdentifier": "subnet-wxyz0123",
                       "SubnetAvailabilityZone": {
                           "Name": "us-west-2b"
                       },
                       "SubnetStatus": "Active"
                   }
               ]
           },
           "PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
           "PendingModifiedValues": {},
           "EngineVersion": "3.6.0",
           "AutoMinorVersionUpgrade": true,
           "PubliclyAccessible": false,
           "DBClusterIdentifier": "sample-cluster",
           "StorageEncrypted": true,
           "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
           "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
           "CACertificateIdentifier": "rds-ca-2019",
           "PromotionTier": 2,
           "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2"
       }
   }
                       

建立執行個體需要幾分鐘才能完成。您可以使用主控台或 AWS CLI 檢視執行個體的狀態。如需詳細資訊，請參閱監控 Amazon DocumentDB 執行個體的狀態。