openchoreo-setup

OpenChoreo のセットアップ

OpenChoreo を Kubernetes にブートストラップします。対象は 2 つで、それぞれにシングルクラスターとマルチクラスターの手順があります。

k3d 上でローカルに実行（開発／コントリビューター向けワークフロー）

• シングルクラスター → ./references/on-k3d-locally.md
• マルチクラスター（プレーンごとに 1 クラスター）→ ./references/on-k3d-multi-cluster.md

お使いの Kubernetes 環境上で実行（k3s、GKE、EKS、AKS、DOKS、Rancher Desktop、またはセルフマネージド）

• シングルクラスター → ./references/on-your-environment.md
• マルチクラスター（完全なマルチクラスター、ハイブリッド、またはマルチリージョン）→ ./references/multi-cluster.md

ユーザーが対象とトポロジーを指定していない場合は、どちらにするか尋ねてください。次に、該当するリファレンスを読み込み、最初から最後までその手順に従ってください。そのパスでの選択内容の確認、バージョンの解決、取得、手順の実行、結果の報告は、すべてそのリファレンスに記載されています。

まず kube コンテキストを固定する

kubectl／helm を実行する前に、各コマンドがどのコンテキストを対象とするかを確認し、明示的に指定してください。アクティブなコンテキストに依存してはいけません。環境には複数のコンテキストが設定されていることが一般的です（アクティブなコンテキストがプレースホルダーや誤ったクラスターの場合もあります）。そのため、コンテキストを暗黙に指定すると、誤った場所にインストールされてしまう可能性があります。

• 最初に対象を確認します。kubectl config get-contexts を実行し、どのコンテキストをインストール先にするかユーザーと決めてください（必要に応じて作成／名前変更します）。マルチクラスターの場合は、プレーンごと（cp／dp／op／wp）に 1 つずつコンテキストを決めます。
• すべてのコマンドにコンテキストを指定します。kubectl --context=<ctx> … および helm --kube-context=<ctx> … を使用してください。マルチクラスターの場合は、各コマンドでプレーンのコンテキストを指定し、手順をまたいで「current」状態が引き継がれることに依存してはいけません。
• 最初の kubectl 呼び出しで認証プロンプト／EOF／到達不能な API のエラーが発生した場合、アクティブなコンテキストはダミーまたは誤ったクラスターです。回避策を講じず、続行する前にコンテキストを解決してください。