Skip to content

Commit

Permalink
updating cloud docs for more detailed info (#158)
Browse files Browse the repository at this point in the history
* updating cloud docs for more detailed info

* Light edits
  • Loading branch information
craigkerstiens authored and begriffs committed Sep 8, 2016
1 parent d619d34 commit 6c2ed43
Show file tree
Hide file tree
Showing 3 changed files with 34 additions and 23 deletions.
20 changes: 17 additions & 3 deletions cloud/features.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,29 @@ Citus Cloud runs with a different replication from that outlined in the Citus do
Continuous protection
---------------------

Citus Cloud continuously protects cluster data against hardware failure. To do this we perform backups of your data every 24 hours, then stream the write-ahead log (WAL) from Postgres to S3 every 16 MB or 60 seconds, whichever is less. Even without high availability enabled you won't lose any data. In the event of a complete infrastructure failure we'll restore your back-up and replace the WAL to the exact moment before your system crashed.
Citus Cloud continuously protects the cluster data against hardware failure. To do this we perform backups every twenty-four hours, then stream the write-ahead log (WAL) from PostgreSQL to S3 every 16 MB or 60 seconds, whichever is less. Even without high availability enabled you won't lose any data. In the event of a complete infrastructure failure we'll restore your back-up and replay the WAL to the exact moment before your system crashed.

High Availability
-----------------

In addition to continuous protection which is explained above, high availability is available if your application requires less exposure to downtime. If at provisioning you select high availability we provision stand-bys. This can be for your primary node, or for your distributed nodes.
In addition to continuous protection which is explained above, high availability is available if your application requires less exposure to downtime. We provision stand-bys if you select high availability at provisioning time. This can be for your primary node, or for your distributed nodes.

Security
--------

Encryption
~~~~~~~~~~

All data within Citus Cloud is encrypted at rest, including data on the instance as well as all backups for disaster recovery. We also require that you connect to your database with TLS.

Two-Factor Authentication
~~~~~~~~~~~~~~~~~~~~~~~~~

We support two factor authentication for all Citus accounts. You can enable it from within your Citus Cloud account. We support Google Authenticator and Authy as two primary apps for setting up your two factor authentication.


.. raw:: html

<script type="text/javascript">
Intercom('trackEvent', 'docs-cloud-pageview');
</script>
</script>
30 changes: 12 additions & 18 deletions cloud/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,33 +6,27 @@ Citus Cloud is a fully managed hosted version of Citus Enterprise edition on top
Provisioning
############

Once you've created your account at https://console.citusdata.com you can provision your Citus cluster. When you login you'll be at the home of the dashboard, and from here you can click New Formation to begin your formation creation.
Once you've created your account at `https://console.citusdata.com <https://console.citusdata.com>`_ you can provision your Citus cluster. When you login you'll be at the home of the dashboard, and from here you can click New Formation to begin your formation creation.

.. image:: ../images/cloud_provisioning.png

Pre-configured plans
--------------------
Configuring Your Plan
---------------------

To make it simpler for you to get up and running we've preconfigured a number of Citus Cloud plans. All Citus plans come with:
Citus Cloud plans vary based on the size of your primary node, size of your distributed nodes, number of distributed nodes and whether you have high availability or not. From within the Citus console you can configure your plan or you can preview what it might look like within the `pricing calculator <https://console.citusdata.com/pricing>`_.

1. A primary instance which you will connect to and is suitable for storing your smaller tables (under 1 million rows) on.
2. A set of distributed nodes which your distributed tables will be sharded across
3. High availability, meaning we will be running standbys should you need to fail over.
The key items you'll care about for each node:

If you do not need high availability or want a different number or size of nodes than you see available you can create your own custom plan.
- Storage - All nodes come with 512 GB of storage
- Memory - The memory on each node varies based on the size of node you select
- Cores - The cores on each node varies based on the size of node you select

Custom plans
------------
High Availability
~~~~~~~~~~~~~~~~~

Each custom plan allows you to configure the size of your primary instance, the number and size of distributed nodes, and whether the primary instance and nodes have HA enabled. Discounts are available for longer-term commitments on custom plans which make them comparable in price to the preconfigured plans.
The high availability option on a cluster automatically provisions instance stand-bys. These stand-bys receive streaming updates directly from each of the leader nodes. We continuously monitor the leader nodes to ensure they're available and healthy. In the event of a failure we automatically switch to the stand-bys.


Sizing your Citus Cluster
-------------------------

All nodes within a Citus cluster come with 512 GB of storage. The number of nodes and size of the nodes you need will vary based on your data volume and performance requirements. We encourage you to focus on the number of logical shards and right distribution key first before focusing on overall size of your cluster.

Citus will use only as many physical cores to process a query as there are logical shards in your cluster. Thus we recommend creating sufficient shards to give your cluster room to grow. A good estimate is 4-8x the number of cores you currently use in your cluster. For instance choosing 128 logical shards is quite reasonable when you create your distributed tables.
Note that your data is replicated to S3 with and without enabling high availability. This allows disaster recovery and reduces the risk of data loss. Although the data is safe either way, we suggest enabling high availability if you cannot tolerate up to one hour of downtime in the rare occurrence of an instance failure. We do not offer a SLA on uptime.

.. raw:: html

Expand Down
7 changes: 5 additions & 2 deletions cloud/support.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,14 @@ Email and web based support is available on all Citus Cloud plans. You can open
Billing and pricing
-------------------

Citus Cloud bills on a per minute basis. We bill for a minimum of 1 hour of usage across all plans. Pricing varies based on the size and configuration of the cluster. The a few factors that determine your price are:
Citus Cloud bills on a per minute basis. We bill for a minimum of one hour of usage across all plans. Pricing varies based on the size and configuration of the cluster. A few factors that determine your price are:

- Size of your primary node
- Size of your distributed nodes
- Number of distributed nodes
- Whether you have high availability enabled, both on the primary node and on distributed nodes
- Size of your primary node

You can see pricing of various configurations directly within our `pricing calculator <https://console.citusdata.com/pricing>`_.

.. raw:: html

Expand Down

0 comments on commit 6c2ed43

Please sign in to comment.