如何用yq对Kubernetes NetworkPolicy按端口、IP块排序以对比文件

针对你需要对NetworkPolicy的egress规则做特定排序的需求，推荐两种优雅的结构化处理方案，避免转properties文件的繁琐：

方案一：Python脚本（保留注释与原格式） #

适合需要保留YAML原注释、特殊格式的场景，使用ruamel.yaml库处理（比原生PyYAML更适配K8s YAML格式）。

步骤： #

1. 安装依赖：

pip install ruamel.yaml

2. 编写排序脚本（示例命名为sort-np.py）：

from ruamel.yaml import YAML

# 初始化YAML处理器，保留原文件的引号、注释格式
yaml = YAML()
yaml.preserve_quotes = True

# 读取原始NetworkPolicy文件
with open('network-policy.yaml', 'r') as f:
    np_data = yaml.load(f)

# 遍历每个egress规则进行排序
for egress in np_data.get('spec', {}).get('egress', []):
    # 排序ports：先按port（统一处理数字/字符串类型），再按protocol
    if 'ports' in egress:
        def port_sort_key(item):
            # 将port转为整数（兼容字符串格式的端口号），非数字端口保持原格式
            port_val = int(item['port']) if isinstance(item['port'], str) and item['port'].isdigit() else item['port']
            # 按protocol大写排序，避免大小写不一致导致的排序混乱
            return (port_val, item.get('protocol', '').upper())
        egress['ports'].sort(key=port_sort_key)
    
    # 排序to中的ipBlock：按cidr字符串排序，非ipBlock项后置
    if 'to' in egress:
        def to_sort_key(item):
            if 'ipBlock' in item:
                # ipBlock项按cidr排序，优先前置
                return (0, item['ipBlock']['cidr'])
            else:
                # 非ipBlock项（如podSelector）后置，按结构字符串排序保证一致性
                return (1, str(item))
        egress['to'].sort(key=to_sort_key)

# 写入排序后的文件
with open('sorted-network-policy.yaml', 'w') as f:
    yaml.dump(np_data, f)

3. 执行脚本：

python sort-np.py

方案二：jq命令行工具（快速无注释处理） #

适合不需要保留注释、追求快速操作的场景，利用jq的JSON处理能力（注意：YAML转JSON过程会丢失注释）。

执行命令：

jq '.spec.egress |= map(
  # 排序ports：先转port为数字（兼容字符串），再按protocol排序
  .ports |= if . then sort_by(.port | (tonumber? // .), .protocol) else . end |
  # 排序to：ipBlock按cidr排序，非ipBlock项后置
  .to |= if . then sort_by(if .ipBlock then 0 else 1 end, if .ipBlock then .ipBlock.cidr else "" end) else . end
)' network-policy.yaml > sorted-network-policy.yaml

方案对比 #

• Python脚本：支持保留注释、复杂格式处理，可灵活调整排序逻辑，适合生产环境的严谨需求。
• jq命令：轻量快捷，无需编写脚本，适合临时快速排序，但会丢失YAML注释。

内容的提问来源于stack exchange，提问作者Tony Falabella