Merge pull request #3988 from Blargian/cloud_quickstart

Cloud quick start restructure

Author: Blargian

docs/about-us/cloud.md

@@ -11,7 +11,7 @@ title: 'ClickHouse Cloud'
 ClickHouse Cloud is the cloud offering created by the original creators of the popular open-source OLAP database ClickHouse. 
 You can experience ClickHouse Cloud by [starting a free trial](https://console.clickhouse.cloud/signUp).
 
-### ClickHouse Cloud benefits: {#clickhouse-cloud-benefits}
+## ClickHouse Cloud benefits {#clickhouse-cloud-benefits}
 
 Some of the benefits of using ClickHouse Cloud are described below:
 
@@ -22,7 +22,28 @@ Some of the benefits of using ClickHouse Cloud are described below:
 - **Total cost of ownership**: Best price / performance ratio and low administrative overhead.
 - **Broad ecosystem**: Bring your favorite data connectors, visualization tools, SQL and language clients with you.
 
-### What version of ClickHouse does ClickHouse Cloud use? {#what-version-of-clickhouse-does-clickhouse-cloud-use}
+<!--
+## OSS vs ClickHouse Cloud comparison {#oss-vs-clickhouse-cloud}
+
+| Feature                        | Benefits                                                                                                                                                                                                                                                                                                   | OSS ClickHouse  | ClickHouse Cloud  |
+|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|-------------------|
+| **Deployment modes**           | ClickHouse provides flexibility to self-manage with open-source or deploy in the cloud. Use ClickHouse Local for local files without a server or chDB to embed ClickHouse directly into your application.                                                                                                  | ✅               | ✅                 |
+| **Storage**                    | As an open-source and cloud-hosted product, ClickHouse can be deployed in both shared-disk and shared-nothing architectures.                                                                                                                                                                               | ✅               | ✅                 |
+| **Monitoring and alerting**    | Monitoring and alerting about the status of your services is critical to ensuring optimal performance and a proactive approach to detect and triage potential issues.                                                                                                                                      | ✅               | ✅                 |
+| **ClickPipes**                 | ClickPipes is ClickHouse's managed ingestion pipeline that allows you to seamlessly connect your external data sources like databases, APIs, and streaming services into ClickHouse Cloud, eliminating the need for managing pipelines, custom jobs, or ETL processes. It supports workloads of all sizes. | ❌               | ✅                 |
+| **Pre-built integrations**     | ClickHouse provides pre-built integrations that connect ClickHouse to popular tools and services such as data lakes, SQL and language clients, visualization libraries, and more.                                                                                                                          | ❌               | ✅                 |
+| **SQL console**                | The SQL console offers a fast, intuitive way to connect, explore, and query ClickHouse databases, featuring a slick caption, query interface, data import tools, visualizations, collaboration features, and GenAI-powered SQL assistance.                                                                 | ❌               | ✅                 |
+| **Compliance**                 | ClickHouse Cloud compliance includes CCPA, EU-US DPF, GDPR, HIPAA, ISO 27001, ISO 27001 SoA, PCI DSS, SOC2. ClickHouse Cloud's security, availability, processing integrity, and confidentiality processes are all independently audited. Details: trust.clickhouse.com.                                   | ❌               | ✅                 |
+| **Enterprise-grade security**  | Support for advanced security features such as SSO, multi-factor authentication, role-based access control (RBAC), private and secure connections with support for Private Link and Private Service Connect, IP filtering, customer-managed encryption keys (CMEK), and more.                              | ❌               | ✅                 |
+| **Scaling and optimization**   | Seamlessly scales up or down based on workload, supporting both horizontal and vertical scaling. With automated backups, replication, and high availability, ClickHouse, it provides users with optimal resource allocation.                                                                               | ❌               | ✅                 |
+| **Support services**           | Our best-in-class support services and open-source community resources provide coverage for whichever deployment model you choose.                                                                                                                                                                         | ❌               | ✅                 |
+| **Database upgrades**          | Regular database upgrades are essential to establish a strong security posture and access the latest features and performance improvements.                                                                                                                                                                | ❌               | ✅                 |
+| **Backups**                    | Backups and restore functionality ensures data durability and supports graceful recovery in the event of outages or other disruptions.                                                                                                                                                                     | ❌               | ✅                 |
+| **Compute-compute separation** | Users can scale compute resources independently of storage, so teams and workloads can share the same storage and maintain dedicated compute resources. This ensures that the performance of one workload doesn't interfere with another, enhancing flexibility, performance, and cost-efficiency.         | ❌               | ✅                 |
+| **Managed services**           | With a cloud-managed service, teams can focus on business outcomes and accelerate time-to-market without having to worry about the operational overhead of sizing, setup, and maintenance of ClickHouse.                                                                                                   | ❌               | ✅                 |
+-->
+
+## What version of ClickHouse does ClickHouse Cloud use? {#what-version-of-clickhouse-does-clickhouse-cloud-use}
 
 Clickhouse Cloud continuously upgrades your service to a newer version. After publishing a core database version in the open source, we do additional validation in our cloud staging environment, which typically takes 6-8 weeks before rolling out to production. The rollout is phased out by cloud service provider, service type, and region.
 

docs/cloud/get-started/index.md

@@ -9,8 +9,7 @@ Welcome to ClickHouse Cloud! Explore the pages below to learn more about what Cl
 
 | Page                     | Description                                                                                                                                               |
 |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [Overview](/cloud/overview)          | Overview of the benefits of using ClickHouse Cloud and what version of ClickHouse is used for it.                                                         | 
-| [Cloud Quick Start](/cloud/get-started/cloud-quick-start) | Quick start guide to get up and running with Cloud.                                                                                                       |
+| [Overview](/cloud/overview)          | Overview of the benefits of using ClickHouse Cloud and what version of ClickHouse is used for it.                                                         |
 | [SQL Console](/cloud/get-started/sql-console)       | Learn about the interactive SQL console available in Cloud                                                                                                |
 | [Query Insights](/cloud/get-started/query-insights)    | Learn about how Cloud's Query Insights feature makes ClickHouse's built-in query log easier to use through various visualizations and tables.             |
 | [Query Endpoints](/cloud/get-started/query-endpoints)   | Learn about the Query API Endpoints feature which allows you to create an API endpoint directly from any saved SQL query in the ClickHouse Cloud console. |

docs/deployment-modes.md

@@ -45,7 +45,7 @@ This deployment mode is the go-to choice for production environments where relia
 
 <Image img={chCloud} alt="ClickHouse Cloud" size="sm"/>
 
-A key advantage of ClickHouse Cloud is its integrated tooling. [ClickPipes](/cloud/get-started/cloud-quick-start#clickpipes) provides a robust data ingestion framework, allowing you to easily connect and stream data from various sources without managing complex ETL pipelines. The platform also offers a dedicated [querying API](/cloud/get-started/query-endpoints), making it significantly easier to build applications.
+A key advantage of ClickHouse Cloud is its integrated tooling. [ClickPipes](/getting-started/quick-start/cloud/#clickpipes) provides a robust data ingestion framework, allowing you to easily connect and stream data from various sources without managing complex ETL pipelines. The platform also offers a dedicated [querying API](/cloud/get-started/query-endpoints), making it significantly easier to build applications.
 
 The SQL Console in ClickHouse Cloud includes a powerful [dashboarding](/cloud/manage/dashboards) feature that lets you transform your queries into interactive visualizations. You can create and share dashboards built from your saved queries, with the ability to add interactive elements through query parameters. These dashboards can be made dynamic using global filters, allowing users to explore data through customizable views – though it's important to note that users will need at least read access to the underlying saved queries to view the visualizations.
 

docs/getting-started/index.md

@@ -12,7 +12,7 @@ title: 'Tutorials and Example Datasets'
 
 We have a lot of resources for helping you get started and learn how ClickHouse works:
 
-- If you need to get ClickHouse up and running, check out our [Quick Start](../quick-start.mdx)
+- If you need to get ClickHouse up and running, check out our [Quick Start](/get-started/quick-start)
 - The [ClickHouse Tutorial](../tutorial.md) analyzes a dataset of New York City taxi rides
 
 In addition, the sample datasets provide a great experience on working with ClickHouse,

docs/getting-started/install/_snippets/_quick_install.md

@@ -71,7 +71,7 @@ template](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/c
 You are now ready to start sending SQL commands to ClickHouse!
 
 :::tip
-The [Quick Start](/quick-start.mdx) walks through the steps for creating tables and inserting data.
+The [Quick Start](/get-started/quick-start) walks through the steps for creating tables and inserting data.
 :::
 
 </VerticalStepper>

docs/cloud/get-started/cloud-quick-start.mdx renamed to docs/getting-started/quick-start/cloud.mdx

@@ -1,10 +1,9 @@
 ---
 sidebar_position: 1
-slug: /cloud/get-started/cloud-quick-start
-sidebar_label: 'Cloud Quick Start'
+slug: /getting-started/quick-start/cloud
+sidebar_label: 'Cloud'
 keywords: ['clickhouse', 'install', 'getting started', 'quick start']
-pagination_next: cloud/get-started/sql-console
-title: 'ClickHouse Cloud Quick Start'
+title: 'ClickHouse Cloud quick start'
 description: 'Quick start guide for ClickHouse Cloud'
 ---
 
@@ -22,10 +21,11 @@ import client_details from '@site/static/images/_snippets/client_details.png';
 import new_rows_from_csv from '@site/static/images/_snippets/new_rows_from_csv.png';
 import SQLConsoleDetail from '@site/docs/_snippets/_launch_sql_console.md';
 
-# ClickHouse Cloud Quick Start
+# ClickHouse Cloud quick start
 
-The quickest and easiest way to get up and running with ClickHouse is to create a new
-service in [ClickHouse Cloud](https://console.clickhouse.cloud).
+> The quickest and easiest way to get up and running with ClickHouse is to create a new
+service in [ClickHouse Cloud](https://console.clickhouse.cloud). In this quick start guide, we'll get you setup
+in three easy steps.
 
 <VerticalStepper type="numbered">
 

docs/getting-started/quick-start/index.mdx

@@ -0,0 +1,108 @@
+---
+description: 'Get up and running on ClickHouse in minutes, explore some sample data, and build your solution'
+keywords: ['clickhouse', 'quick start']
+sidebar_label: 'Quick start'
+sidebar_position: 0
+slug: /get-started/quick-start
+title: 'Quick start'
+---
+
+import {CardSecondary, CardPromotion} from '@clickhouse/click-ui/bundled';
+import Link from '@docusaurus/Link';
+
+<div style={{
+    display: 'inline-flex',
+    flexDirection: 'column',
+    width: '100%',
+    maxWidth: 'calc(700px + 1rem)'
+}}>
+    <div style={{
+        display: 'flex',
+        flexDirection: 'row',
+        flexWrap: 'wrap',
+        gap: '1rem',
+        marginBottom: '1rem',
+        width: '100%',
+        '@media (max-width: 996px)': {
+            flexDirection: 'column'
+        }
+    }}>
+        <div style={{
+            flex: '1 1 300px',
+            minWidth: '0',
+            maxWidth: '100%',
+            '@media (max-width: 996px)': {
+                width: '100%',
+                maxWidth: 'none',
+                flex: '1 1 auto'
+            }
+        }}>
+            <Link to="/getting-started/quick-start/cloud" style={{textDecoration: 'none', width: '100%'}}>
+            <CardSecondary
+                badgeState="success"
+                badgeText="recommended"
+                description="Get started with ClickHouse Cloud in minutes.
+          We'll walk you through creating a ClickHouse service,
+          connecting to ClickHouse and adding data to your service via
+          CDC, SQL console, local client or file upload.
+          "
+                icon="cloud"
+                infoText="Get started"
+                infoUrl="clickhouse.com/docs/getting-started/quick-start/cloud"
+                title="Cloud quick start"
+                style={{width: '100%', height: '100%'}}
+            />
+            </Link>
+        </div>
+        <div style={{
+            flex: '1 1 300px',
+            minWidth: '0',
+            maxWidth: '100%',
+            '@media (max-width: 996px)': {
+                width: '100%',
+                maxWidth: 'none',
+                flex: '1 1 auto'
+            }
+        }}>
+            <Link to="/getting-started/quick-start/oss" style={{textDecoration: 'none', width: '100%'}}>
+            <CardSecondary
+                badgeState="success"
+                description="Get started with OSS ClickHouse in minutes. You'll
+          learn how to install ClickHouse server and client locally, create a
+          table and insert some example data into it, and explore the many ways
+          you can get your own data into ClickHouse.
+          "
+                icon="server"
+                infoText="Get started"
+                infoUrl="clickhouse.com/docs/getting-started/quick-start/oss"
+                title="OSS quick start"
+                style={{width: '100%', height: '100%'}}
+            />
+            </Link>
+        </div>
+    </div>
+    <div style={{
+        width: '100%',
+        '@media (max-width: 996px)': {
+            maxWidth: '100%',
+            margin: '0'
+        }
+    }}>
+        <Link to="/cloud/overview" style={{textDecoration: 'none', width: '100%'}}>
+          <CardPromotion
+              icon="question"
+              label="Not sure which to choose? Click here to learn about the differences between Cloud and OSS ClickHouse"
+              style={{
+                  display: 'flex',
+                  flex: '1',
+                  width: '100%',
+                  minHeight: 'auto',
+                  alignItems: 'flex-start',
+                  padding: '1rem',
+                  boxSizing: 'border-box',
+                  cursor: 'pointer'
+              }}
+          />
+        </Link>
+    </div>
+</div>

docs/quick-start.mdx renamed to docs/getting-started/quick-start/oss.mdx

@@ -1,10 +1,9 @@
 ---
-slug: /getting-started/quick-start
-sidebar_label: 'Quick Start'
+slug: /getting-started/quick-start/oss
+sidebar_label: 'OSS'
 sidebar_position: 1
 keywords: ['getting started', 'quick start', 'beginner-friendly']
-pagination_next: getting-started/index
-title: 'Quick Start'
+title: 'ClickHouse OSS quick start'
 description: 'ClickHouse Quick Start guide'
 show_related_blogs: true
 ---
@@ -14,15 +13,13 @@ import TabItem from '@theme/TabItem';
 import CodeBlock from '@theme/CodeBlock';
 import {VerticalStepper} from '@clickhouse/click-ui/bundled';
 
-**Welcome to ClickHouse!**
+# ClickHouse OSS quick start
 
-In this quick-start tutorial, we'll get you set up in 8
+> In this quick start tutorial, we'll get you set up with OSS ClickHousein 8
 easy steps. You'll download an appropriate binary for your OS,
 learn to run ClickHouse server, and use the ClickHouse client to create a table,
 then insert data into it and run a query to select that data.
 
-Let's get started?
-
 <VerticalStepper>
 
 ## Download ClickHouse {#download-the-binary}

docs/guides/best-practices/sparse-primary-indexes.md

@@ -43,7 +43,7 @@ In this guide we are going to do a deep dive into ClickHouse indexing. We will i
 - [what some of the best practices are for indexing in ClickHouse](#using-multiple-primary-indexes)
 
 You can optionally execute all ClickHouse SQL statements and queries given in this guide by yourself on your own machine.
-For installation of ClickHouse and getting started instructions, see the [Quick Start](/quick-start.mdx).
+For installation of ClickHouse and getting started instructions, see the [Quick Start](/get-started/quick-start).
 
 :::note
 This guide is focusing on ClickHouse sparse primary indexes.

docs/guides/sre/keeper/index.md

@@ -480,7 +480,7 @@ If you have ClickHouse installed, you can use the binary directly:
 clickhouse keeper-converter ...
 ```
 
-Otherwise, you can [download the binary](/getting-started/quick-start#download-the-binary) and run the tool as described above without installing ClickHouse.
+Otherwise, you can [download the binary](/getting-started/quick-start/oss#download-the-binary) and run the tool as described above without installing ClickHouse.
 :::