1.6. 使用 CLI 创建 Red Hat OpenShift Service on AWS 集群
使用 ROSA CLI ( rosa
)创建集群时,您可以选择默认选项来快速创建集群。
先决条件
- 您已完成 Red Hat OpenShift Service on AWS 的 AWS 先决条件。
- 您有可用的 AWS 服务配额。
- 您已在 AWS 控制台中启用了 Red Hat OpenShift Service on AWS。
-
您已在安装主机上安装和配置了最新的 ROSA CLI (
rosa
)。运行rosa 版本
,以查看您当前安装的 ROSA CLI 版本。如果有更新的版本,CLI 提供了下载此升级的链接。 - 已使用 ROSA CLI 登录您的红帽帐户。
- 您已创建了 OIDC 配置。
- 您已确认 AWS Elastic Load Balancing (ELB)服务角色存在于 AWS 帐户中。
流程
使用以下命令之一在 AWS 集群上创建 Red Hat OpenShift Service:
注意在 AWS 集群上创建 Red Hat OpenShift Service 时,默认的无类别域间路由(CIDR)为
10.0.0.0/16
。如果这与 VPC 子网的 CIDR 范围不匹配,请在以下命令中添加--machine-cidr <address_block
>。要了解更多有关 Red Hat OpenShift Service on AWS 的默认 CIDR 范围的信息,请参阅 CIDR 范围定义。如果您没有设置环境变量,请运行以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 指定集群的名称。如果集群名称超过 15 个字符,它将包含自动生成的域前缀,作为 openshiftapps.com 上置备的集群的子域。要自定义子域,请使用 the
-domain-prefix
标志。域前缀不能超过 15 个字符,必须是唯一的,且在集群创建后无法更改。 - 2
- 可选
:--private
参数用于在 AWS 集群上创建私有 Red Hat OpenShift Service。如果使用此参数,请确保只使用专用子网 ID for-subnet-ids
。 - 3
- 默认情况下,特定于集群的 Operator 角色名称使用集群名称和随机 4 位哈希值作为前缀。您可以选择指定一个自定义前缀来替换角色名称中的 <
cluster_name>-<hash
>。创建特定于集群的 Operator IAM 角色时会应用前缀。有关前缀的详情,请参阅关于自定义 Operator IAM 角色前缀。注意如果您在创建关联的集群范围的角色时指定了自定义 ARN 路径,则会自动检测到自定义路径。在以后的步骤中创建它们时,自定义路径会应用于特定于集群的 Operator 角色。
- 4
- 可选:在另一个帐户中假定角色时可能需要的唯一标识符。
如果设置环境变量,请运行以下命令创建带有单个初始机器池的集群,使用公开或私有可用的 API,以及公开或私有可用的 Ingress:
rosa create cluster --private --cluster-name=<cluster_name> \ --mode=auto --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \ --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS
$ rosa create cluster --private --cluster-name=<cluster_name> \ --mode=auto --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \ --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果设置环境变量,请运行以下命令创建带有单个初始机器池、公开可用的 API 和公开的 Ingress 的集群:
rosa create cluster --cluster-name=<cluster_name> --mode=auto \ --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \ --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS
$ rosa create cluster --cluster-name=<cluster_name> --mode=auto \ --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \ --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
运行以下命令检查集群的状态:
rosa describe cluster --cluster=<cluster_name>
$ rosa describe cluster --cluster=<cluster_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在集群安装过程中,输出中会列出以下
State
字段更改:-
待定(准备帐户)
-
安装(进行中的DNS 设置)
-
installing
ready
注意如果安装失败,或者
State
字段在超过 10 分钟后没有变为ready
,请检查安装故障排除文档以了解详细信息。如需更多信息,请参阅 故障排除安装。有关联系红帽支持以获取帮助的步骤,请参阅 获取对 Red Hat OpenShift Service on AWS 的支持。
-
通过观察 Red Hat OpenShift Service on AWS 安装程序日志来跟踪集群创建的进度。要检查日志,请运行以下命令:
rosa logs install --cluster=<cluster_name> --watch \
$ rosa logs install --cluster=<cluster_name> --watch \
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 可选: 要在安装过程中监视新日志消息,请使用--
watch
参数。