用途:Create HC AWS 是 openshift/hypershift 提供的技能,用于在 AWS 上创建 HyperShift HostedCluster,面向本地开发与测试流程,官方明确说明不用于生产。
适用场景:需要创建开发/测试用 HostedCluster 进行手动验证;针对真实集群测试 HyperShift 特性;需要带自定义 CPO 或 HO 镜像的 HostedCluster;迭代代码改动并需要集群验证。
前置条件:先执行 source dev/claude-env.sh;需已加载 AWS 凭据(source $AWS_CREDS_SOURCE)、KUBECONFIG 指向管理集群($MGMT_KUBECONFIG)、已构建 hypershift 二进制(./bin/hypershift 或 make hypershift)、可用 pull secret($PULL_SECRET)。相关环境变量包括 AWS_CREDENTIALS、AWS_CREDS_SOURCE、BASE_DOMAIN、PULL_SECRET、AWS_REGION、MGMT_KUBECONFIG、CPO_IMAGE_REPO。
基本用法:source $AWS_CREDS_SOURCE && KUBECONFIG=$MGMT_KUBECONFIG ./bin/hypershift create cluster aws --name <CLUSTER_NAME> --namespace clusters --base-domain $BASE_DOMAIN --aws-creds $AWS_CREDENTIALS --pull-secret $PULL_SECRET --region $AWS_REGION --release-image quay.io/openshift-release-dev/ocp-release:4.21.0-multi --node-pool-replicas 2。常用参数中 --name 必填;--namespace 默认 clusters;--node-pool-replicas 默认 0;--control-plane-operator-image 可选,用于测试 CPO 改动。
创建内容:AWS VPC(含公有/私有子网)、NAT 与互联网网关、路由表、Route53 私有托管区、STS 用 OIDC provider、控制平面组件 IAM 角色、worker 实例配置文件,以及 HostedCluster 与 NodePool 资源。
创建后操作:用 KUBECONFIG=$MGMT_KUBECONFIG kubectl get hostedcluster -n clusters 查看状态;等待 Available 条件;用 kubectl scale nodepool 扩容节点;从 secret <CLUSTER_NAME>-admin-kubeconfig 导出访客集群 kubeconfig。
清理:使用 dev:destroy-hc-aws 技能,或执行 hypershift destroy cluster aws 命令(需指定 --name、--namespace、--aws-creds、--region)。
限制与排障:集群创建失败时检查 AWS 凭据、Route53 基础域名与 OIDC S3 桶可达性;控制平面不可用时查看 HCP pods 与 HCP 条件;节点未加入时查看 machines 与 NodePool 条件。其他未在资料中提供的信息暂未提供。