標準オンボーディング

​

AWS向けTerraform Module

module "clickhouse_onboarding" {
  source      = "github.com/ClickHouse/terraform-byoc-onboarding.git//modules/aws?ref=<version>"
  external_id = "<external-id-provided-by-clickhouse>"
}

​

AWS 外部ID

• リージョン: BYOC デプロイメントでは、サポート対象リージョンのドキュメントに記載されているすべてのパブリックリージョンを利用できます。現在、Private Region はサポートされていません。
• VPC/VNet CIDR 範囲: デフォルトでは、BYOC VPC (AWS/GCP) または VNet (Azure) の CIDR 範囲として 10.0.0.0/16 を使用します。別のアカウントとの VPC/VNet peering を予定している場合は、CIDR 範囲が重複しないようにしてください。最小サイズはクラウドによって異なります。
  • AWS: /23
  • Azure: /23
  • GCP: /20
  これらは推奨値ではなく下限です。レプリカごとに IP アドレスを消費するため、大規模なデプロイメントにはより大きな範囲が必要です。
• アベイラビリティゾーン: VPC peering を予定している場合は、ソースアカウントと BYOC アカウントのアベイラビリティゾーンを揃えることで、AZ 間トラフィックのコスト削減につながる場合があります。たとえば AWS では、アベイラビリティゾーンの接尾辞 (a、b、c) が、アカウントごとに異なる物理ゾーン ID を表すことがあります。詳細については、AWS ガイドを参照してください。

​

事前検証

• 権限 — 管理ID (IAM role / service account / service principal) に、ClickHouse Cloudがデプロイメントをプロビジョニングおよび運用するために必要な権限が付与されています。
• 有効化されたサービス (GCP) — 必要なGoogle Cloud API (Compute Engine、Kubernetes Engine、Cloud Storage、Network Connectivity、IAM) がプロジェクトで有効になっています。
• ネットワーク (AWS の既存VPC使用) — VPCとサブネットが、サブネットサイズ、必要なタグ、アベイラビリティゾーンの分散、アウトバウンド接続、利用可能なIPアドレスに関するネットワーク要件を満たしています。
• クォータとガードレール (AWS) — アカウントに十分なサービスクォータ (VPC、NAT ゲートウェイ、Elastic IP、EKS クラスター、vCPUs) があり、必要なアクションを妨げる組織ポリシー (SCP) が設定されていません。

• 再検証 — 事前チェックを再実行します。報告された問題を修正した後、プロビジョニング前にセットアップの準備が整っていることを確認するために使用してください。
• それでも続行 — チェックがFailedでもプロビジョニングを続行します。報告された失敗が誤検知であると確信できる場合にのみ使用してください。そうでない場合、プロビジョニングが途中で失敗する可能性があります。