安装集群

流程

1. 登录到 AWS 管理控制台。
2. 导航到 ROSA 服务。

3. 点 Get started。

   此时会打开 Verify ROSA 先决条件 页面。

4. 在 ROSA 启用 下，确保 显示绿色勾号以及之前启用的 ROSA。

   如果没有，请按照以下步骤执行：

   1. 选中 我同意与红帽共享我的联系信息 旁边的复选框。

   2. 点 Enable ROSA。

      在短暂等待后，会显示应绿色勾号并显示启用了 ROSA 的信息。

5. 在 Service Quotas 下，确保显示绿色检查 ，并且您的配额满足 ROSA 的要求。

   如果您看到 您的配额不符合最低要求，请记下配额类型和错误消息中列出的最小值。有关 请求增加配额的信息， 请参阅 Amazon 文档。Amazon 可能需要几小时时间才能批准您的配额请求。

6. 在 ELB 服务链接的角色 下，确保显示绿色勾号，AWSServiceRoleForElasticLoadBalancing 已存在。

7. 单击 Continue to Red Hat。

   Get started with Red Hat OpenShift Service on AWS (ROSA) 页面会在一个新标签页中打开。您已在此页中完成了第 1 步，现在可以继续执行第 2 步。

流程

1. 登录到您的红帽帐户和 AWS 帐户，访问每个所需工具的下载页面。

   1. 在 console.redhat.com 中登录到您的红帽帐户。
   2. 登录到位于 aws.amazon.com 的 AWS 帐户。

2. 安装和配置最新的 AWS CLI (aws)。

   1. 按照适用于您的工作站的 AWS 命令行接口 文档安装 AWS CLI。

   2. 通过在 .aws/credentials 文件中指定 aws_access_key_id、aws_secret_access_key 和 region 来配置 AWS CLI。如需更多信息，请参阅 AWS 文档中的 AWS 配置基础知识。

      注意

      您可以选择使用 AWS_DEFAULT_REGION 环境变量设置默认 AWS 区域。

   3. 查询 AWS API 以验证是否已安装并配置了 AWS CLI：

      $ aws sts get-caller-identity  --output text

      Copy to Clipboard Toggle word wrap

      输出示例

      <aws_account_id>    arn:aws:iam::<aws_account_id>:user/<username>  <aws_user_id>

      Copy to Clipboard Toggle word wrap

3. 安装和配置最新的 ROSA CLI。

   1. 导航到 Downloads。

   2. 在工具列表中找到 Red Hat OpenShift Service on AWS 命令行界面(rosa)，然后点 Download。

      rosa-linux.tar.gz 文件下载到您的默认下载位置。

   3. 从下载的存档中提取 rosa 二进制文件。以下示例从 Linux tar 归档中提取二进制文件：

      $ tar xvf rosa-linux.tar.gz

      Copy to Clipboard Toggle word wrap

   4. 将 rosa 二进制文件移到执行路径的目录中。在以下示例中，/usr/local/bin 目录包含在用户的路径中：

      $ sudo mv rosa /usr/local/bin/rosa

      Copy to Clipboard Toggle word wrap

   5. 通过查询 rosa 版本来验证 ROSA CLI 是否已正确安装：

      $ rosa version

      Copy to Clipboard Toggle word wrap

      输出示例

      1.2.47
      Your ROSA CLI is up to date.

      Copy to Clipboard Toggle word wrap

4. 使用离线访问令牌登录到 ROSA CLI。

   1. 运行 login 命令：

      $ rosa login

      Copy to Clipboard Toggle word wrap

      输出示例

      To login to your Red Hat account, get an offline access token at https://console.redhat.com/openshift/token/rosa
      ? Copy the token and paste it here:

      Copy to Clipboard Toggle word wrap

   2. 导航到命令输出中列出的 URL，以查看您的离线访问令牌。

   3. 在命令行提示符处输入离线访问令牌以进行登录。

      ? Copy the token and paste it here: *******************
      [full token length omitted]

      Copy to Clipboard Toggle word wrap
      注意

      以后，您可以在运行 rosa login 命令时使用-- token="<offline_access_token >" 参数指定离线访问令牌。

   4. 在继续操作前，验证您是否已登录并确认您的凭证正确：

      $ rosa whoami

      Copy to Clipboard Toggle word wrap

      输出示例

      AWS Account ID:               <aws_account_number>
      AWS Default Region:           us-east-1
      AWS ARN:                      arn:aws:iam::<aws_account_number>:user/<aws_user_name>
      OCM API:                      https://api.openshift.com
      OCM Account ID:               <red_hat_account_id>
      OCM Account Name:             Your Name
      OCM Account Username:         you@domain.com
      OCM Account Email:            you@domain.com
      OCM Organization ID:          <org_id>
      OCM Organization Name:        Your organization
      OCM Organization External ID: <external_org_id>

      Copy to Clipboard Toggle word wrap

5. 安装和配置最新的 OpenShift CLI (oc)。

   1. 使用 ROSA CLI 下载 oc CLI。

      以下命令将 CLI 的最新版本下载到当前工作目录：

      $ rosa download openshift-client

      Copy to Clipboard Toggle word wrap

   2. 从下载的存档中提取 oc 二进制文件。以下示例从 Linux tar 归档中提取文件：

      $ tar xvf openshift-client-linux.tar.gz

      Copy to Clipboard Toggle word wrap

   3. 将 oc 二进制文件移到执行路径的目录中。在以下示例中，/usr/local/bin 目录包含在用户的路径中：

      $ sudo mv oc /usr/local/bin/oc

      Copy to Clipboard Toggle word wrap

   4. 验证 oc CLI 是否已正确安装：

      $ rosa verify openshift-client

      Copy to Clipboard Toggle word wrap

      输出示例

      I: Verifying whether OpenShift command-line tool is available...
      I: Current OpenShift Client Version: 4.17.3

      Copy to Clipboard Toggle word wrap

流程

1. 如果您的 AWS 帐户不存在它们，请创建所需的帐户范围 AWS IAM STS 角色和策略：

   $ rosa create account-roles --hosted-cp

   Copy to Clipboard Toggle word wrap

   选择提示中的默认值，以快速创建角色和策略。

流程

1. 运行以下命令，使用默认的 CloudFormations 模板创建 AWS VPC：

   $ rosa create network

   Copy to Clipboard Toggle word wrap

2. 可选：通过指定附加参数来自定义 VPC。

   您可以使用- -param 标志指定对默认 VPC 模板的更改。以下示例命令为 region、Name、AvailabilityZoneCount 和 VpcCidr 指定自定义值。

   $ rosa create network --param Region=us-east-2 --param Name=quickstart-stack --param AvailabilityZoneCount=3 --param VpcCidr=10.0.0.0/16

   Copy to Clipboard Toggle word wrap

   该命令需要大约 5 分钟来运行，并在创建资源时从 AWS 提供常规状态更新。如果 CloudFormation 存在问题，则会尝试回滚。对于遇到的所有其他错误，请按照错误消息说明或联系 AWS 支持。

流程

1. 运行以下命令，打开 shell 提示符并克隆 Terraform VPC 存储库：

   $ git clone https://github.com/openshift-cs/terraform-vpc-example

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来进入创建的目录：

   $ cd terraform-vpc-example

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来启动 Terraform 文件：

   $ terraform init

   Copy to Clipboard Toggle word wrap

   在此过程完成后会显示确认初始化的消息。

4. 要根据现有的 Terraform 模板构建 VPC Terraform 计划，请运行 plan 命令。您必须包含 AWS 区域。您可以选择指定集群名称。在 terraform plan 完成后，一个 rosa.tfplan 文件会被添加到 hypershift-tf 目录。有关更详细的选项，请参阅 Terraform VPC 存储库的 README 文件。

   $ terraform plan -out rosa.tfplan -var region=<region>

   Copy to Clipboard Toggle word wrap

5. 运行以下命令应用此计划文件来构建 VPC：

   $ terraform apply rosa.tfplan

   Copy to Clipboard Toggle word wrap

   1. 可选：您可以通过运行以下命令捕获在创建 Red Hat OpenShift Service on AWS 集群时要使用的 Terraform-provisioned private、public 和 machinepool 子网 ID 的值：

      $ export SUBNET_IDS=$(terraform output -raw cluster-subnets-string)

      Copy to Clipboard Toggle word wrap

   2. 使用以下命令验证变量是否已正确设置：

      $ echo $SUBNET_IDS

      Copy to Clipboard Toggle word wrap

      输出示例

      $ subnet-0a6a57e0f784171aa,subnet-078e84e5b10ecf5b0

      Copy to Clipboard Toggle word wrap

流程

1. 要创建 OIDC 配置以及 AWS 资源，请运行以下命令：

   $ rosa create oidc-config --mode=auto --yes

   Copy to Clipboard Toggle word wrap

   此命令返回以下信息：

   输出示例

   ? Would you like to create a Managed (Red Hat hosted) OIDC Configuration Yes
   I: Setting up managed OIDC configuration
   I: To create Operator Roles for this OIDC Configuration, run the following command and remember to replace <user-defined> with a prefix of your choice:
   	rosa create operator-roles --prefix <user-defined> --oidc-config-id 13cdr6b
   If you are going to create a Hosted Control Plane cluster please include '--hosted-cp'
   I: Creating OIDC provider using 'arn:aws:iam::4540112244:user/userName'
   ? Create the OIDC provider? Yes
   I: Created OIDC provider with ARN 'arn:aws:iam::4540112244:oidc-provider/dvbwgdztaeq9o.cloudfront.net/13cdr6b'

   Copy to Clipboard Toggle word wrap

   在创建集群时，您必须提供 OIDC 配置 ID。CLI 输出为-- mode auto 提供了此值，否则您必须根据 aws CLI 输出用于- 模式手动 确定这些值。

2. 可选： 您可以将 OIDC 配置 ID 保存为稍后使用的变量。运行以下命令来保存变量：

   $ export OIDC_ID=<oidc_config_id>

   1

   Copy to Clipboard Toggle word wrap

   1

   在上面的示例输出中，OIDC 配置 ID 是 13cdr6b。

   • 运行以下命令，查看变量的值：

     $ echo $OIDC_ID

     Copy to Clipboard Toggle word wrap

     输出示例

     13cdr6b

     Copy to Clipboard Toggle word wrap

流程

1. 要创建 Operator 角色，请运行以下命令：

   $ rosa create operator-roles --hosted-cp --prefix=$OPERATOR_ROLES_PREFIX --oidc-config-id=$OIDC_ID --installer-role-arn arn:aws:iam::$AWS_ACCOUNT_ID:role/${ACCOUNT_ROLES_PREFIX}-HCP-ROSA-Installer-Role

   Copy to Clipboard Toggle word wrap

   以下分类提供了创建 Operator 角色的选项。

   $ rosa create operator-roles --hosted-cp
   	--prefix=$OPERATOR_ROLES_PREFIX 

   1

   
   	--oidc-config-id=$OIDC_ID 

   2

   
   	--installer-role-arn arn:aws:iam::$AWS_ACCOUNT_ID:role/$ACCOUNT_ROLES_PREFIX-HCP-ROSA-Installer-Role 

   3

   Copy to Clipboard Toggle word wrap

   1

   在创建这些 Operator 角色时，您必须提供一个前缀。如果不这样做，则会产生错误。如需有关 Operator 前缀的信息，请参阅本节的额外资源。

   2

   这个值是您为 Red Hat OpenShift Service on AWS 创建的 OIDC 配置 ID。

   3

   这个值是您在创建 Red Hat OpenShift Service on AWS 帐户角色时创建的安装程序角色 ARN。

   您必须包含 -hosted-cp 参数，以便为 Red Hat OpenShift Service on AWS 集群创建正确的角色。此命令返回以下信息：

   输出示例

   ? Role creation mode: auto
   ? Operator roles prefix: <pre-filled_prefix> 

   1

   
   ? OIDC Configuration ID: 23soa2bgvpek9kmes9s7os0a39i13qm4 | https://dvbwgdztaeq9o.cloudfront.net/23soa2bgvpek9kmes9s7os0a39i13qm4 

   2

   
   ? Create hosted control plane operator roles: Yes
   W: More than one Installer role found
   ? Installer role ARN: arn:aws:iam::4540112244:role/<prefix>-HCP-ROSA-Installer-Role
   ? Permissions boundary ARN (optional):
   I: Reusable OIDC Configuration detected. Validating trusted relationships to operator roles:
   I: Creating roles using 'arn:aws:iam::4540112244:user/<userName>'
   I: Created role '<prefix>-openshift-cluster-csi-drivers-ebs-cloud-credentials' with ARN 'arn:aws:iam::4540112244:role/<prefix>-openshift-cluster-csi-drivers-ebs-cloud-credentials'
   I: Created role '<prefix>-openshift-cloud-network-config-controller-cloud-credenti' with ARN 'arn:aws:iam::4540112244:role/<prefix>-openshift-cloud-network-config-controller-cloud-credenti'
   I: Created role '<prefix>-kube-system-kube-controller-manager' with ARN 'arn:aws:iam::4540112244:role/<prefix>-kube-system-kube-controller-manager'
   I: Created role '<prefix>-kube-system-capa-controller-manager' with ARN 'arn:aws:iam::4540112244:role/<prefix>-kube-system-capa-controller-manager'
   I: Created role '<prefix>-kube-system-control-plane-operator' with ARN 'arn:aws:iam::4540112244:role/<prefix>-kube-system-control-plane-operator'
   I: Created role '<prefix>-kube-system-kms-provider' with ARN 'arn:aws:iam::4540112244:role/<prefix>-kube-system-kms-provider'
   I: Created role '<prefix>-openshift-image-registry-installer-cloud-credentials' with ARN 'arn:aws:iam::4540112244:role/<prefix>-openshift-image-registry-installer-cloud-credentials'
   I: Created role '<prefix>-openshift-ingress-operator-cloud-credentials' with ARN 'arn:aws:iam::4540112244:role/<prefix>-openshift-ingress-operator-cloud-credentials'
   I: To create a cluster with these roles, run the following command:
   	rosa create cluster --sts --oidc-config-id 23soa2bgvpek9kmes9s7os0a39i13qm4 --operator-roles-prefix <prefix> --hosted-cp

   Copy to Clipboard Toggle word wrap

   1

   此字段会预先填充您在初始创建命令中设置的前缀。

   2

   此字段要求您选择为 Red Hat OpenShift Service on AWS 集群创建的 OIDC 配置。

   现在，Operator 角色已创建并可用于创建 Red Hat OpenShift Service on AWS 集群。

流程

1. 使用以下命令之一在 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 范围定义。

   • 如果您没有设置环境变量，请运行以下命令：

     $ rosa create cluster --cluster-name=<cluster_name> \ 

     1

     
         --mode=auto --hosted-cp [--private] \ 

     2

     
         --operator-roles-prefix <operator-role-prefix> \ 

     3

     
         --external-id <external-id> \ 

     4

     
         --oidc-config-id <id-of-oidc-configuration> \
         --subnet-ids=<public-subnet-id>,<private-subnet-id>

     Copy to Clipboard Toggle word wrap

     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

     Copy to Clipboard Toggle word wrap

   • 如果设置环境变量，请运行以下命令创建带有单个初始机器池、公开可用的 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

     Copy to Clipboard Toggle word wrap

2. 运行以下命令检查集群的状态：

   $ rosa describe cluster --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   在集群安装过程中，输出中会列出以下 State 字段更改：

   • 待定（准备帐户）
   • 安装（进行中的DNS 设置）
   • installing

   • ready

     注意

     如果安装失败，或者 State 字段在超过 10 分钟后没有变为 ready，请检查安装故障排除文档以了解详细信息。如需更多信息，请参阅 故障排除安装。有关联系红帽支持以获取帮助的步骤，请参阅 获取对 Red Hat OpenShift Service on AWS 的支持。

3. 通过观察 Red Hat OpenShift Service on AWS 安装程序日志来跟踪集群创建的进度。要检查日志，请运行以下命令：

   $ rosa logs install --cluster=<cluster_name> --watch \ 

   1

   Copy to Clipboard Toggle word wrap

   1

   可选： 要在安装过程中监视新日志消息，请使用-- watch 参数。

流程

1. 进入 github.com 并登录到您的 GitHub 帐户。
2. 邀请需要访问您的 GitHub 机构 Red Hat OpenShift Service on AWS 集群的用户。按照 GitHub 文档中的邀请用户加入到您的机构 。

流程

1. 获取集群的控制台 URL：

   $ rosa describe cluster -c <cluster_name> | grep Console 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <cluster_name> 替换为集群的名称。

   输出示例

   Console URL:                https://console-openshift-console.apps.example-cluster.wxyz.p1.openshiftapps.com

   Copy to Clipboard Toggle word wrap

2. 进入上一步输出中的控制台 URL 并登录。

   • 如果创建了 cluster-admin 用户，请使用提供的凭证登录。
   • 如果您为集群配置了身份提供程序，请在 Log in with…​ 对话框中选择身份提供程序名称，并完成您的供应商出示的任何授权请求。

流程

1. 进入 OpenShift Cluster Manager 中的 Cluster List 页面。
2. 点您要查看的集群旁的选项图标 (HBAC)。
3. 点 Open console。
4. 集群控制台将在新的浏览器窗口中打开。使用您配置的身份提供程序凭证登录到您的红帽帐户。
5. 在 Administrator 视角中，选择 Home → Projects → Create Project。
6. 输入项目的名称，并选择性地添加 Display Name 和 Description。
7. 点 Create 以创建该项目。
8. 切换到 Developer 视角并选择 +Add。验证所选项目是您刚才创建的项目。
9. 在 Developer Catalog 对话框中，选择 All services。
10. 在 Developer Catalog 页面中，从菜单中选择 Languages → JavaScript。

11. 点 Node.js，然后点 Create 以打开 Create Source-to-Image 应用程序 页面。

    注意

    您可能需要点 Clear All Filters 以显示 Node.js 选项。

12. 在 Git 部分中，点 Try sample。
13. 在 Name 字段中添加一个唯一名称。该值将用于命名关联的资源。
14. 确认选择了 Deployment 和 Create a route。
15. 点 Create 以部署应用。部署 pod 需要几分钟时间。
16. 可选：选择 Node.js 应用程序并查看其边栏来检查 Topology 窗格中的 pod 状态。您必须等待 nodejs 构建完成，并且 nodejs Pod 处于 Running 状态，然后继续。

17. 部署完成后，点应用程序的路由 URL，其格式类似如下：

    https://nodejs-<project>.<cluster_name>.<hash>.<region>.openshiftapps.com/

    Copy to Clipboard Toggle word wrap

    浏览器中打开一个新标签页，其中包含类似如下的信息：

    Welcome to your Node.js application on OpenShift

    Copy to Clipboard Toggle word wrap

18. 可选：删除应用程序并清理您创建的资源：

    1. 在 Administrator 视角中，进入 Home → Projects。
    2. 点项目的操作菜单，再选择 Delete Project。

流程

1. 进入 github.com 并登录到您的 GitHub 帐户。
2. 从 GitHub 组织中删除该用户。按照 GitHub 文档中的从您的机构中删除成员的步骤进行操作。

流程

1. 删除集群并观察日志，将 <cluster_name> 替换为集群的名称或 ID:

   $ rosa delete cluster --cluster=<cluster_name> --watch

   Copy to Clipboard Toggle word wrap
   重要

   在删除 IAM 角色、策略和 OIDC 供应商前，您必须等待集群删除完成。需要集群范围的角色来删除安装程序创建的资源。需要特定于集群的 Operator 角色来清理 OpenShift Operator 创建的资源。Operator 使用 OIDC 供应商与 AWS API 进行身份验证。

2. 删除集群后，删除集群 Operator 用于身份验证的 OIDC 供应商：

   $ rosa delete oidc-provider -c <cluster_id> --mode auto 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <cluster_id> 替换为集群的 ID。

   注意

   您可以使用 -y 选项，在提示符处自动回答 yes。

3. 删除特定于集群的 Operator IAM 角色：

   $ rosa delete operator-roles -c <cluster_id> --mode auto 

   1

   Copy to Clipboard Toggle word wrap

   1

   将 <cluster_id> 替换为集群的 ID。

4. 删除集群范围的角色：

   重要

   帐户范围的 IAM 角色和策略可能被同一 AWS 帐户中的其他 Red Hat OpenShift Service on AWS 使用。只有其他集群不需要的资源，才必须删除这些资源。

   $ rosa delete account-roles --prefix <prefix> --mode auto 

   1

   Copy to Clipboard Toggle word wrap

   1

   您必须包含 --<prefix> 参数。将 <prefix> 替换为要删除的集群范围角色前缀。如果您在创建集群范围的角色时没有指定自定义前缀，请指定默认前缀，具体取决于它们创建的方式，即 HCP-ROSA 或 ManagedOpenShift。

5. 删除您为 Red Hat OpenShift Service on AWS 部署创建的账户范围和 Operator IAM 策略：

   1. 登录到 AWS IAM 控制台。
   2. 进入到 Access management → Policies，再选中其中一个帐户范围策略的复选框。
   3. 选择策略后，点 Actions → Delete 以打开删除策略对话框。
   4. 输入策略名称以确认删除，然后选择 Delete 以删除策略。
   5. 重复此步骤，从集群中删除每个集群范围的 Operator 策略。

流程

1. 使用以下命令之一在 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 范围定义。

   • 如果您没有设置环境变量，请运行以下命令：

     $ rosa create cluster --cluster-name=<cluster_name> \ 

     1

     
         --mode=auto --hosted-cp [--private] \ 

     2

     
         --operator-roles-prefix <operator-role-prefix> \ 

     3

     
         --external-id <external-id> \ 

     4

     
         --oidc-config-id <id-of-oidc-configuration> \
         --subnet-ids=<public-subnet-id>,<private-subnet-id>

     Copy to Clipboard Toggle word wrap

     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

     Copy to Clipboard Toggle word wrap

   • 如果设置环境变量，请运行以下命令创建带有单个初始机器池、公开可用的 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

     Copy to Clipboard Toggle word wrap

2. 运行以下命令检查集群的状态：

   $ rosa describe cluster --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   在集群安装过程中，输出中会列出以下 State 字段更改：

   • 待定（准备帐户）
   • 安装（进行中的DNS 设置）
   • installing

   • ready

     注意

     如果安装失败，或者 State 字段在超过 10 分钟后没有变为 ready，请检查安装故障排除文档以了解详细信息。如需更多信息，请参阅 故障排除安装。有关联系红帽支持以获取帮助的步骤，请参阅 获取对 Red Hat OpenShift Service on AWS 的支持。

3. 通过观察 Red Hat OpenShift Service on AWS 安装程序日志来跟踪集群创建的进度。要检查日志，请运行以下命令：

   $ rosa logs install --cluster=<cluster_name> --watch \ 

   1

   Copy to Clipboard Toggle word wrap

   1

   可选： 要在安装过程中监视新日志消息，请使用-- watch 参数。

流程

1. 运行以下命令，使用默认的 CloudFormations 模板创建 AWS VPC：

   $ rosa create network

   Copy to Clipboard Toggle word wrap

2. 可选：通过指定附加参数来自定义 VPC。

   您可以使用- -param 标志指定对默认 VPC 模板的更改。以下示例命令为 region、Name、AvailabilityZoneCount 和 VpcCidr 指定自定义值。

   $ rosa create network --param Region=us-east-2 --param Name=quickstart-stack --param AvailabilityZoneCount=3 --param VpcCidr=10.0.0.0/16

   Copy to Clipboard Toggle word wrap

   该命令需要大约 5 分钟来运行，并在创建资源时从 AWS 提供常规状态更新。如果 CloudFormation 存在问题，则会尝试回滚。对于遇到的所有其他错误，请按照错误消息说明或联系 AWS 支持。

流程

1. 运行以下命令，打开 shell 提示符并克隆 Terraform VPC 存储库：

   $ git clone https://github.com/openshift-cs/terraform-vpc-example

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来进入创建的目录：

   $ cd terraform-vpc-example

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来启动 Terraform 文件：

   $ terraform init

   Copy to Clipboard Toggle word wrap

   在此过程完成后会显示确认初始化的消息。

4. 要根据现有的 Terraform 模板构建 VPC Terraform 计划，请运行 plan 命令。您必须包含 AWS 区域。您可以选择指定集群名称。在 terraform plan 完成后，一个 rosa.tfplan 文件会被添加到 hypershift-tf 目录。有关更详细的选项，请参阅 Terraform VPC 存储库的 README 文件。

   $ terraform plan -out rosa.tfplan -var region=<region>

   Copy to Clipboard Toggle word wrap

5. 运行以下命令应用此计划文件来构建 VPC：

   $ terraform apply rosa.tfplan

   Copy to Clipboard Toggle word wrap

   1. 可选：您可以通过运行以下命令捕获在创建 Red Hat OpenShift Service on AWS 集群时要使用的 Terraform-provisioned private、public 和 machinepool 子网 ID 的值：

      $ export SUBNET_IDS=$(terraform output -raw cluster-subnets-string)

      Copy to Clipboard Toggle word wrap

   2. 使用以下命令验证变量是否已正确设置：

      $ echo $SUBNET_IDS

      Copy to Clipboard Toggle word wrap

      输出示例

      $ subnet-0a6a57e0f784171aa,subnet-078e84e5b10ecf5b0

      Copy to Clipboard Toggle word wrap