16.2. 创建声明性配置


使用 roxctl 创建存储配置的 YAML 文件,从文件中创建配置映射并应用配置映射。

前提条件

  • 您已在安装 Central 过程中为配置映射或 secret 添加了挂载。在本例中,配置映射名为 "declarative-configs"。如需更多信息,请参阅"附加资源"部分中列出的安装文档。

流程

  1. 运行以下命令来创建权限集。本例创建一个名为 "restricted" 的权限集,并保存为 permission-set.yaml 文件。它为 Administration 资源设置读写访问权限,以及对 Access 资源的读访问权限。

    $ roxctl declarative-config create permission-set \
    --name="restricted" \
    --description="Restriction permission set that only allows \
    access to Administration and Access resources" \
    --resource-with-access=Administration=READ_WRITE_ACCESS \
    --resource-with-access=Access=READ_ACCESS > permission-set.yaml
    Copy to Clipboard Toggle word wrap
  2. 输入以下命令,创建允许访问 AdministrationAccess 资源的角色。本例创建一个名为 "restricted" 的角色,并保存为 role.yaml 文件。

    $ roxctl declarative-config create role \
    --name="restricted" \
    --description="Restricted role that only allows access to Administration and Access" \
    --permission-set="restricted" \
    --access-scope="Unrestricted" > role.yaml
    Copy to Clipboard Toggle word wrap
  3. 输入以下命令,从上一步中创建的两个 YAML 文件创建配置映射。这个示例创建 declarative-configurations 配置映射。

    $ kubectl create configmap declarative-configurations \ 
    1
    
    --from-file permission-set.yaml --from-file role.yaml \
    -o yaml --namespace=stackrox > declarative-configs.yaml
    Copy to Clipboard Toggle word wrap
    1
    对于 OpenShift Container Platform,使用 oc create
  4. 输入以下命令应用配置映射:

    $ kubectl apply -f declarative-configs.yaml 
    1
    Copy to Clipboard Toggle word wrap
    1
    对于 OpenShift Container Platform,请使用 oc apply

    应用配置映射后,从 Central 中提取的配置信息会创建资源。

    注意

    虽然监视间隔为 5 秒,如以下段落中所述,但可将配置映射的更改传播到 Central 挂载时可能会有延迟。

    您可以配置以下间隔来指定声明性配置如何与 Central 交互:

    • 配置监视间隔: Central 检查更改的时间间隔每 5 秒进行一次。您可以使用 ROX_DECLARATIVE_CONFIG_WATCH_INTERVAL 环境变量配置此间隔。
    • 协调间隔: 默认情况下,声明性配置与 Central 协调每 20 秒进行。您可以使用 ROX_DECLARATIVE_CONFIG_RECONCILE_INTERVAL 环境变量配置此间隔。

使用声明性配置创建身份验证和授权资源后,您可以在 RHACS web 门户的 Access Control 页面中查看它们。Origin 字段指示 资源 是使用声明性配置创建的 Declarative。

注意

您不能编辑从 RHACS web 门户中声明配置创建的资源。您必须直接编辑配置文件,以更改这些资源。

您可以通过进入到 Platform Configuration System Health 并滚动到 Declarative 配置部分 来查看声明配置的状态。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat