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

# Onboarding padrão

> Implante o ClickHouse na sua própria infraestrutura de nuvem

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

<div id="what-is-standard-onboarding">
  ## O que é o onboarding padrão?
</div>

**Onboarding padrão** é o fluxo guiado padrão para implantar o ClickHouse na sua própria conta de nuvem usando BYOC. Nessa abordagem, o ClickHouse Cloud provisiona todos os principais recursos de nuvem necessários para a implantação — como VPC, sub-redes, grupos de segurança, cluster do Kubernetes (EKS/GKE) e IAM roles/contas de serviço de suporte — na sua conta da AWS/projeto do GCP. Isso garante uma configuração consistente e segura, além de minimizar as etapas manuais necessárias da sua equipe.

Com o onboarding padrão, basta fornecer uma conta dedicada da AWS/projeto dedicado do GCP e executar uma stack inicial (via CloudFormation ou Terraform) para criar as permissões mínimas de IAM e a relação de confiança necessárias para que o ClickHouse Cloud orquestre o restante da configuração. Todas as etapas subsequentes — incluindo o provisionamento da infraestrutura e o lançamento do serviço — são gerenciadas pelo console web do ClickHouse Cloud.

É altamente recomendável que os clientes preparem uma conta da AWS ou um projeto do GCP **dedicado** para hospedar a implantação BYOC do ClickHouse, a fim de garantir melhor isolamento em termos de permissões e recursos. O ClickHouse implantará um conjunto dedicado de recursos de nuvem (VPC, cluster do Kubernetes, IAM roles, buckets do S3 etc.) na sua conta.

Se você precisar de uma configuração mais personalizada (por exemplo, implantar em uma VPC existente), consulte a documentação de [Customized Onboarding](/pt-BR/products/bring-your-own-cloud/onboarding/customization-aws).

<Note>
  Um onboarding BYOC padrão leva aproximadamente de 45 a 90 minutos de ponta a ponta, medidos desde o momento em que as etapas do CloudFormation ou do Terraform são iniciadas até o momento em que o primeiro serviço do ClickHouse fica acessível.
</Note>

<div id="request-access">
  ## Solicitar acesso
</div>

Para iniciar o processo de onboarding, [entre em contato conosco](https://clickhouse.com/cloud/bring-your-own-cloud). Nossa equipe orientará você quanto aos requisitos do BYOC, ajudará a selecionar as opções de implantação mais adequadas e adicionará sua conta à lista de permissões.

<div id="onboarding-process">
  ## Onboarding
</div>

<div id="prepare-an-aws-account">
  ### Prepare uma conta AWS/projeto GCP
</div>

Prepare uma nova conta AWS ou um projeto GCP na sua organização. Acesse nosso console web: [https://console.clickhouse.cloud/byocOnboarding](https://console.clickhouse.cloud/byocOnboarding) para continuar a configuração.

<Steps>
  <Step>
    ### Escolha um provedor de Cloud

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

  <Step>
    ### Configuração da conta/projeto

    A configuração inicial do BYOC pode ser feita usando um [template do CloudFormation (AWS)](https://s3.us-east-2.amazonaws.com/clickhouse-public-resources.clickhouse.cloud/cf-templates/byoc.yaml) ou um [módulo do Terraform (GCP)](https://github.com/ClickHouse/terraform-byoc-onboarding/tree/main/modules/gcp). Isso cria uma função do IAM com privilégios elevados, permitindo que os controladores de BYOC do ClickHouse Cloud gerenciem sua infraestrutura.

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

    <Note>
      Os buckets de armazenamento, a VPC, o cluster do Kubernetes e os recursos de computação necessários para executar o ClickHouse não estão incluídos nesta configuração inicial. Eles serão provisionados na próxima etapa.
    </Note>

    #### Módulo alternativo do Terraform para AWS

    Se você preferir usar Terraform em vez de CloudFormation para implantações na AWS, também fornecemos um [módulo do Terraform para AWS](https://s3.us-east-2.amazonaws.com/clickhouse-public-resources.clickhouse.cloud/tf/byoc.tar.gz).

    Uso:

    ```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>
    ### Configure a infraestrutura do BYOC

    Você será solicitado a configurar a infraestrutura, incluindo buckets do S3, VPC e o cluster do Kubernetes, no console do ClickHouse Cloud. Algumas configurações precisam ser definidas nesta etapa, pois não poderão ser alteradas depois. Especificamente:

    * **Região**: Todas as **regiões públicas** listadas na nossa documentação de [regiões compatíveis](/pt-BR/products/cloud/reference/supported-regions) estão disponíveis para implantações de BYOC. Regiões privadas não têm suporte no momento.

    * **Intervalo CIDR da VPC**: Por padrão, usamos `10.0.0.0/16` para o intervalo CIDR da VPC do BYOC. Se você pretende usar VPC peering com outra conta, certifique-se de que os intervalos CIDR não se sobreponham. Aloque um intervalo CIDR adequado para o BYOC, com tamanho mínimo de `/22`, para acomodar as cargas de trabalho necessárias.

    * **Zonas de disponibilidade**: Se você pretende usar VPC peering, alinhar as zonas de disponibilidade entre as contas de origem e do BYOC pode ajudar a reduzir os custos de tráfego entre AZs. Por exemplo, na AWS, os sufixos de zona de disponibilidade (`a`, `b`, `c`) podem representar IDs de zonas físicas diferentes entre contas. Consulte o [guia da AWS](https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/use-consistent-availability-zones-in-vpcs-across-different-aws-accounts.html) para mais detalhes.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/_21esTusVC0YTooo/images/cloud/reference/byoc-onboarding-3.png?fit=max&auto=format&n=_21esTusVC0YTooo&q=85&s=a4b50732dd28634269e3ccc3341de101" 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">
  ### Crie seu primeiro serviço BYOC do ClickHouse
</div>

Depois que sua infraestrutura BYOC for provisionada, você poderá lançar seu primeiro serviço do ClickHouse. Abra o console do ClickHouse Cloud, selecione seu ambiente BYOC e siga as instruções para criar um novo serviço.

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/_21esTusVC0YTooo/images/cloud/reference/byoc-new-service-1.png?fit=max&auto=format&n=_21esTusVC0YTooo&q=85&s=9f9fd07dbe5deadf907c0b71fb1ff6e4" size="md" alt="BYOC criar um novo serviço" width="732" height="881" data-path="images/cloud/reference/byoc-new-service-1.png" />

Durante a criação do serviço, você configurará as seguintes opções:

* **Nome do serviço**: Insira um nome claro e descritivo para seu serviço do ClickHouse.
* **Infraestrutura BYOC**: Selecione o ambiente BYOC, incluindo a conta na nuvem e a região, em que seu serviço será executado.
* **Configuração de recursos**: Escolha a quantidade de CPU e memória alocada às réplicas do ClickHouse.
* **Número de réplicas**: Defina o número de réplicas para aumentar a alta disponibilidade.