Skip to content

Commit d3c15cf

Browse files
committed
byoc: update the latest information
1 parent 6b4acf8 commit d3c15cf

File tree

2 files changed

+26
-7
lines changed

2 files changed

+26
-7
lines changed

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

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,42 @@ 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+
37+
38+
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.
39+
40+
<br />
41+
42+
<Image img={byoc1} size="lg" alt="BYOC Architecture" background='black'/>
43+
44+
<br />
45+
2846
## Features {#features}
2947

3048
### Supported features {#supported-features}
@@ -35,7 +53,7 @@ BYOC is designed specifically for large-scale deployments, and requires customer
3553
- View services and status.
3654
- **Backup and restore.**
3755
- **Manual vertical and horizontal scaling.**
38-
- **Idling.**
56+
- **Auto Idling.**
3957
- **Warehouses**: Compute-Compute Separation
4058
- **Zero Trust Network via Tailscale.**
4159
- **Monitoring**:
@@ -49,6 +67,6 @@ BYOC is designed specifically for large-scale deployments, and requires customer
4967
### Planned features (currently unsupported) {#planned-features-currently-unsupported}
5068

5169
- [AWS KMS](https://aws.amazon.com/kms/) aka CMEK (customer-managed encryption keys)
52-
- ClickPipes for ingest
70+
- ClickPipes
5371
- Autoscaling
5472
- 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)