SuperAPI AI 工具集

ucs-policy-governor

部署与运维

查看项目

更新于 10-16 09:56

技能介绍

用途:为华为云 UCS(Universal Cloud Service)提供策略治理与合规管理能力,覆盖策略实例生命周期、策略定义查询、策略执行(启用/禁用)及合规审计。架构为 hcloud CLI → UCS Service API → PolicyInstance/PolicyDefinition/PolicyJob 资源。

主要能力:

  1. 策略实例管理:为集群或集群组创建策略实例(CreateClusterPolicyInstance/CreateClusterGroupPolicyInstance),并支持更新(UpdatePolicyInstance)、查询(ShowPolicyInstance)、删除(DeletePolicyInstance)、列表(ListPolicyInstances,无过滤参数)。
  2. 策略定义管理:列出(ListPolicyDefinitions)和查询(ShowPolicyDefinition)可用策略定义/模板。
  3. 策略执行:在集群或集群组上启用/禁用策略(EnableClusterPolicy、DisableClusterPolicy、EnableClusterGroupPolicy、DisableClusterGroupPolicy),启用支持 --retry 重试。
  4. 作业状态:通过 ListPolicyJobs/ShowPolicyJob 查看策略执行作业状态与合规结果。

必要用法:需安装 hcloud CLI(>=7.2.2),首次运行 printf "y\n" | hcloud version 接受隐私声明。凭据使用环境变量 HUAWEI_CLOUD_AK、HUAWEI_CLOUD_SK、HUAWEI_CLOUD_REGION,禁止在代码或命令中暴露 AK/SK,禁止用 echo 打印。示例:hcloud UCS CreateClusterPolicyInstance --clusterid=<ucs-cluster-id> --constraintTemplateID=<template-id> --enforcementAction=deny --namespaces.1=default --parameters='{"maxReplicas":"3"}' --cli-region=cn-north-4。参数名用 camelCase(如 --policyinstanceid、--clusterid),不使用下划线。ListPolicyInstances/ListPolicyDefinitions 无过滤参数,仅 --cli-region。GetPolicyAssignment 不存在,用 ListPolicyJobs/ShowPolicyJob 代替。

适用场景:为生产集群创建安全或合规策略、为集群组统一下发策略、临时禁用策略维护、审计全集群策略执行情况、更新或删除过期策略实例、应用前查询策略定义详情。集群级操作需 --clusterid,集群组级需 --clustergroupid。

限制:策略删除不可逆;禁用策略会暂停违规检查;集群组策略作用于所有成员集群,应用前需确认成员;仅支持 hcloud CLI 方式;需相应 IAM 权限(如 ucs:clusterPolicyInstance:create、ucs:policyInstance:list、ucs:policyJob:list 等),权限失败时需参考 IAM 策略文档申请授权。策略实例与作业的返回结构部分标注“待验证”,实际字段格式以 UCS 返回为准。