9.2. 確認收到 cables.csv 檔案

預計完成時間:1 天

可操作元件擁有者:OELCM/HWaaS

技能設定檔:部署工程師

cables.csv 檔案會說明 Google Distributed Cloud (GDC) 實體隔離執行個體中,硬體裝置之間的所有纜線連接。這是產生資產覆寫時的必要輸入檔案。

產生

  1. 確認收到硬體供應商提供的「工廠最終動態資料」試算表檔案:
    1. Distributed Cloud 執行個體中的每個機架各有一個試算表檔案。
    2. 每個試算表都包含一個分頁,其中列有纜線連接資訊。
  2. 從每個「工廠最終動態資料」試算表收集電纜記錄:
    1. 手動將每個試算表的有線電視記錄匯總到一個合併試算表中。
    2. 移除空白列。
    3. 確認第一列只有一行標題。
    4. 後續的每個資料列會包含「工廠最終動態資料」試算表的匯總纜線記錄清單。
  3. 將匯總的「工廠最終動態資料」試算表轉換或匯出為 CSV (半形逗號分隔值) 格式。
  4. 執行 gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path>,盡可能將「factory final dynamic data」電纜清單轉換為格式規格所述的 Distributed Cloud cables.csv 格式。

格式規格

您必須以機器可讀取的方式格式化檔案,Distributed Cloud 部署工具才能剖析 cables.csv 檔案中的資訊,並正確設定執行個體硬體。本節說明 cables.csv 檔案的預期格式。

檔案採用標準的半形逗號分隔值格式,每筆記錄都以 , 分隔符號分隔。標頭以外的每一列都代表 Distributed Cloud 執行個體中的纜線。

資料欄名稱 說明 格式
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
  • 帕羅奧圖
  • 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 纜線「End B」的收發器供應商 (如適用)。 end_a_transceiver_vendor 相同。
end_b_transceiver_mpn 纜線「End 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_mpnend_b_transceiver_mpnmpn,系統會封鎖資產生成作業。

允許的值:
  • 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 Speed:100
xx-aa-objs01:e1a <-> xx-aa-ppl01:r03Ap01BO-ft Speed:25
xx-aa-objs01:e2a <-> xx-aa-ppl01:r03Ap02BO-ft Speed:25
length 充電線長度。 所有傳輸線都必須具備這項屬性。

規則運算式:^[0-9]*\.?[0-9]+(ft|m)$
範例:.5m
color1 電線的顏色。 所有傳輸線都必須具備這項屬性。

允許的值:
  • 水藍色
  • 黑色
  • blue
  • 綠色
  • orange
  • 紫色
  • 紅色
  • 白色
  • 黃色
description 線纜說明。 選填。

可輸入任何文字。

1 系統會檢查欄位格式,但不會封鎖素材資源生成作業。

範例

以下是虛構的 1 機架 GDCH 執行個體 cables.csv 檔案範例,其中只包含幾條纜線和裝置。

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