> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Стандартный онбординг

> Развертывание ClickHouse в собственной облачной инфраструктуре

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<div id="what-is-standard-onboarding">
  ## Что такое стандартный онбординг?
</div>

**Стандартный онбординг** — это управляемый процесс развертывания ClickHouse в вашем собственном облачном аккаунте по модели BYOC. В этом случае ClickHouse Cloud создает в вашем аккаунте AWS/проекте GCP все основные облачные ресурсы, необходимые для развертывания, — такие как VPC, подсети, группы безопасности, кластер Kubernetes (EKS/GKE) и вспомогательные роли IAM/сервисные учетные записи. Это обеспечивает единообразную и безопасную конфигурацию, а также сводит к минимуму объем ручных действий со стороны вашей команды.

При стандартном онбординге вам нужно только предоставить выделенный аккаунт AWS/проект GCP и запустить начальный стек (через CloudFormation или Terraform), чтобы создать минимально необходимые разрешения IAM и доверительные отношения, которые нужны ClickHouse Cloud для оркестрации дальнейшей настройки. Все последующие шаги, включая подготовку инфраструктуры и запуск сервиса, выполняются через веб-консоль ClickHouse Cloud.

Клиентам настоятельно рекомендуется подготовить **выделенный** аккаунт AWS или проект GCP для размещения развертывания ClickHouse BYOC, чтобы обеспечить лучшую изоляцию разрешений и ресурсов. ClickHouse развернет в вашем аккаунте выделенный набор облачных ресурсов (VPC, кластер Kubernetes, роли IAM, S3 бакеты и т. д.).

Если вам требуется более гибкая настройка (например, развертывание в существующей VPC), обратитесь к документации [Customized Onboarding](/ru/products/bring-your-own-cloud/onboarding/customization-aws).

<Note>
  Стандартный BYOC-онбординг занимает примерно 45–90 минут от начала до конца — с момента запуска шагов CloudFormation или Terraform до момента, когда становится доступен первый сервис ClickHouse.
</Note>

<div id="request-access">
  ## Запросите доступ
</div>

Чтобы начать процесс онбординга, [свяжитесь с нами](https://clickhouse.com/cloud/bring-your-own-cloud). Наша команда поможет вам разобраться с требованиями BYOC, выбрать наиболее подходящие варианты развертывания и добавить вашу учетную запись в список разрешенных.

<div id="onboarding-process">
  ## Онбординг
</div>

<div id="prepare-an-aws-account">
  ### Подготовьте учетную запись AWS/проект GCP
</div>

Подготовьте новую учетную запись AWS или проект GCP в своей организации. Чтобы продолжить настройку, перейдите в нашу веб-консоль: [https://console.clickhouse.cloud/byocOnboarding](https://console.clickhouse.cloud/byocOnboarding).

<Steps>
  <Step>
    ### Выберите облачного провайдера

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/BPEiEZ_MyYNrC_OM/images/cloud/reference/byoc-onboarding-1.png?fit=max&auto=format&n=BPEiEZ_MyYNrC_OM&q=85&s=ad0e6a04e509e9230da57fb454813a4f" size="lg" alt="BYOC choose CSP" background="black" width="759" height="559" data-path="images/cloud/reference/byoc-onboarding-1.png" />
  </Step>

  <Step>
    ### Настройка учетной записи/проекта

    Первичную настройку BYOC можно выполнить с помощью [CloudFormation template(AWS)](https://s3.us-east-2.amazonaws.com/clickhouse-public-resources.clickhouse.cloud/cf-templates/byoc.yaml) или [Terraform module(GCP)](https://github.com/ClickHouse/terraform-byoc-onboarding/tree/main/modules/gcp). При этом создается высокопривилегированная роль IAM, которая позволяет контроллерам BYOC из ClickHouse Cloud управлять вашей инфраструктурой.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/BPEiEZ_MyYNrC_OM/images/cloud/reference/byoc-onboarding-2.png?fit=max&auto=format&n=BPEiEZ_MyYNrC_OM&q=85&s=3fefc02926e111d5a05176ec53513363" size="lg" alt="BYOC initialize account" background="black" width="1168" height="412" data-path="images/cloud/reference/byoc-onboarding-2.png" />

    <Note>
      Бакеты хранилища, VPC, кластер Kubernetes и вычислительные ресурсы, необходимые для запуска ClickHouse, не входят в эту первоначальную настройку. Они будут подготовлены на следующем шаге.
    </Note>

    #### Альтернативный модуль Terraform для AWS

    Если вы предпочитаете использовать Terraform вместо CloudFormation для развертываний в AWS, мы также предоставляем [модуль Terraform для AWS](https://s3.us-east-2.amazonaws.com/clickhouse-public-resources.clickhouse.cloud/tf/byoc.tar.gz).

    Использование:

    ```hcl theme={null}
    module "clickhouse_onboarding" {
      source   = "https://s3.us-east-2.amazonaws.com/clickhouse-public-resources.clickhouse.cloud/tf/byoc.tar.gz"
      byoc_env = "production"
    }
    ```
  </Step>

  <Step>
    ### Настройте инфраструктуру BYOC

    Вам будет предложено настроить инфраструктуру, включая S3 бакеты, VPC и кластер Kubernetes, из консоли ClickHouse Cloud. Некоторые параметры необходимо определить на этом этапе, так как позже их уже нельзя будет изменить. В частности:

    * **Регион**: Для развертываний BYOC доступны все **общедоступные регионы**, перечисленные в нашей документации [поддерживаемые регионы](/ru/products/cloud/reference/supported-regions). Частные регионы в настоящее время не поддерживаются.

    * **Диапазон VPC CIDR**: По умолчанию для VPC BYOC используется диапазон `10.0.0.0/16`. Если вы планируете использовать пиринг VPC с другой учетной записью, убедитесь, что диапазоны CIDR не пересекаются. Выделите для BYOC подходящий диапазон CIDR минимального размера `/22`, чтобы разместить необходимые рабочие нагрузки.

    * **Зоны доступности**: Если вы планируете использовать пиринг VPC, согласование зон доступности между исходной учетной записью и учетной записью BYOC может помочь сократить затраты на межзонный трафик. Например, в AWS суффиксы зон доступности (`a`, `b`, `c`) могут обозначать разные идентификаторы физических зон в разных учетных записях. Подробнее см. в [руководстве AWS](https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/use-consistent-availability-zones-in-vpcs-across-different-aws-accounts.html).

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/BPEiEZ_MyYNrC_OM/images/cloud/reference/byoc-onboarding-3.png?fit=max&auto=format&n=BPEiEZ_MyYNrC_OM&q=85&s=f866b9b5145a2a093ea3a3f3b3346942" size="lg" alt="BYOC setup infra" background="black" width="1610" height="1164" data-path="images/cloud/reference/byoc-onboarding-3.png" />
  </Step>
</Steps>

<div id="create-clickhouse-service">
  ### Создайте свой первый BYOC-сервис ClickHouse
</div>

После того как ваша BYOC-инфраструктура будет подготовлена, можно запускать первый сервис ClickHouse. Откройте консоль ClickHouse Cloud, выберите свою BYOC-среду и следуйте подсказкам, чтобы создать новый сервис.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/BPEiEZ_MyYNrC_OM/images/cloud/reference/byoc-new-service-1.png?fit=max&auto=format&n=BPEiEZ_MyYNrC_OM&q=85&s=47a75a3cc4b6ba056dea5cf8e273e897" size="md" alt="BYOC создание нового сервиса" width="732" height="881" data-path="images/cloud/reference/byoc-new-service-1.png" />

При создании сервиса вы настроите следующие параметры:

* **Service name**: Введите понятное и информативное имя для вашего сервиса ClickHouse.
* **BYOC infrastructure**: Выберите BYOC-среду, включая облачную учетную запись и регион, в которых будет работать сервис.
* **Resource configuration**: Выберите объем CPU и памяти, выделяемых для реплик ClickHouse.
* **Replica count**: Укажите количество реплик для повышения отказоустойчивости и Высокой доступности.