Skip to content

Commit 9c98a06

Browse files
authored
Merge pull request #4927 from ClickHouse/byoc-dec-update
byoc: update the latest information
2 parents d6604f5 + bf81bf1 commit 9c98a06

File tree

2 files changed

+24
-7
lines changed

2 files changed

+24
-7
lines changed

docs/cloud/guides/infrastructure/01_deployment_options/byoc/01_overview.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,40 @@ description: 'Deploy ClickHouse on your own cloud infrastructure'
77
doc_type: 'reference'
88
---
99

10+
import Image from '@theme/IdealImage';
11+
import byoc1 from '@site/static/images/cloud/reference/byoc-1.png';
12+
1013
## Overview {#overview}
1114

1215
BYOC (Bring Your Own Cloud) allows you to deploy ClickHouse Cloud on your own cloud infrastructure. This is useful if you have specific requirements or constraints that prevent you from using the ClickHouse Cloud managed service.
1316

1417
> **If you would like access, please [contact us](https://clickhouse.com/cloud/bring-your-own-cloud).** Refer to our [Terms of Service](https://clickhouse.com/legal/agreements/terms-of-service) for additional information.
1518
16-
BYOC is currently only supported for AWS. You can join the wait list for GCP and Azure [here](https://clickhouse.com/cloud/bring-your-own-cloud).
17-
1819
:::note
1920
BYOC is designed specifically for large-scale deployments, and requires customers to sign a committed contract.
2021
:::
2122

23+
Supported Cloud Service Providers:
24+
* AWS (GA)
25+
* GCP (Private Preview). Please join the waitlist [here](https://clickhouse.com/cloud/bring-your-own-cloud) if you are interested.
26+
* Azure (Roadmap). Please join the waitlist [here](https://clickhouse.com/cloud/bring-your-own-cloud) if you are interested.
27+
2228
## Glossary {#glossary}
2329

2430
- **ClickHouse VPC:** The VPC owned by ClickHouse Cloud.
2531
- **Customer BYOC VPC:** The VPC, owned by the customer's cloud account, is provisioned and managed by ClickHouse Cloud and dedicated to a ClickHouse Cloud BYOC deployment.
2632
- **Customer VPC** Other VPCs owned by the customer cloud account used for applications that need to connect to the Customer BYOC VPC.
2733

34+
## Architecture {#architecture}
35+
36+
Metrics and logs are stored within the customer's BYOC VPC. Logs are currently stored in locally in EBS. In a future update, logs will be stored in LogHouse, which is a ClickHouse service in the customer's BYOC VPC. Metrics are implemented via a Prometheus and Thanos stack stored locally in the customer's BYOC VPC.
37+
38+
<br />
39+
40+
<Image img={byoc1} size="lg" alt="BYOC Architecture" background='black'/>
41+
42+
<br />
43+
2844
## Features {#features}
2945

3046
### Supported features {#supported-features}
@@ -35,7 +51,7 @@ BYOC is designed specifically for large-scale deployments, and requires customer
3551
- View services and status.
3652
- **Backup and restore.**
3753
- **Manual vertical and horizontal scaling.**
38-
- **Idling.**
54+
- **Auto Idling.**
3955
- **Warehouses**: Compute-Compute Separation
4056
- **Zero Trust Network via Tailscale.**
4157
- **Monitoring**:
@@ -49,6 +65,6 @@ BYOC is designed specifically for large-scale deployments, and requires customer
4965
### Planned features (currently unsupported) {#planned-features-currently-unsupported}
5066

5167
- [AWS KMS](https://aws.amazon.com/kms/) aka CMEK (customer-managed encryption keys)
52-
- ClickPipes for ingest
68+
- ClickPipes
5369
- Autoscaling
5470
- MySQL interface

docs/cloud/guides/infrastructure/01_deployment_options/byoc/03_onboarding/01_aws.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -59,9 +59,10 @@ After creating the CloudFormation stack, you will be prompted to set up the infr
5959
By default, ClickHouse Cloud will provision a dedicated VPC for better isolation in your BYOC deployment. However, you can also use an existing VPC in your account. This requires specific configuration and must be coordinated through ClickHouse Support.
6060

6161
**Configure Your Existing VPC**
62-
1. Allocate at least 3 private subnets across 3 different availability zones for ClickHouse Cloud to use.
63-
2. Ensure each subnet has a minimum CIDR range of `/23` (e.g., 10.0.0.0/23) to provide sufficient IP addresses for the ClickHouse deployment.
64-
3. Add the tag `kubernetes.io/role/internal-elb=1` to each subnet to enable proper load balancer configuration.
62+
1. Tag the VPC with `clickhouse-byoc="true"`.
63+
2. Allocate at least 3 private subnets across 3 different availability zones for ClickHouse Cloud to use.
64+
3. Ensure each subnet has a minimum CIDR range of `/23` (e.g., 10.0.0.0/23) to provide sufficient IP addresses for the ClickHouse deployment.
65+
4. Add the tag `kubernetes.io/role/internal-elb=1` and `clickhouse-byoc="true"` to each subnet to enable proper load balancer configuration.
6566

6667
<br />
6768

0 commit comments

Comments
 (0)