2.2. 设置环境

流程

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

3. 单击 Get started。

   验证 ROSA 先决条件 页面将打开。

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

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

   1. 选中 I agree to share my contact information to Red Hat 旁边的复选框。

   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 CLI (aws)。

   1. 按照 AWS 命令行界面文档为您的操作系统安装和配置 AWS CLI。

      在 .aws/credentials 文件中指定 aws_access_key_id、aws_secret_access_key 和 region。请参阅 AWS 文档中的 AWS 配置基础知识。

      注意

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

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

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

      输出示例

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

2. 安装和配置最新的 ROSA CLI (rosa)。

   1. 从 Red Hat OpenShift Cluster Manager Hybrid Cloud Console 上的 Downloads 页面下载您的操作系统的 ROSA CLI 的最新版本。

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

      $ tar xvf rosa-linux.tar.gz

   3. 在您的路径中添加 rosa。在以下示例中，/usr/local/bin 目录包含在用户的路径中：

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

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

      $ rosa version

      输出示例

      1.2.15
      Your ROSA CLI is up to date.

   5. 可选：为 ROSA CLI 启用 tab 自动完成功能。启用 tab 自动完成功能后，您可以按 Tab 键两次来自动完成子命令并接收命令建议。

      ROSA Tab 补全可用于不同的 shell 类型。以下示例在 Linux 主机上为 Bash 启用永久性 tab 自动完成功能。该命令为 Bash 生成 rosa 选项卡的完成配置文件，并将其保存到 /etc/bash_completion.d/ 目录中：

      # rosa completion bash > /etc/bash_completion.d/rosa

      您必须打开一个新终端，才能激活配置。

      注意

      有关为不同 shell 类型配置 rosa 选项卡完成的步骤，请参阅运行 rosa completion --help 的帮助菜单。

   6. 使用 ROSA CLI 登录您的红帽帐户：

      $ rosa login

      输出示例

      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:

      进入命令输出中列出的 URL，以获取离线访问令牌。在 CLI 提示符后指定令牌以进行登录。

      注意

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

   7. 验证您是否已成功登录，并检查您的凭证：

      $ rosa whoami

      输出示例

      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>

      在继续进行前，检查输出中的信息是否正确。

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

   1. 使用 ROSA CLI 下载 oc CLI 的最新版本：

      $ rosa download openshift-client

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

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

   3. 在您的路径中添加 oc 二进制文件。在以下示例中，/usr/local/bin 目录包含在用户的路径中：

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

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

      $ rosa verify openshift-client

      输出示例

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