9.2. cables.csv ファイルの受信を確認する

完了までの推定時間: 1 日

操作可能なコンポーネントの所有者: OELCM/HWaaS

スキル プロファイル: デプロイ エンジニア

cables.csv ファイルには、Google Distributed Cloud（GDC）エアギャップ インスタンス内のハードウェア デバイス間のすべてのケーブル接続が記述されています。アセットのオーバーライドを生成するために必要な入力ファイルです。

生成

  1. ハードウェア ベンダーから「工場最終動的データ」スプレッドシート ファイルを受け取っていることを確認します。
    1. Distributed Cloud インスタンス内のラックごとに 1 つのスプレッドシート ファイル。
    2. すべてのスプレッドシートには、ケーブル接続情報を含むタブが含まれています。
  2. すべての「工場最終動的データ」スプレッドシートからケーブル配線記録を収集します。
    1. すべてのスプレッドシートのケーブル レコードを手動で 1 つの結合シートに集計します。
    2. 空の行を削除します。
    3. 1 行目のヘッダー行が 1 つだけであることを確認します。
    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 形式に変換します。

形式の仕様

Distributed Cloud デプロイ ツールが cables.csv ファイル内の情報を解析し、インスタンスのハードウェアを正しく構成するには、ファイルをマシンリーダブルな形式にする必要があります。このセクションでは、cables.csv ファイルの想定される形式について説明します。

ファイルは標準のカンマ区切り値形式で、各レコードは , 区切り文字で区切られています。ヘッダー以外の各行は、Distributed Cloud インスタンスのケーブルを参照します。

列名 説明 形式
end_a_rack_location1 ケーブルの「End A」に接続するハードウェア デバイスのラックの場所。 すべての接続で必須です。

PDU 接続の場合（正規表現）: ^PDU-[LR]$
その他のすべてのデバイスの場合（正規表現）: ^U[0-9]{2}$

PDU の例: PDU-L は、ラックの背面から見て左側の PDU デバイスに接続するケーブルを示します。
非 PDU の例: U32 は、ラックの U 位置 32 にあるデバイスに接続するケーブルを示します。
end_a_device ケーブルの「End A」に接続するハードウェア デバイスの名前。 すべての接続で必須です。

このフィールドは、デバイスのデバイス命名仕様と一致している必要があります。
end_a_port ケーブルの「End A」に接続するハードウェア デバイスのポートの名前。 すべての接続で必須です。

このフィールドは、デバイスのポート命名仕様と一致している必要があります。
end_a_transceiver_vendor1 ケーブルの「End A」のトランシーバのベンダー（該当する場合）。 ケーブルの端点 A にトランシーバーまたは光ファイバーがある場合は必須です。ケーブルタイプが AOC か DAC かを指定しないでください。

指定できる値は次のとおりです。
  • Cisco
  • HPE
  • Intel
  • NetApp
  • Palo Alto
  • Thales
end_a_transceiver_mpn ケーブルの「End 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 ケーブルの「End B」に接続するハードウェア デバイスのラックの場所。 end_a_rack_location と同一です。
end_b_device ケーブルの「End B」に接続するハードウェア デバイスの名前。 end_b_device と同一です。
end_b_port ケーブルの「End 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
ブレークアウト接続と 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 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
  • 緑
  • オレンジ
  • 紫
  • 赤
  • 白
  • 黄
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