Guide de démarrage rapide : clusters mondiaux

Pour créer un cluster régional Amazon DocumentDB, appelez le cluster AWS CLI create-global-cluster. La AWS CLI commande suivante crée un cluster Amazon DocumentDB nomméglobal-cluster-id. Pour plus d'informations sur la protection contre la suppression, consultezSupprimer un cluster Amazon DocumentDB.

Il --engine-version s'agit également d'un paramètre facultatif dont la valeur par défaut est la dernière version du moteur majeur. La version actuelle du moteur par défaut est 5.0.0 (remarque : Amazon DocumentDB 8.0 est disponible mais doit être explicitement spécifiée comme telle8.0.0). Lorsque de nouvelles versions de moteurs majeurs sont publiées, la version du moteur par défaut pour --engine-version est mise à jour pour refléter la dernière version du moteur majeur. Par conséquent, pour les charges de travail de production, et en particulier celles qui dépendent de scripts, d'automatisation ou de CloudFormation modèles, spécifiez explicitement la --engine-version version majeure prévue.

Si aucun db-subnet-group-name ou n'vpc-security-group-idest spécifié, Amazon DocumentDB utilisera le groupe de sous-réseaux par défaut et le groupe de sécurité Amazon VPC pour la région donnée.

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb create-db-cluster \
      --global-cluster-identifier global-cluster-id \
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
         

Pour Windows :

aws docdb create-db-cluster ^
      --global-cluster-identifier global-cluster-id ^
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
         

La sortie de cette opération ressemble à ceci (format JSON).

{
    "DBCluster": {
        "StorageEncrypted": false,
        "DBClusterMembers": [],
        "Engine": "docdb",
        "DeletionProtection" : "enabled",
        "ClusterCreateTime": "2018-11-26T17:15:19.885Z",
        "DBSubnetGroup": "default",
        "EngineVersion": "4.0.0",
        "MasterUsername": "masteruser",
        "BackupRetentionPeriod": 1,
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
        "DBClusterIdentifier": "cluster-id",
        "MultiAZ": false,
        "DBClusterParameterGroup": "default.docdb4.0",
        "PreferredBackupWindow": "09:12-09:42",
        "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
        "PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
        "Port": 27017,
        "Status": "creating",
        "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
        "AssociatedRoles": [],
        "HostedZoneId": "ZNKXTT8WH85VW",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-77186e0d",
                "Status": "active"
            }
        ],
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1c",
            "us-east-1e"
        ],
        "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
    }
}
      

L'exemple suivant crée un nouveau cluster Amazon DocumentDB et l'associe au cluster global en tant que cluster secondaire en lecture seule. Dans la dernière étape, l'instance est ajoutée au nouveau cluster.

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb --region secondary-region-id \
  create-db-cluster \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb

aws docdb --region secondary-region-id \
  create-db-instance \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb
      

Pour Windows :

aws docdb --region secondary-region-id ^
  create-db-cluster ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb

aws docdb --region secondary-region-id ^
  create-db-instance ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb