用途
Install HO AWS 用于在带有私有 AWS 设置和 external-dns 配置的环境下安装 HyperShift Operator(HO)。该技能面向需要以自定义镜像安装 HO、为 AWS 配置 external-dns,或对管理集群使用私有 AWS 设置的场景。
主要能力
该技能支持以下安装配置:
- 使用自定义镜像安装 HyperShift Operator。
- 为 AWS 配置 external-dns。
- 为管理集群使用私有 AWS 设置。
此外,对 CRD 生成的 API 的更改不需要重建镜像,只需执行 make api && make build。
使用方式
前置条件
在使用此技能前,需要先加载环境文件:
source dev/claude-env.sh
环境配置
dev/claude-env.sh 中提供的环境变量包括:
| 变量 | 说明 |
|---|---|
| HO_IMAGE_REPO | HO 镜像的容器仓库 |
| AWS_CREDENTIALS | AWS 凭据文件路径 |
| EXTERNAL_DNS_DOMAIN | external-dns 的域名过滤 |
| OIDC_BUCKET | 用于 OIDC 的 S3 桶 |
| AWS_REGION | AWS 区域 |
| MGMT_KUBECONFIG | 管理集群 kubeconfig 的路径 |
参数
HO_IMAGE 应指向要安装的镜像,例如 $HO_IMAGE_REPO:autonode。
命令
如需要,先运行 make build。安装命令如下:
KUBECONFIG=$MGMT_KUBECONFIG \
./bin/hypershift install \
--hypershift-image $HO_IMAGE_REPO:YOUR_TAG \
--external-dns-provider=aws \
--external-dns-credentials $AWS_CREDENTIALS \
--external-dns-domain-filter=$EXTERNAL_DNS_DOMAIN \
--oidc-storage-provider-s3-bucket-name $OIDC_BUCKET \
--oidc-storage-provider-s3-credentials $AWS_CREDENTIALS \
--oidc-storage-provider-s3-region $AWS_REGION \
--private-platform=AWS \
--aws-private-creds $AWS_CREDENTIALS \
--enable-conversion-webhook=false \
--aws-private-region=$AWS_REGION
注意事项
- 先构建 CLI:
make hypershift(会生成./bin/hypershift)。 - 确保 AWS 凭据文件存在且可读。
- MGMT_KUBECONFIG 必须指向你的管理集群。
适用场景
- 需要使用自定义镜像安装 HO。
- 希望为 AWS 配置 external-dns。
- 对管理集群使用私有 AWS 设置。
限制
资料未提供其他限制说明。