Add UI instructions and overview

Author: jhlodin

src/current/_includes/cockroachcloud/byoc/byoc-common-prerequisites.md

@@ -1,5 +1,9 @@
+- Review the [shared responsibility model for BYOC]({% link cockroachcloud/byoc-overview.md %}#shared-responsibility-model-for-byoc). Make sure you understand and acknowledge the responsibilities you hold for management of your cloud infrastucture and the necessary permissions you must grant to Cockroach Labs.
+
 - [Create a CockroachDB {{ site.data.products.cloud }} organization]({% link cockroachcloud/create-an-account.md %}) if you do not already have one. 
 
+- (Optional) Create an [API service account]({% link cockroachcloud/managing-access.md %}#create-api-keys) to use the [{{ site.data.products.cloud }} API]({% link cockroachcloud/cloud-api.md %}) with your {{ site.data.products.cloud }} organization.
+
 - The BYOC deployment option is not available by default and must be requested. Reach out to your account team to express interest in BYOC.
 
 - Review the [Plan a CockroachDB {{ site.data.products.advanced }} Cluster]({% link cockroachcloud/plan-your-cluster-advanced.md %}) documentation to plan your cluster sizing and resource allocation.

src/current/_includes/cockroachcloud/byoc/byoc-responsibility-model.md

@@ -1,22 +1,16 @@
 ---
-title: Prepare a CockroachDB Cloud BYOC Deployment in AWS
+title: Prepare a CockroachDB Cloud BYOC Deployment in Amazon Web Services
 summary: Prepare a cloud service account to self-host a CockroachDB Cloud deployment with the BYOC model
 toc: true
 keywords: deployment, byoc
 ---
 
-CockroachDB {{ site.data.products.cloud }} supports a "bring your own cloud" (BYOC) deployment model, where CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} is hosted in your own account rather than in an account managed by Cockroach Labs. This model allows you to take more control of security and take advantage of existing cloud service credits or discounts.
+This page describes how to prepare a cloud service account to host a [BYOC deployment]({% link cockroachcloud/byoc-overview.md %}) of CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} in Amazon Web Services (AWS).
 
 {{site.data.alerts.callout_info}}
 The BYOC {{ site.data.products.cloud }} deployment option is currently in [Preview]({% link {{ site.current_cloud_version }}/cockroachdb-feature-availability.md %}).
 {{site.data.alerts.end}}
 
-This page describes how to prepare a cloud service account to host a BYOC deployment of CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} in Microsoft Azure.
-
-## Shared responsibility model for BYOC
-
-{% include cockroachcloud/byoc/byoc-responsibility-model.md %}
-
 ## Prerequisites
 
 {% include cockroachcloud/byoc/byoc-common-prerequisites.md %}
@@ -218,7 +212,22 @@ You may also need to adjust quotas for vCPU and EBS disk storage for the regions
 
 ## Step 5. Create the CockroachDB {{ site.data.products.cloud }} cluster
 
-In BYOC deployments, CockroachDB clusters are deployed with the {{ site.data.products.cloud }} API and must use the {{ site.data.products.advanced }} plan. Follow the API documentation to [create a CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} cluster]({% link cockroachcloud/cloud-api.md %}#create-an-advanced-cluster).
+In BYOC deployments, CockroachDB clusters can be deployed in the {{ site.data.products.cloud }} Console or with the [{{ site.data.products.cloud }} API]({% link cockroachcloud/cloud-api.md %}).
+
+### Create a cluster with the {{ site.data.products.cloud }} Console
+
+Follow these steps to create a CockroachDB cluster in the {{ site.data.products.cloud }} console:
+
+1. Open the {{ site.data.products.cloud }} and select the organization that has been enabled for BYOC.
+1. Click **Create cluster**
+1. Under **Select a plan**, click **{{ site.data.products.advanced }}.
+1. Under **Cloud & Regions**, click **Bring Your Own Cloud** and select AWS.
+1. Under **Cloud account**, click **Select your cloud account > Add new cloud account**. Enter the ARN associated with your intermediate IAM role.
+1. Follow the rest of the **Create Cluster** steps to configure your cluster's regions, capacity, and features as desired. Read the [Plan a CockroachDB {{ site.data.products.advanced}} Cluster]({% link cockroachcloud/plan-your-cluster-advanced.md %}) documentation for more details.
+
+### Create a cluster with the {{ site.data.products.cloud }} API
+
+Send a `POST` request to the the `/v1/clusters` endpoint to [create a CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} cluster]({% link cockroachcloud/cloud-api.md %}#create-an-advanced-cluster).
 
 The following example request creates a 3-node {{ site.data.products.advanced }} cluster in the `us-east-2` region, specifying the ARN associated with your intermediate IAM role:
 

src/current/cockroachcloud/byoc-aws-deployment.md

@@ -5,18 +5,12 @@ toc: true
 keywords: deployment, byoc
 ---
 
-CockroachDB {{ site.data.products.cloud }} supports a "bring your own cloud" (BYOC) deployment model, where CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} is hosted in your own account rather than in an account managed by Cockroach Labs. This model allows you to take more control of security and take advantage of existing cloud service credits or discounts.
+This page describes how to prepare a cloud service account to host a [BYOC deployment]({% link cockroachcloud/byoc-overview.md %}) of CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} in Microsoft Azure.
 
 {{site.data.alerts.callout_info}}
 The BYOC {{ site.data.products.cloud }} deployment option is currently in [Preview]({% link {{ site.current_cloud_version }}/cockroachdb-feature-availability.md %}).
 {{site.data.alerts.end}}
 
-This page describes how to prepare a cloud service account to host a BYOC deployment of CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} in Microsoft Azure.
-
-## Shared responsibility model for BYOC
-
-{% include cockroachcloud/byoc/byoc-responsibility-model.md %}
-
 ## Prerequisites
 
 {% include cockroachcloud/byoc/byoc-common-prerequisites.md %}
@@ -230,7 +224,22 @@ Register the following [resource providers](https://learn.microsoft.com/azure/az
 
 ## Step 6. Create the CockroachDB {{ site.data.products.cloud }} cluster
 
-In BYOC deployments, CockroachDB clusters are deployed with the {{ site.data.products.cloud }} API and must use the {{ site.data.products.advanced }} plan. Follow the API documentation to [create a CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} cluster]({% link cockroachcloud/cloud-api.md %}#create-an-advanced-cluster).
+In BYOC deployments, CockroachDB clusters can be deployed in the {{ site.data.products.cloud }} Console or with the [{{ site.data.products.cloud }} API]({% link cockroachcloud/cloud-api.md %}).
+
+### Create a cluster with the {{ site.data.products.cloud }} Console
+
+Follow these steps to create a CockroachDB cluster in the {{ site.data.products.cloud }} console:
+
+1. Open the {{ site.data.products.cloud }} and select the organization that has been enabled for BYOC.
+1. Click **Create cluster**
+1. Under **Select a plan**, click **{{ site.data.products.advanced }}.
+1. Under **Cloud & Regions**, click **Bring Your Own Cloud** and select Azure.
+1. Under **Cloud account**, click **Select your cloud account > Add new cloud account**. Enter the tenant ID and subscription ID associated with your Azure subscription.
+1. Follow the rest of the **Create Cluster** steps to configure your cluster's regions, capacity, and features as desired. Read the [Plan a CockroachDB {{ site.data.products.advanced}} Cluster]({% link cockroachcloud/plan-your-cluster-advanced.md %}) documentation for more details.
+
+### Create a cluster with the {{ site.data.products.cloud }} API
+
+Send a `POST` request to the the `/v1/clusters` endpoint to [create a CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} cluster]({% link cockroachcloud/cloud-api.md %}#create-an-advanced-cluster).
 
 The following example request creates a 3-node {{ site.data.products.advanced }} cluster in the `centralus` region, specifying the `subscription-id` and `customer-tenant-id` associated with your Azure subscription:
 

src/current/cockroachcloud/byoc-azure-deployment.md

@@ -1,22 +1,16 @@
 ---
-title: Prepare a CockroachDB Cloud BYOC Deployment in GCP
+title: Prepare a CockroachDB Cloud BYOC Deployment in Google Cloud Platform
 summary: Prepare a cloud service account to self-host a CockroachDB Cloud deployment with the BYOC model
 toc: true
 keywords: deployment, byoc
 ---
 
-CockroachDB {{ site.data.products.cloud }} supports a "bring your own cloud" (BYOC) deployment model, where CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} is hosted in your own account rather than in an account managed by Cockroach Labs. This model allows you to take more control of security and take advantage of existing cloud service credits or discounts.
+This page describes how to prepare a cloud service account to host a [BYOC deployment]({% link cockroachcloud/byoc-overview.md %}) of CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} in Google Cloud Platform (GCP).
 
 {{site.data.alerts.callout_info}}
 The BYOC {{ site.data.products.cloud }} deployment option is currently in [Preview]({% link {{ site.current_cloud_version }}/cockroachdb-feature-availability.md %}).
 {{site.data.alerts.end}}
 
-This page describes how to prepare a cloud service account to host a BYOC deployment of CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} in GCP.
-
-## Shared responsibility model for BYOC
-
-{% include cockroachcloud/byoc/byoc-responsibility-model.md %}
-
 ## Prerequisites
 
 {% include cockroachcloud/byoc/byoc-common-prerequisites.md %}
@@ -56,7 +50,22 @@ Follow these steps to create the intermediate service account:
 
 ## Step 3. Create the CockroachDB {{ site.data.products.cloud }} cluster
 
-In BYOC deployments, CockroachDB clusters are deployed with the {{ site.data.products.cloud }} API and must use the {{ site.data.products.advanced }} plan. Follow the API documentation to [create a CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} cluster]({% link cockroachcloud/cloud-api.md %}#create-an-advanced-cluster).
+In BYOC deployments, CockroachDB clusters can be deployed in the {{ site.data.products.cloud }} Console or with the [{{ site.data.products.cloud }} API]({% link cockroachcloud/cloud-api.md %}).
+
+### Create a cluster with the {{ site.data.products.cloud }} Console
+
+Follow these steps to create a CockroachDB cluster in the {{ site.data.products.cloud }} console:
+
+1. Open the {{ site.data.products.cloud }} and select the organization that has been enabled for BYOC.
+1. Click **Create cluster**
+1. Under **Select a plan**, click **{{ site.data.products.advanced }}.
+1. Under **Cloud & Regions**, click **Bring Your Own Cloud** and select Google Cloud.
+1. Under **Cloud account**, click **Select your cloud account > Add new cloud account**. Enter the service account email associated with your intermediate service account.
+1. Follow the rest of the **Create Cluster** steps to configure your cluster's regions, capacity, and features as desired. Read the [Plan a CockroachDB {{ site.data.products.advanced}} Cluster]({% link cockroachcloud/plan-your-cluster-advanced.md %}) documentation for more details.
+
+### Create a cluster with the {{ site.data.products.cloud }} API
+
+Send a `POST` request to the the `/v1/clusters` endpoint to [create a CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} cluster]({% link cockroachcloud/cloud-api.md %}#create-an-advanced-cluster).
 
 The following example request creates a 3-node {{ site.data.products.advanced }} cluster in the `us-east1` region, specifying the `service_account_email` associated with the intermediate service account you created:
 

src/current/cockroachcloud/byoc-gcp-deployment.md

@@ -5,4 +5,32 @@ toc: true
 keywords: deployment, byoc
 ---
 
-TODO
+CockroachDB {{ site.data.products.cloud }} supports a ["bring your own cloud" (BYOC) deployment model](https://www.cockroachlabs.com/product/cloud/bring-your-own-cloud/), where CockroachDB {{ site.data.products.cloud }} {{ site.data.products.advanced }} is hosted in your own account rather than in an account managed by Cockroach Labs. This model allows you to take more control of security and take advantage of existing cloud service credits or discounts.
+
+{{site.data.alerts.callout_info}}
+The BYOC {{ site.data.products.cloud }} deployment option is currently in [Preview]({% link {{ site.current_cloud_version }}/cockroachdb-feature-availability.md %}).
+{{site.data.alerts.end}}
+
+## Shared responsibility model for BYOC
+
+In any CockroachDB {{ site.data.products.cloud }} deployment, responsibility for a successful and healthy deployment is [split between you and Cockroach Labs]({% link cockroachcloud/production-checklist.md %}). In a BYOC deployment, all of the [CockroachDB {{ site.data.products.cloud }} infrastructure]({% link cockroachcloud/plan-your-cluster-advanced.md %}#advanced-cluster-architecture) except the control plane lives in an account under your control, which means that you incur additional responsibilities under the shared model.
+
+The following table describes the split of responsibilities between you and Cockroach Labs in the shared responsibility model for BYOC:
+
+Area        | Cockroach Labs responsibility | Customer responsibility
+:----------:|:-----------------------------:|:----------------------:
+Uptime      | Ensure 99.999% cluster uptime | Ensure that clusters remain accessible
+Deployments | Automate cluster provisioning and scaling, provide hardware best practices | Provision new cloud service accounts and grant IAM permissions for Cockroach Labs to create and manage clusters
+Upgrades    | Provide automatic minor/patch upgrades and major upgrade automation via Terraform, APIs, or the {{ site.data.products.cloud }} Console | Initiate [major version upgrades]({% link cockroachcloud/upgrade-cockroach-version.md %}), [set maintenance windows]({% link cockroachcloud/advanced-cluster-management.md %}#set-a-maintenance-window) if applicable
+Workload    | Troubleshoot problems as they pertain to cluster availability | [Size clusters]({% link cockroachcloud/advanced-cluster-management.md %}#scale-your-cluster) to manage workload requirements, [tune performance]({% link {{ site.versions["stable"] }}/performance-recipes.md %}), and adjust schema designs with support from Cockroach Labs
+Backups     | Initialize a default backup schedule and write to customer-owned Cloud storage, ensure backup jobs run successfully | Configure a backup schedule as needed to meet RPO/RTO requirements
+Support     | Reactively and proactively identify and resolve availability-impacting incidents | Ensure sufficient hardware is made available and appropriate IAM permissions are maintained at all times
+Billing     | Meter vCPUs consumed, [charge for vCPU consumption]({% link cockroachcloud/costs.md %}) at the per-minute level | Negotiate with cloud service provider, manage infrastructure spend and discounts
+
+## Next steps
+
+CockroachDB supports BYOC deployments in Amazon Web Services, Microsoft Azure, and Google Cloud Platform. Read the corresponding deployment guides:
+
+- [Prepare a CockroachDB Cloud BYOC Deployment in Amazon Web Services]({% link cockroachcloud/byoc-aws-deployment.md %}).
+- [Prepare a CockroachDB Cloud BYOC Deployment in Azure]({% link cockroachcloud/byoc-azure-deployment.md %}).
+- [Prepare a CockroachDB Cloud BYOC Deployment in Google Cloud Platform]({% link cockroachcloud/byoc-gcp-deployment.md %}).