9.2. 验证是否收到 cables.csv 文件

预计完成时间：1 天

可操作组件的所有者：OELCM/HWaaS

技能配置文件：部署工程师

cables.csv 文件描述了 Google Distributed Cloud (GDC) 气隙实例中硬件设备之间的所有线缆连接。它是生成资源替换项所需的输入文件。

生成

  1. 确保从硬件供应商处收到“工厂最终动态数据”电子表格文件：
    1. 分布式云实例中每个机架对应一个电子表格文件。
    2. 每个电子表格都包含一个带有线缆连接信息的标签页。
  2. 从每个“工厂最终动态数据”电子表格中收集布线记录：
    1. 手动将每个电子表格中的有线电视记录汇总到一个合并的工作表中。
    2. 移除空行。
    3. 确保只有一行标题行（位于第一行）。
    4. 后续各行包含“factory final dynamic data”电子表格中电缆记录的汇总列表。
  3. 将汇总的“工厂最终动态数据”电子表格转换为或导出为 CSV（逗号分隔值）格式。
  4. 运行 gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path>，尽最大努力将“出厂最终动态数据”线缆列表转换为格式规范中描述的 Distributed Cloud cables.csv 格式。

格式规范

为了让分布式云部署工具解析 cables.csv 文件中的信息并正确配置实例硬件，您必须以机器可读的方式设置文件格式。本部分介绍了 cables.csv 文件的预期格式。

该文件采用标准的逗号分隔值格式，其中每条记录都以 , 分隔符分隔。除了标题行之外，每一行都表示分布式云实例中的一根线缆。

列名 说明 格式
end_a_rack_location1 连接到线缆“端 A”的硬件设备的机架位置。 必须为所有连接提供。

对于 PDU 连接（正则表达式）：^PDU-[LR]$
对于所有其他设备（正则表达式）：^U[0-9]{2}$

PDU 示例：PDU-L 表示从后方视角来看，连接到机架左侧 PDU 设备的线缆。
非 PDU 示例：U32 表示连接到机架 U 位置 32 处的设备的线缆。
end_a_device 连接到线缆“端 A”的硬件设备的名称。 必须为所有连接提供。

此字段必须与设备的设备命名规范相匹配。
end_a_port 硬件设备上与线缆“端 A”相连的端口的名称。 必须为所有连接提供。

此字段必须与设备的端口命名规范相匹配。
end_a_transceiver_vendor1 线缆“端 A”的收发器供应商（如果适用）。 如果线缆的 A 端有收发器或光纤，则为必需。如果线缆类型为 AOC 或 DAC，则无需指定。

允许的值：
  • Cisco
  • HPE
  • Intel
  • NetApp
  • Palo Alto
  • Thales
end_a_transceiver_mpn 线缆“端 A”的收发器型号（如果适用）。 仅当光纤电缆的这一端有收发器/光纤时才需要。如果线缆类型为 AOC 或 DAC，则不得指定此字段。

允许的值：
  • 25GBase-SR
  • AFBR-709DMZ-IN3
  • E10GSFPLR
  • PAN-QSFP28-100GBASE-LR4
  • PAN-SFP-PLUS-LR
  • PAN-T-Q28-100GBASE-SR4
  • PAN-T-S-PLUS-SR
  • QDD-400G-DR4-S
  • QDD-400G-FR4-S
  • QDD-400G-LR4-S
  • QDD-400G-SR4.2-BD
  • QSFP-100G-CWDM4-S
  • QSFP-100G-DR-S
  • QSFP-100G-FR-S
  • QSFP-100G-LR4-S
  • QSFP-100G-SL4
  • QSFP-100G-SR1.2
  • QSFP-100G-SR4-S
  • QSFP-40/100-SRBD
  • QSFP-4X10G-LR-S
  • SFP-10/25G-LR-S
  • SFP-10G-LR
  • SFP-10G-LR-US
  • SFP-10G-SR
  • SFP-25G-SR-S
  • X65404-N-C
  • X6606A
  • X-48895-00-R6
end_a_adapter_vendor1 线缆“端 A”的适配器供应商（如果适用）。 如果数据线的端点 A 有适配器，则必须提供此参数。

允许的值：
  • Cisco
  • FS
  • HPE
  • Mellanox
end_a_adapter_mpn1 线缆“端 A”的适配器型号（如果适用）。 仅当数据线的这一端有适配器时才需要。

允许的值：
  • CVR-QSFP-SFP10G
  • CVR-QSFP28-SFP25G
  • MAM1Q00A-QSA28
  • QSFP28-SFP28
  • RJ45-DB9
end_b_rack_location1 连接到线缆“末端 B”的硬件设备的机架位置。 与 end_a_rack_location 相同。
end_b_device 连接到线缆“端 B”的硬件设备的名称。 与 end_b_device 相同。
end_b_port 硬件设备上与线缆“端 B”相连的端口的名称。 与 end_a_port 相同。
end_b_transceiver_vendor1 线缆“端 B”的收发器供应商（如果适用）。 与 end_a_transceiver_vendor 相同。
end_b_transceiver_mpn 线缆“端 B”的收发器型号（如适用）。 与 end_a_transceiver_mpn 相同。
end_b_adapter_vendor1 数据线“端 B”的适配器供应商（如果适用）。 与 end_a_adapter_vendor> 相同。
end_b_adapter_mpn1 线缆“端 B”的适配器型号（如果适用）。 与 end_a_adapter_mpn 相同。
type 线缆的类型。 对于所有线缆都是必填属性。

允许的值：
  • AOC
  • AOC 2x
  • CAT6
  • DAC
  • DAC 2x
  • DAC 4x
  • MMF
  • MMF 4x
  • MMF DAC
  • MMF MPO-12
  • RJ45
  • SMF
  • SMF 4x
vendor1 数据线的供应商。 对于所有线缆都是必填属性。

允许的值：
  • Cisco
  • FS
  • HPE
  • NetApp
  • Panduit
  • ProLabs
mpn 线缆的型号。 所有线缆均必需。1
如果未针对 breakout 和 torsw 连接指定 end_a_transceiver_mpn、end_b_transceiver_mpn 和 mpn 中的任何一个，则会阻止生成资产。

允许的值：
  • QSFP-100G-CU3M
  • QSFP-4SFP25G-CU3M
  • X-26013-00
  • X-QSFP-4SFP25G-CU2M
  • X66211A-05-C
  • X66211A-2
  • X66211B-2-N-C
  • X66240A-05
  • X66240A-05-N-C
speed1 线缆的速度（以 GB 为单位）。 对于所有线缆都是必填属性。

正则表达式：^[0-9]+$
示例：100

分接板的 -ft 和 -bk 连接的速度会有所不同。

示例：
xx-aa-torsw01:Eth1/1 <-> xx-aa-ppl01:r03Ap01BO-bk 速度：100
xx-aa-objs01:e1a <-> xx-aa-ppl01:r03Ap01BO-ft 速度：25
xx-aa-objs01:e2a <-> xx-aa-ppl01:r03Ap02BO-ft 速度：25
length 线缆的长度。 对于所有线缆都是必填属性。

正则表达式：^[0-9]*\.?[0-9]+(ft|m)$
示例：.5m
color1 线缆的颜色。 对于所有线缆都是必填属性。

允许的值：
  • 湖水绿
  • 黑色
  • blue
  • 绿色
  • orange
  • 紫色
  • 红色
  • 白色
  • 黄色
description 线缆的说明。 可选。

允许任何文本。

1 系统会检查字段的格式，但不会阻止生成素材资源。

示例

以下是一个 cables.csv 文件示例，该文件适用于仅包含少量线缆和设备的假想单机架 GDCH 实例。

end_a_rack_location,end_a_device,end_a_port,end_a_transceiver_vendor,end_a_transceiver_mpn,end_a_adapter_vendor,end_a_adapter_mpn,end_b_rack_location,end_b_device,end_b_port,end_b_transceiver_vendor,end_b_transceiver_mpn,end_b_adapter_vendor,end_b_adapter_mpn,type,vendor,mpn,length,color,notes
42,za-aa-torsw01,Eth1/23/1,Cisco,QSFP-100G-SL4,,,40,az-aa-base03,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-1
42,za-aa-torsw01,Eth1/23/2,Cisco,QSFP-100G-SL4,,,39,az-aa-base02,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-2
42,za-aa-torsw01,Eth1/23/3,Cisco,QSFP-100G-SL4,,,38,az-aa-base01,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-3