16.2. 创建声明配置


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

前提条件

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

流程

  1. 输入以下命令来创建权限集。本例创建一个名为"restricted"的权限集,并保存为 permission-set.yaml 文件。它为管理资源设置读写访问权限,以及对 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 环境变量来配置此间隔。
    • 协调间隔:默认情况下,每 20 秒发生使用 Central 的声明配置协调。您可以使用 ROX_DECLARATIVE_CONFIG_RECONCILE_INTERVAL 环境变量来配置此间隔。

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

注意

您无法编辑 RHACS web 门户中声明配置创建的资源。您必须直接编辑配置文件来更改这些资源。

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

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat