第 5 章 设置环境

流程

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