第 7 章 ROSA CLI

流程

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

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

      将 aws_access_key_id、aws_secret_access_key 和 region 放置在 .aws/credentials 文件中。请参阅 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. 从 OpenShift Cluster Manager 上的 Downloads 页面下载您的操作系统的ROSA 命令行界面(CLI)的最新版本。

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

   $ tar xvf rosa-linux.tar.gz

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

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

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

   $ rosa version

   输出示例

   1.2.15
   Your ROSA CLI is up to date.

6. 可选：为 ROSA CLI 打开 tab 自动完成功能。按 Tab 键两次来完成子命令或查看提示：

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

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

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

     2. 打开一个新的终端来激活配置。

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

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

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

     2. 打开一个新的终端来激活配置。

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

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

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

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

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

     3. 打开一个新的终端来激活配置。

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

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

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

     2. 打开一个新的终端来激活配置。

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

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

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

     2. Source 来自您的 PowerShell 配置集中的 rosa.ps1 文件。
   注意

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

流程

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

   $ rosa version

   输出示例

   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/

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

   $ rosa download rosa

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

3. 提取存档内容：

   $ tar -xzf rosa-linux.tar.gz

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

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