9.1. 確認收到 devices.csv 檔案

預計完成時間：1 天

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

技能設定檔：部署工程師

devices.csv 檔案會說明 Google Distributed Cloud (GDC) 實體隔離執行個體中的所有硬體裝置。請確認收到這個檔案，並驗證檔案格式是否符合預期。請注意，這個檔案先前稱為「裝置識別資訊」(DEID) 檔案。此外，請務必檢查硬體及其網路連線是否與檔案相符。

產生

  1. 請務必向硬體供應商索取裝置 ID (「DEID」) 試算表檔案：
    1. Distributed Cloud 執行個體中的每個機架各有一個試算表檔案。
    2. 每個試算表都包含裝置資訊的分頁。
  2. 從每個 DEID 試算表收集裝置記錄：
    1. 手動將每個試算表中的裝置記錄彙整到同一份合併試算表。
    2. 移除空白列。
    3. 確認第一列只有一行標題。
    4. 後續的每個資料列會包含 DEID 試算表的匯總裝置記錄清單。
  3. 將匯總的 DEID 試算表轉換或匯出為 CSV (半形逗號分隔值) 格式。

  4. 盡可能將 DEID 纜線清單轉換為 格式規格中說明的 Distributed Cloud 裝置.csv 格式：

    gdcloud system assets format-deid --input-deid PATH_TO_AGGREGATED_DEID_FILE --output-devices OUTPUT_PATH

格式規格

資料欄名稱 說明 格式
serial_number 指派給硬體裝置和同一機殼內子裝置的序號 (如適用)。 所有裝置都必須填寫這項屬性。如果 NetApp 裝置在同一機殼中有多個控制器，請先指定機殼序號，然後依序指定第一個和第二個控制器的序號 (以半形逗號分隔)。 英數字元。 規則運算式：
objsshelf stge stgeshelf ^[a-zA-Z0-9]+,[a-zA-Z0-9]+,[a-zA-Z0-9]+$
其他 ^U[0-9]{1,2}$

範例：

objsshelf stge stgeshelf 2M221301D9、2M221301DA、2M221301DB
其他 2M221301D9

instance_id

 與硬體裝置相關聯的 Distributed Cloud 執行個體 ID。

 所有裝置都必須填寫這項屬性。

同一執行個體中的所有裝置應使用相同值。

規則運算式：^([a-z0-9]{2,})$

範例：

aa
rack_id

 與硬體裝置相關聯的機架 ID。

 所有裝置都必須填寫這項屬性。

同一機架中的所有裝置應使用相同值。

規則運算式：^([a-z0-9]{2,})$

範例：

aa
rack_location1

 硬體裝置的機架位置。

 除了機架，所有裝置都必須提供此屬性。如果是 PDU 裝置，請指定 PDU 位置。如果是其他裝置，請指定裝置頂端的機架單元位置。

規則運算式：

pdu ^PDU-[LR]$
機架 ^n\/a$
其他 ^U[0-9]{1,2}$

範例：

pdu PDU-L 代表從後方角度來看，連接至機架左側 PDU 裝置的電線。
機架 不適用
其他 U42

rack_units

 硬體裝置的高度 (以機架單位為準)。

 機架和 PDU 以外的所有裝置都必須提供此資訊。以機架單位指定裝置高度。

規則運算式：

pdu rack ^n\/a$
其他 ^[0-9]+$

範例：

pdu rack 不適用
其他 1

類型

 硬體裝置類型。

 所有裝置都必須填寫這項屬性。

規則運算式：

^(rack)|(pdu)|(server)|(mgmtsw)|(mgmtaggsw)|(torsw)|(aggsw)|(stgesw)|(fw)|(hsm)|(objsadm)|(objs)|(objsshelf)|(stge)|( stgeshelf)$

範例：

伺服器
名稱

 硬體裝置的實體名稱。

 所有裝置都必須填寫這項屬性。

所需格式取決於硬體裝置類型。一般來說，所有裝置類型都需要使用相同的 "-<rack_id>-<device_type>" 格式，但部分儲存裝置類型需要額外的後置字元。

這個欄位必須符合裝置的裝置命名規格。
模型

 硬體裝置的使用者可讀產品名稱。

 所有裝置都必須填寫這項屬性。

這個欄位必須與裝置的型號規格相符。
vendor

 硬體裝置的製造商。

 系統會根據模型自動填入這個欄位。
asset_tag1

 硬體裝置的列印標籤。

 所有裝置都必須填寫這項屬性。

規則運算式：

pdu ^n\/a$
其他 ^[A-Z]{2}-(RCK|SVR|SWT|STG|PPL|HSM|FWL|OBJ|NTP|CON|CHS|PDU)-[0-9]{6}$

範例：

pdu 不適用
其他 US-SRV-123456

server_cpu_model

 伺服器裝置中的 CPU 型號。

 伺服器必須提供這項資訊。其他裝置則未指定。

可接受的伺服器 CPU 型號：

  • Intel Xeon Silver 4210R
  • Intel Xeon Silver 4216
  • Intel Xeon Gold 5220R
  • Intel Xeon Gold 6230R
  • Intel Xeon Silver 4214R
  • Intel Xeon Gold 6226R
  • Intel Xeon Gold 5317
  • Intel Xeon Platinum 8280
  • Intel Xeon Gold 6212U
  • Intel Xeon Gold 6312U
  • Intel Xeon Gold 5418Y
  • Intel Xeon Silver 4410Y
  • Intel Xeon Gold 6538Y+
  • Intel Xeon Platinum 8558
server_num_cpus

 伺服器裝置中的 CPU 數量。

 伺服器必須提供這項資訊。其他裝置則未指定。

數字。

規則運算式：

伺服器 ^[0-9]+$
其他 ^n\/a$

範例：

伺服器 2
其他 不適用

server_memory_gb

 伺服器裝置的記憶體量 (以 GB 為單位)。

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^[0-9]+$
其他 ^n\/a$

範例：

伺服器 288
其他 不適用

server_gpu_model1

 伺服器裝置中的 GPU 型號。

 伺服器必須提供這項資訊。其他裝置則未指定。

可用的伺服器 GPU 型號：

  • nVidia T4 16GB
  • nVidia A100 40GB
  • nVidia A100 80GB
  • nVidia H100 NVL PCIe 94GB
  • nVidia H100 PCIe 80GB
  • nVidia H100 XSM 80GB
server_num_gpus

 伺服器裝置中的 GPU 數量。

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^[0-9]+$
其他 ^n\/a$

範例：

伺服器 1
其他 不適用

server_bios_version1

 伺服器裝置的 BIOS 版本。

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^U[0-9]+$
其他 ^n\/a$

範例：

伺服器 U32
其他 不適用

server_bmc_version1

 伺服器裝置中裸機控制器的韌體版本。

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^[0-9]+\.[0-9]+$
其他 ^n\/a$

範例：

伺服器 2.55
其他 不適用

server_bmc_username2

 伺服器裝置的 BMC 管理員使用者名稱。

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^[a-zA-Z0-9]+$
其他 ^n\/a$

範例：

伺服器 管理員
其他 不適用

server_bmc_password2

 伺服器裝置的 BMC 管理員密碼。

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$
其他 ^n\/a$

範例：

伺服器 ASDF1234
其他 不適用

server_bmc_port_mac

 伺服器裝置的 BMC 連接埠 MAC 位址。

 伺服器必須提供這項資訊。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

伺服器 ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

伺服器 f0:0d:ca:fe:00:01
其他 不適用

server_bmc_port_name

 伺服器裝置的 BMC 連接埠名稱。

 伺服器裝置的此欄位會自動設為 ilo。
server_mgmt_port_mac

 伺服器裝置管理介面的 MAC 位址。

 與 server_bmc_mac 相同。
server_mgmt_port_name

 伺服器裝置的管理介面名稱。

 伺服器裝置的此欄位會自動設為 LOM1。
server_data1_port_mac

 伺服器裝置第一個資料介面的 MAC 位址。

 與 server_bmc_mac 相同。
server_data1_port_name

 伺服器裝置的第一個資料介面名稱

 伺服器必須提供這項資訊。其他裝置則未指定。

規則運算式：

伺服器 ^s[1-9]p[1-9]$
其他 ^n\/a$

範例：

伺服器 s1p1
其他 不適用

server_data2_port_mac

 伺服器裝置第二個資料介面的 MAC 位址。

 與 server_bmc_mac 相同。
server_data2_port_name

 伺服器裝置的第二個資料介面名稱

 與 server_data1_port_name 相同。
switch_username2

 切換裝置的管理員使用者名稱。

 如為切換器，此為必填屬性。其他裝置則未指定。

規則運算式：

mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9]+$
其他 ^n\/a$

範例：

mgmtsw mgmtaggsw torsw aggsw stgesw 管理員
其他 不適用

switch_password2

 交換器裝置的管理員密碼。

 如為切換器，此為必填屬性。其他裝置則未指定。

規則運算式：

mgmtsw mgmtaggsw torsw aggsw stgesw ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$
其他 ^n\/a$

範例：

mgmtsw mgmtaggsw torsw aggsw stgesw ASDF1234
其他 不適用

switch_mgmt_port_mac

 交換器裝置的 supeth1 連接埠 MAC 位址。方法是略過 PoAP 並載入交換器的預設設定，然後執行「show mac address-table | include sup-eth1」。

 如為切換器，此為必填屬性。其他裝置則未指定。

規則運算式：

mgmtsw mgmtaggsw torsw aggsw stgesw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

mgmtsw mgmtaggsw torsw aggsw stgesw f0:0d:ca:fe:00:01
其他 不適用

fw_mgmt_port_mac

 防火牆裝置管理介面的 MAC 位址。

 防火牆必須使用此屬性。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

fw ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

fw f0:0d:ca:fe:00:01
其他 不適用

fw_mgmt_port_name

 防火牆裝置的管理介面名稱。

 防火牆裝置的此欄位會自動設為 mgt。
hsm_mgmt_port_mac

 HSM 裝置管理介面的 MAC 位址。

 HSM 必須使用此屬性。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

hsm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

hsm f0:0d:ca:fe:00:01
其他 不適用

hsm_mgmt_port_name

 HSM 裝置的管理介面名稱。

 系統會自動將 HSM 裝置的此欄位設為 mgmt0。
hsm_data1_port_mac

 HSM 裝置第一個資料介面的 MAC 位址。

 與 hsm_mgmt_port_mac 相同。
hsm_data1_port_name

 HSM 裝置的第一個資料介面名稱

 系統會自動將 HSM 裝置的此欄位設為 data0。
hsm_data2_port_mac

 HSM 裝置第二個資料介面的 MAC 位址。

 與 hsm_mgmt_port_mac 相同。
hsm_data2_port_name

 HSM 裝置的第二個資料介面名稱

 系統會自動將 HSM 裝置的此欄位設為 data0。
objsadm_bmc_port_mac

 Object Storage 管理員裝置的 BMC 連接埠 MAC 位址。

 這是 Object Storage 管理員裝置的必要條件。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

objsadm ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

objsadm f0:0d:ca:fe:00:01
其他 不適用

objsadm_bmc_port_name

 Object Storage 管理員裝置的 BMC 連接埠名稱。

 物件儲存空間管理員裝置的這項欄位會自動設為 OOBM。
objsadm_mgmt1_port_mac

 Object Storage 管理裝置的第一個管理介面 MAC 位址。

 與 objsadm_bmc_port_mac 相同。
objsadm_mgmt1_port_name

 Object Storage 管理員裝置的第一個管理介面名稱

 物件儲存空間管理員裝置的這項欄位會自動設為 e01。
objs_bmc_port_mac

 Object Storage Compute Controller 裝置的 BMC 連接埠 MAC 位址。

 物件儲存空間運算控制器需要這項設定。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

objs ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

objs f0:0d:ca:fe:00:01
其他 不適用

objs_bmc_port_name

 Object Storage Compute Controller 裝置的 BMC 連接埠名稱。

 物件儲存空間運算裝置的此欄位會自動設為 OOBM。
objs_mgmt1_port_mac

 Object Storage Compute Controller 裝置的第一個管理介面的 MAC 位址。

 與 objs_bmc_port_mac 相同。
objs_mgmt1_port_name

 Object Storage Compute Controller 裝置的第一個管理介面名稱。

 物件儲存空間運算裝置的此欄位會自動設為 e01。
objsshelf_num_data_disks

 Object Storage Shelf 裝置中的資料磁碟數量。

 這是 Object Storage Controller Shelves 的必要條件。其他裝置則未指定。

數字。

規則運算式：

objsshelf ^[0-9]+$
其他 ^n\/a$

範例：

objsshelf 60
其他 不適用

objsshelf_controller1_name

 Object Storage Shelf 裝置第一個控制器的實體名稱。

 物件儲存空間架裝置的此欄位會自動設為 <device-name>-01。
objsshelf_controller1_serial_number

 Object Storage Shelf 裝置的第一個控制器序號。

 英數字元。
objsshelf_controller1_mgmt_port_mac

 第一個控制器管理介面的 MAC 位址，適用於 Object Storage Shelf 裝置。

 這是物件儲存空間架子控制器必備的項目。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

objsshelf ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

objsshelf f0:0d:ca:fe:00:01
其他 不適用

objsshelf_controller1_mgmt_port_name

 Object Storage Shelf 裝置第一個控制器的管理介面名稱。

 物件儲存空間架裝置的此欄位會自動設為 <A-P1。
objsshelf_controller2_name

 Object Storage Shelf 裝置第二個控制器的實體名稱。

 物件儲存空間架裝置的此欄位會自動設為 <device-name>-02。
objsshelf_controller2_serial_number

 物件儲存空間架裝置的第二個控制器序號。

 英數字元。
objsshelf_controller2_mgmt_port_mac

 Object Storage Shelf 裝置第二個控制器的管理介面 MAC 位址。

 與 objsshelf_controller1_mgmt_port_mac 相同。
objsshelf_controller2_mgmt_port_name

 第二個控制器管理介面的名稱，適用於物件儲存空間架裝置。

 物件儲存空間架裝置的此欄位會自動設為 B-P1。
stge_num_data_disks

 檔案和區塊儲存裝置中的資料磁碟數量。

 檔案和區塊儲存裝置必須提供這項資訊。其他裝置則未指定。

數字。

規則運算式：

stge ^[0-9]+$
其他 ^n\/a$

範例：

stge 60
其他 不適用

stge_controller1_name

 檔案/區塊儲存裝置第一個控制器的實體名稱。

 如果是檔案區塊儲存裝置，這個欄位會自動設為 <device-name>-01。
stge_controller1_mgmt_port_mac

 第一個控制器的管理介面 MAC 位址，適用於檔案和區塊儲存裝置。

 檔案和區塊儲存裝置必須提供這項資訊。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

stge ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

stge f0:0d:ca:fe:00:01
其他 不適用

stge_controller1_mgmt_port_name

 第一個控制器管理介面的名稱，適用於檔案/區塊儲存裝置。

 如果是檔案區塊儲存裝置，這個欄位會自動設為 e0M。
stge_controller2_name

 檔案和區塊儲存裝置的第二個控制器實體名稱。

 如果是檔案區塊儲存裝置，這個欄位會自動設為 <device-name>-02。
stge_controller2_mgmt_port_mac

 第二個控制器的管理介面 MAC 位址，適用於檔案/區塊儲存裝置。

 與 stge_controller1_mgmt_port_mac 相同。
stge_controller2_mgmt_port_name

 第二個控制器管理介面的名稱，適用於檔案和區塊儲存裝置。

 與 stge_controller1_mgmt_port_name 相同。
stgeshelf_num_data_disks

 檔案/區塊儲存架裝置中的資料磁碟數量。

 檔案和區塊儲存空間架都需要這項設定。其他裝置則未指定。

數字。

規則運算式：

stgeshelf ^[0-9]+$
其他 ^n\/a$

範例：

stgeshelf 60
其他 不適用

stgeshelf_controller1_name

 檔案和區塊儲存裝置的第一個控制器實體名稱。

 如果是檔案區塊儲存空間架裝置，這個欄位會自動設為 <device-name>-01。
stgeshelf_controller2_name

 File/Block Storage Shelf 裝置的第二個控制器實體名稱。

 如果是檔案區塊儲存空間架裝置，這個欄位會自動設為 <device-name>-02。
chassis_bmc_version

 機殼裝置的韌體版本。

 機殼選填。其他裝置則未指定。

規則運算式：

伺服器 ^([0-9]+\.)+[0-9]+(-b[0-9]+)?$
其他 ^n\/a$

範例：

底盤 2.2-b11
其他 不適用

chassis_bmc_username2

 機箱裝置的 BMC 管理員使用者名稱。

 如為機殼，此為必填屬性。其他裝置則未指定。

規則運算式：

底盤 ^[a-zA-Z0-9]+$
其他 ^n\/a$

範例：

底盤 管理員
其他 不適用

chassis_bmc_password2

 機箱裝置的 BMC 管理員密碼。

 如為機殼，此為必填屬性。其他裝置則未指定。

規則運算式：

底盤 ^[a-zA-Z0-9\`\~\!\@\#\$\%\^\&\*\(\)\-_\=\+\[\]\{\}]$
其他 ^n\/a$

範例：

底盤 ASDF1234
其他 不適用

chassis_bmc_port_mac

 機箱裝置的 BMC 連接埠 MAC 位址。

 如為機殼，此為必填屬性。其他裝置則未指定。

必須是有效的 MAC 位址。

規則運算式：

伺服器 ^([0-9a-f]{2}:){5}([0-9a-f]{2})$
其他 ^n\/a$

範例：

伺服器 f0:0d:ca:fe:00:01
其他 不適用

chassis_bmc_port_name

 機箱裝置的 BMC 連接埠名稱。

 機箱裝置的此欄位會自動設為 ilo。

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

2 secrets.yaml 中必須填寫使用者名稱和密碼欄位。系統會使用 devices.csv 中提供的任何使用者名稱和密碼產生 secrets.yaml，但 devices.csv 中不一定要提供這些資訊。