Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Add quick start guides for dragonfly cloud #233

Closed
wants to merge 20 commits into from

Conversation

s1ntaxe770r
Copy link

This PR adds docs for:

  • getting started guide for data store
  • Security and network features of dragonfly cloud

Copy link

vercel bot commented May 3, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
documentation ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jun 13, 2024 10:00am

Signed-off-by: s1ntaxe770r <53065463+s1ntaxe770r@users.noreply.github.com>

![create-datastore](../../static/img/create-datastore.png)

- **Name:** Provide a unique name for your data store.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we don't enforce uniqueness

- **AWS:** Select this option to create your data store on Amazon Web Services.
- **GCP:** Select this option to create your data store on Google Cloud Platform.
- **Region:**
- For AWS, you can choose from `us-east-1` and `eu-west-1`. More regions are coming soon.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

those regions happens to be the one staging, prod has many more, I don't think we should specify them here

@@ -0,0 +1,40 @@
---
sidebar_position: 1
title: Dragonfly Quickstart
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

my intention for this page to cover onboarding and signup and very basic datastore then link to the datastore pages for more details

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will update this in the next pr, along with the page structure we went over


## Managing Networks on Drangonfly Cloud

Dragonfly Cloud allows you to create isolated networks where you can deploy your data stores similar to VPC's if you are familiar with AWS.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the motivation for a private network is security, latency and cost (as you avoid egress charges)

it should proceed to connecting to the private network on the "peering connection" page

sidebar_position: 1
label: Cloud
---

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is the content of the data stores page


## Getting Started with Dragonfly Cloud

A Dragonfly Cloud data store represents a Redis Protocol (RESP) endpoint. To create a data store, on the Data Store tab click +Data Store. The minimum configuration consists of a name, cloud provider, cloud region and plan. Note that the cloud provider can not be modified once the data store is created.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please format better with line breaks please

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you use an image for +Data Store
image

![datastore](../../static/img/create-datastore.png)


The plan specifies the provisioned memory and memory to cpu ratio of the data store. You can modify the data store plan later with zero down time to scale it up or down.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

new lint for 2nd sentence


By default the data store will be configured with a public endpoint, TLS and an auto generated passkey, meaning you can securely connect to it from anywhere over the public internet.

To create a data store with a private endpoint, see [Security](cloud/data-stores/security), [Networks](cloud/networks) and Peering Connections.By default the data store will consist of a single Dragonfly server, to create a highly available data store see [Durability and High Availability](cloud/data-stores/duarability-vs-high-availability)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Space after Connections.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Peering Connection should link

Once the data store is created, clicking the data store row will open a drawer with the data store configuration, including the auto generated passkey and redis compatible connection string.


![edit datastore](../../static/img/datastore-edit.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The image here should show the drawer with the details when clicking a data store row

@@ -0,0 +1,40 @@
---
sidebar_position: 1
title: Creating a Data Store
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please remove this content



# Durability and Availability
Dragonfly Cloud prioritizes both data durability and high availability for your data stores. You can further fine-tune these aspects through the concept of eviction policies when creating a data store. This allows you to strike a balance between data persistence and performance based on your application's needs.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

make sure to do so across the entire PR


A private endpoint data store in a private network provides better security, performance and reduces data transfer costs.

To create a private network navigate to the Networks tab and click +Network at the top right corner.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you use an image dor +Network ?

Copy link
Contributor

@ashotland ashotland left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still doesn't match the organization of doc I've sent.

The minimum configuration consists of a name, cloud provider, cloud region and plan. Note that the cloud provider can not be modified once the data store is created.


![datastore](../../../static/img/add-datastore.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't look good. Can you make it smaller and inline with the text?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should be fixed now

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

docs should line up now

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants