Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

2.3. 配置访问

RHACS 提供 roxctl 命令行界面(CLI)，以便更轻松地将 RHACS 策略集成到构建管道中。roxctl CLI 会打印有关问题的详细信息以及如何修复它们，以便开发人员可以在容器生命周期的早期阶段保持高标准。

要安全地向 Red Hat Advanced Cluster Security for Kubernetes API 服务器进行身份验证，您必须创建一个 API 令牌。

2.3.1. 导出并保存 API 令牌
复制链接

流程

  1. 生成身份验证令牌后，输入以下命令将其导出为 ROX_API_TOKEN 变量： 

    $ export ROX_API_TOKEN=<api_token>
    Copy to Clipboard Toggle word wrap

  2. （可选）：您还可以将令牌保存到文件中，并通过输入以下命令将其与 --token-file 选项一起使用： 

    $ roxctl central debug dump --token-file <token_file>
    Copy to Clipboard Toggle word wrap

请注意以下信息：

  • 您不能同时使用 -password (-p) 和 --token-file 选项。
  • 如果您已经设置了 ROX_API_TOKEN 变量，并指定 --token-file 选项，roxctl CLI 会使用指定的令牌文件进行身份验证。
  • 如果您已经设置了 ROX_API_TOKEN 变量，并指定 --password 选项，roxctl CLI 将使用指定的密码进行身份验证。

2.3.2. 通过下载二进制文件安装 roxctl CLI
复制链接

您可以安装 roxctl CLI，以使用命令行界面与 Red Hat Advanced Cluster Security for Kubernetes 进行交互。您可以在 Linux、Windows 或 macOS 上安装 roxctl。

2.3.2.1. 在 Linux 中安装 roxctl CLI
复制链接

您可以按照以下流程在 Linux 上安装 roxctl CLI 二进制文件。

注意

用于 Linux 的 roxctl CLI 可用于 amd 64、rm64、 ppc64le 和 s390x 架构。

流程

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

    $ arch="$(uname -m | sed "s/x86_64//")"; arch="${arch:+-$arch}"
    Copy to Clipboard Toggle word wrap

  2. 下载 roxctl CLI： 

    $ curl -L -f -o roxctl "https://mirror.openshift.com/pub/rhacs/assets/4.7.7/bin/Linux/roxctl${arch}"
    Copy to Clipboard Toggle word wrap

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

    $ chmod +x roxctl
    Copy to Clipboard Toggle word wrap

  4. 将 roxctl 二进制文件放到 PATH 中的目录中：

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

    $ echo $PATH
    Copy to Clipboard Toggle word wrap

验证

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

    $ roxctl version
    Copy to Clipboard Toggle word wrap

2.3.2.2. 在 macOS 上安装 roxctl CLI
复制链接

您可以按照以下流程在 macOS 中安装 roxctl CLI 二进制文件。

注意

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

流程

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

    $ arch="$(uname -m | sed "s/x86_64//")"; arch="${arch:+-$arch}"
    Copy to Clipboard Toggle word wrap

  2. 下载 roxctl CLI： 

    $ curl -L -f -o roxctl "https://mirror.openshift.com/pub/rhacs/assets/4.7.7/bin/Darwin/roxctl${arch}"
    Copy to Clipboard Toggle word wrap

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

    $ xattr -c roxctl
    Copy to Clipboard Toggle word wrap

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

    $ chmod +x roxctl
    Copy to Clipboard Toggle word wrap

  5. 将 roxctl 二进制文件放到 PATH 中的目录中：

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

    $ echo $PATH
    Copy to Clipboard Toggle word wrap

验证

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

    $ roxctl version
    Copy to Clipboard Toggle word wrap

2.3.2.3. 在 Windows 上安装 roxctl CLI
复制链接

您可以按照以下流程在 Windows 上安装 roxctl CLI 二进制文件。

注意

用于 Windows 的 roxctl CLI 可用于 amd64 架构。

流程

  • 下载 roxctl CLI： 

    $ curl -f -O https://mirror.openshift.com/pub/rhacs/assets/4.7.7/bin/Windows/roxctl.exe
    Copy to Clipboard Toggle word wrap

验证

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

    $ roxctl version
    Copy to Clipboard Toggle word wrap

2.3.3. 从容器运行 roxctl CLI
复制链接

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

先决条件

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

流程

  1. 登录到 registry.redhat.io registry。 

    $ docker login registry.redhat.io
    Copy to Clipboard Toggle word wrap

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

    $ docker pull registry.redhat.io/advanced-cluster-security/rhacs-roxctl-rhel8:4.7.7
    Copy to Clipboard Toggle word wrap

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

$ docker run -e ROX_API_TOKEN=$ROX_API_TOKEN \
  -it registry.redhat.io/advanced-cluster-security/rhacs-roxctl-rhel8:4.7.7 \
  -e $ROX_CENTRAL_ADDRESS <command>
Copy to Clipboard Toggle word wrap
注意

在 Red Hat Advanced Cluster Security Cloud Service (RHACS Cloud Service)中，在使用需要 Central 地址的 roxctl 命令时，使用 Red Hat Hybrid Cloud Console 的 Instance Details 部分所示的 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.7.7 version
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat