第 7 章 ROSA CLI

流程

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

      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

2. 从 OpenShift Cluster Manager 上的 Downloads 页面下载您的操作系统的 ROSA CLI (rosa)的最新版本。

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.15
   Your ROSA CLI is up to date.

   Copy to Clipboard Toggle word wrap

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

   • 在 Linux 主机上为 Bash 启用持久性 tab 自动完成功能：

     1. 为 Bash 生成 rosa tab 自动完成配置文件，并将其保存到 /etc/bash_completion.d/ 目录中：

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

        Copy to Clipboard Toggle word wrap
     2. 打开一个新的终端来激活配置。

   • 在 macOS 主机上为 Bash 启用持久性 tab 自动完成功能：

     1. 为 Bash 生成 rosa tab 自动完成配置文件，并将其保存到 /usr/local/etc/bash_completion.d/ 目录中：

        $ rosa completion bash > /usr/local/etc/bash_completion.d/rosa

        Copy to Clipboard Toggle word wrap
     2. 打开一个新的终端来激活配置。

   • 为 Zsh 启用持久性标签页自动完成功能：

     1. 如果没有为您的 Zsh 环境启用 tab 自动完成功能，请运行以下命令启用它：

        $ echo "autoload -U compinit; compinit" >> ~/.zshrc

        Copy to Clipboard Toggle word wrap

     2. 为 Zsh 生成 rosa tab 自动完成配置文件，并将其保存到功能路径中的第一个目录中：

        $ rosa completion zsh > "${fpath[1]}/_rosa"

        Copy to Clipboard Toggle word wrap
     3. 打开一个新的终端来激活配置。

   • 为 fish 启用持久的 tab 自动完成功能：

     1. 为 fish 生成 rosa tab 自动完成配置文件，并将其保存到 ~/.config/fish/completions/ 目录中：

        $ rosa completion fish > ~/.config/fish/completions/rosa.fish

        Copy to Clipboard Toggle word wrap
     2. 打开一个新的终端来激活配置。

   • 为 PowerShell 启用持久性标签页自动完成功能：

     1. 为 PowerShell 生成 rosa tab 自动完成配置文件，并将它保存到名为 rosa.ps1 的文件中：

        PS> rosa completion powershell | Out-String | Invoke-Expression

        Copy to Clipboard Toggle word wrap
     2. Source 来自您的 PowerShell 配置集中的 rosa.ps1 文件。
   注意

   有关配置 rosa tab 自动完成的更多信息，请参阅 帮助菜单，运行 rosa completion --help 命令。

流程

1. 确认新版本的 ROSA CLI (rosa)可用：

   $ rosa version

   Copy to Clipboard Toggle word wrap

   输出示例

   1.2.12
   There is a newer release version '1.2.15', please consider updating: https://mirror.openshift.com/pub/openshift-v4/clients/rosa/latest/

   Copy to Clipboard Toggle word wrap

2. 下载 ROSA CLI 的最新兼容版本：

   $ rosa download rosa

   Copy to Clipboard Toggle word wrap

   此命令将名为 rosa114.tar.gz 的存档下载到当前目录中。文件的确切名称取决于您的操作系统和系统架构。

3. 提取存档内容：

   $ tar -xzf rosa-linux.tar.gz

   Copy to Clipboard Toggle word wrap

4. 通过将提取的文件移至您的路径中来安装 ROSA CLI 的新版本。在以下示例中，/usr/local/bin 目录包含在用户的路径中：

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

   Copy to Clipboard Toggle word wrap