OpenShift 文档正在迁移，很快将只在 docs.redhat.com（所有 Red Hat 产品文档的所在地）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

安装 roxctl 命令行界面

roxctl 是一个命令行界面 (CLI)，用于在 Red Hat Advanced Cluster Security for Kubernetes (RHACS) 上运行命令。您可以通过下载二进制文件来安装 roxctl CLI，也可以从容器镜像运行 roxctl CLI。

通过下载二进制文件安装 roxctl CLI

您可以安装 roxctl CLI 以通过命令行界面与 RHACS 交互。您可以在 Linux、Windows 或 macOS 上安装 roxctl。

在 Linux 上安装 roxctl CLI

您可以使用以下步骤在 Linux 上安装 roxctl CLI 二进制文件。

适用于 Linux 的 roxctl CLI 可用于 amd64、arm64、ppc64le 和 s390x 架构。
步骤

  1. 确定目标操作系统的 roxctl 架构

    $ arch="$(uname -m | sed "s/x86_64//")"; arch="${arch:+-$arch}"

  2. 下载 roxctl CLI

    $ curl -L -f -o roxctl "https://mirror.openshift.com/pub/rhacs/assets/4.6.1/bin/Linux/roxctl${arch}"

  3. 使 roxctl 二进制文件可执行

    $ chmod +x roxctl

  4. 将 roxctl 二进制文件放置在您的 PATH 中的目录下

    要检查您的 PATH，请执行以下命令

    $ echo $PATH
验证

  • 验证您已安装的 roxctl 版本

    $ roxctl version

在 macOS 上安装 roxctl CLI

您可以使用以下步骤在 macOS 上安装 roxctl CLI 二进制文件。

适用于 macOS 的 roxctl CLI 可用于 amd64 和 arm64 架构。
步骤

  1. 确定目标操作系统的 roxctl 架构

    $ arch="$(uname -m | sed "s/x86_64//")"; arch="${arch:+-$arch}"

  2. 下载 roxctl CLI

    $ curl -L -f -o roxctl "https://mirror.openshift.com/pub/rhacs/assets/4.6.1/bin/Darwin/roxctl${arch}"

  3. 删除二进制文件中的所有扩展属性

    $ xattr -c roxctl

  4. 使 roxctl 二进制文件可执行

    $ chmod +x roxctl

  5. 将 roxctl 二进制文件放置在您的 PATH 中的目录下

    要检查您的 PATH，请执行以下命令

    $ echo $PATH
验证

  • 验证您已安装的 roxctl 版本

    $ roxctl version

在 Windows 上安装 roxctl CLI

您可以使用以下步骤在 Windows 上安装 roxctl CLI 二进制文件。

适用于 Windows 的 roxctl CLI 可用于 amd64 架构。
步骤

  • 下载 roxctl CLI

    $ curl -f -O https://mirror.openshift.com/pub/rhacs/assets/4.6.1/bin/Windows/roxctl.exe
验证

  • 验证您已安装的 roxctl 版本

    $ roxctl version

从容器运行 roxctl CLI

roxctl 客户端是 RHACS roxctl 镜像中的默认入口点。要在容器镜像中运行 roxctl 客户端

先决条件

  • 您必须首先从 RHACS 门户生成身份验证令牌。

步骤

  1. 登录到 registry.redhat.io 注册表。

    $ docker login registry.redhat.io

  2. 拉取 roxctl CLI 的最新容器镜像。

    $ docker pull registry.redhat.io/advanced-cluster-security/rhacs-roxctl-rhel8:4.6.1

安装 CLI 后，您可以使用以下命令运行它

$ docker run -e ROX_API_TOKEN=$ROX_API_TOKEN \
  -it registry.redhat.io/advanced-cluster-security/rhacs-roxctl-rhel8:4.6.1 \
  -e $ROX_CENTRAL_ADDRESS <command>

在 Red Hat Advanced Cluster Security Cloud Service (RHACS 云服务) 中，当使用需要 Central 地址的 roxctl 命令时，请使用 Red Hat Hybrid Cloud Console 的“实例详细信息”部分中显示的**Central 实例地址**。例如，使用 acs-ABCD12345.acs.rhcloud.com 而不是 acs-data-ABCD12345.acs.rhcloud.com。
验证

  • 验证您已安装的 roxctl 版本。

    $ docker run -it registry.redhat.io/advanced-cluster-security/rhacs-roxctl-rhel8:4.6.1 version