第 8 章 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

      输出示例

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

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

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 自动完成功能后，您可以按 Tab 键两次来自动完成子命令并接收命令建议：

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

     1. 为 Bash 生成 rosa 选项卡补全配置文件，并将它保存到 /etc/bash_completion.d/ 目录中：

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

     2. 打开新终端以激活配置。

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

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

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

     2. 打开新终端以激活配置。

   • 为 Zsh 启用持久性 tab 自动完成功能：

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

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

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

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

     3. 打开新终端以激活配置。

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

     1. 为 fish 生成 rosa 选项卡补全配置文件，并将它保存到 ~/.config/fish/completions/ 目录中：

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

     2. 打开新终端以激活配置。

   • 为 PowerShell 启用持久性 tab 自动完成功能：

     1. 为 PowerShell 生成 rosa 选项卡补全配置文件，并将它保存到名为 rosa.ps1 的文件中：

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

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

   有关配置 rosa tab 自动完成功能的更多信息，请通过运行 rosa completion --help 命令来查看帮助菜单。

流程

1. 使用来自红帽的 Red Hat OpenShift Cluster Manager 离线令牌初始化 rosa ： https://console.redhat.com/openshift/token/rosa

   $ rosa init --token=<token>

2. 创建 ROSA 集群：

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

3. 添加身份提供程序 (IDP)：

   $ rosa create idp --cluster=<cluster_name> --type=<identity_provider> [arguments]

4. 添加 dedicated-admin 用户：

   $ rosa grant user dedicated-admin --user=<idp_user_name> --cluster=<cluster_name>

流程

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