Create a Global Cluster
On this page
This section covers enabling Global Writes on an Atlas cluster.
Required Access
To create to a Global Cluster, you must have
Organization Owner
or Project Owner
access to
the project.
Considerations
Before creating a Global Cluster, review Global Clusters Overview and Global Clusters Sharding Reference.
You can enable Global Writes in Atlas when you deploy an
M30
or greater sharded cluster.After you deploy the cluster, you can't convert a Global Cluster to a standard sharded cluster.
Due to sharding requirements, you can't load sample data onto a Global Cluster.
If this is the first dedicated paid cluster for the selected region or regions and you plan on creating one or more VPC peering connections, review VPC Peering Connections before continuing.
Procedure
Navigate to the Database Deployments page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Database Deployments page is not already displayed, click Database in the sidebar.
Open the Create New Database Deployment Dialog.
If you already have one or more database deployments, click Create to display the Create New Database Deployment dialog.
If this is your first database deployment:
Click Build a Database.
Click advanced configuration options at the top of the screen to display the Create New Database Deployment dialog.
Enable Global Writes for your cluster.
In the Create New Cluster dialog box, select the Dedicated cluster type. For more information, see Create a Cluster.
Click Global Cluster Configuration to expand the section.
Toggle Enable Global Writes (M30 and Up) to On to display the Global Cluster configuration.
Select your preferred cloud provider.
Note
Each cloud provider has a selection of global regions to which Atlas can deploy a zone. The choice of cloud provider may support or constrict your ability to deploy a zone to specific geographic locations. The configuration options available and the cost for running the cluster may also vary depending on cloud provider selection.
Configure your Global Cluster Zones.
Atlas provides three options for configuring your Global Cluster zones:
Configure Global Writes Zones Using a Template
Configure a Global Writes Single Region Zone
Configure a Global Writes Multi Region Zone
Select the appropriate tab based on how you would like to configure your Global Cluster zones.
Select the Cluster Tier.
To use Global Clusters, you must select a cluster tier
that is M30
or larger.
The selected tier dictates the memory, storage, vCPUs, and IOPS specification for each data-bearing server in the cluster.
For more information on how to select an appropriate cluster tier and storage settings for your workload, see Select Cluster Tier and Customize Cluster Storage.
Specify the Cluster Name.
This is the cluster name as it appears in Atlas. You can't change the cluster name once Atlas deploys the cluster.
Cluster names can't exceed 64 characters in length.
Important
Atlas truncates the cluster name to 23 characters in its internal interactions. In practice, this means:
Cluster names shorter than 23 characters can't end with hyphen or dash (
-
).Cluster names 23 characters or longer can't use a hyphen or dash (
-
) as its 23rd character.The first 23 characters in a cluster name must be unique within a project.
Don't include sensitive information in your cluster name.
Optional: Update your Billing Address details as needed.
Field | Necessity | Action |
---|---|---|
Billing Email Address | Optional | Type the email address to which Atlas should send billing alerts. By default, Atlas sends billing alerts to the Organization Owners and Billing Admins.
|
Company Name | Optional | Type the name of the company for your billing address. |
Country | Required | Select the country for your billing address. You can also
start typing the name of the country and then select it from
the filtered list of countries. |
Street Address | Required | Type the street address for your billing address. |
Apt/Suite/Floor | Optional | Type an the apartment, suite, or floor for your
billing address. |
City | Required | Type the name of the city for your billing address. |
State/Province/Region | Required | Type or select the political subdivision in which your billing address exists. The label and field change depending on what you selected as your Country:
|
ZIP or Postal Code | Required | Type the ZIP (U.S.) or Postal Code (other countries) for your
billing address. |
VAT Number | Conditional | Atlas displays the VAT ID field if you select a country other than the United States. To learn more about VAT, see VAT ID. If your company's billing address is in a country other than
the United States (USA), Atlas typically charges VAT if you do
not enter a valid ImportantIf your billing address is in Ireland or certain Canadian provinces,
Atlas always charges VAT, even with a valid To learn more about VAT by region, see International Usage and Taxation. |
Optional: Update your Payment Method details as needed.
Click the radio button for Credit Card or Paypal.
If you selected Credit Card, type values for the following fields:
FieldNecessityActionName on CardRequiredType the name that appears on your credit card.Card NumberRequiredType the 16-digit number that appears on your credit card. American Express uses a 15-digit number.Expiration DateRequiredType the expiration date for your credit card in the two-digit month and two-digit year format.CVC
RequiredType the three-digit number on the back of your credit card. American Express uses a 4-digit number found on the front of the credit card.If you selected PayPal:
Click Pay with PayPal.
Complete the actions on the PayPal website.
All projects within your organization share the same billing settings, including payment method.
Review project's cost.
Under the Cart section, review the following:
Field | Description |
---|---|
Cluster Tier | Displays cost for your selected cluster tier and configuration
details. To learn more, see Cloud Service Provider and Region and
Cluster Tier. |
Included Features | Displays features included with your selected cluster
configuration. |
Additional Settings | Displays additional settings that you enabled, such as cloud
backups, sharding, BI Connector, and more. To learn more, see
Cloud Backups. |
Deploy your cluster.
Click Confirm and Deploy Cluster below the form to deploy your cluster.
Important
Each Atlas project supports up to 25 database deployments. Please contact Atlas support for questions or assistance regarding the database deployment limit. To contact support, select Support from the left-hand navigation bar of the Atlas UI.
Shard a global collection.
After deployment, you must configure shard keys for the cluster. To learn how to shard a collection for global writes, see Shard a Global Collection.